BizTalk Server Visual Studio Error: error referencing assembly name-dll.clrtypes.dll

  • Sandro Pereira
  • Oct 9, 2025
  • 2 min read

While making some changes to an existing BizTalk Server project, I was continuously getting a strange error saying that I couldn’t reference a clrtypes.dll. To be more precise, it couldn’t reference the name-of-my-project.clrtypes.dll

Severity  Code  Description  Project  File  Line  Suppression State
Error    error referencing assembly ‘obj\debug\application.common.processing.clrtypes.dll‘    obj\debug\application.common.processing.processing.clrtypes.dll  2  

Strangely, this only happens on the projects that have orchestrations.

Cause

The real cause of this issue is somewhat difficult to explain, as it doesn’t always occur. However, I know for a fact that I do not create any clrtypes.dll files. What happens is that when Visual Studio compiles the project, it will make a temporary build output (obj\Debug\)

The obj folder is recreated during builds, so references to it often break mid-build — especially with BizTalk orchestrations, which require all referenced assemblies to be fully compiled and stable before the orchestration compiler runs.

Solution

The solution to this issue is quite simple:

  • Access the project folder in File Explorer.
  • And delete the obj folder.

Now, if you try to compile again, it may give different errors, but that .clrtypes.dll will be “fixed”

Hope you find this helpful! If you liked the content or found it useful and would like to support me in writing more, consider buying (or helping to buy) a Star Wars Lego set for my son. 

Author: Sandro Pereira

Sandro Pereira lives in Portugal and works as a consultant at DevScope. In the past years, he has been working on implementing Integration scenarios both on-premises and cloud for various clients, each with different scenarios from a technical point of view, size, and criticality, using Microsoft Azure, Microsoft BizTalk Server and different technologies like AS2, EDI, RosettaNet, SAP, TIBCO etc. He is a regular blogger, international speaker, and technical reviewer of several BizTalk books all focused on Integration. He is also the author of the book “BizTalk Mapping Patterns & Best Practices”. He has been awarded MVP since 2011 for his contributions to the integration community.

Leave a Reply

Your email address will not be published. Required fields are marked *

The Ultimate Cloud
Management Platform for Azure

Supercharge your Azure Cost Saving

Learn More
Turbo360 Widget

Back to Top