When working in larger projects, you will sometimes encounter errors similar to this one: “Could not load file or assembly 'Newtonsoft.Json, Version=126.96.36.199, Culture=neutral, PublicKeyToken=30ad4fe6b2a6aeed' or one of its dependencies. The system cannot find the file specified.” Or how about this one? “System.IO.FileLoadException : Could not load file or assembly 'Moq, Version=3.1.416.3, Culture=neutral, PublicKeyToken=69f491c39445e920' or one of its dependencies. The located assembly's manifest definition does not match the assembly reference. (Exception from HRESULT: 0x80131040)”
Search all you want, most things you find on the Internet are from the pre-NuGet era and don’t really help. What now? In this post, let’s go over why this error sometimes happens. And I’ll end with a beautiful little trick that fixes this issue when you encounter it. Let’s go!
Redirecting Assembly Versions
In 90% of the cases, the errors mentioned earlier are caused by faulty assembly redirects. What are those, you ask? A long answer is on MSDN, a short answer is that assembly redirects let us trick .NET into believing that assembly A is actually assembly B. Or in other words, we can tell .NET to work with Newtonsoft.Json 188.8.131.52 whenever any other reference requires an older version of Newtonsoft.Json.
Assembly redirects are often created by NuGet, to solve versioning issues. Here’s an example which I took from an application’s Web.config:
<?xml version="1.0" encoding="utf-8"?>
<!-- ... -->
<legacyHMACWarning enabled="0" />
<assemblyIdentity name="Newtonsoft.Json" publicKeyToken="30ad4fe6b2a6aeed" culture="neutral" />
<bindingRedirect oldVersion="0.0.0.0-184.108.40.206" newVersion="220.127.116.11" />
When running an application with this config file, it will trick any assembly that wants to use any version < 18.104.22.168 of Newtonsoft.Json into working with the latest 22.214.171.124 version. Neat, as it solves dependency hell where two assemblies require a different version of a common assembly dependency. But… does it solve that?
NuGet and Assembly Redirects
The cool thing about NuGet is that it auto-detects whenever assembly redirects are needed, and adds them to the Web.config or App.config file of your project. However, this not always works well. Sometimes, old binding redirects are not removed. Sometimes, none are added at all. Resulting in fine errors like the ones I opened this post with. At compile time. Or worse! When running the application.
One way of solving this is manually checking all binding redirects in all configuration files you have in your project, checking assembly versions and so on. But here comes the trick: we can let NuGet do this for us!
All we have to do is this:
- From any .config file, remove the <assemblyBinding> element and its child elements. In other words: strip your app from assembly binding redirects.
- Open the Package Manager Console in Visual Studio. This can be done from the View | Other Windows | Package Manager Console menu.
- Type this one, magical command that solves it all: Get-Project -All | Add-BindingRedirect. I repeat: Get-Project -All | Add-BindingRedirect
NuGet will get all projects and for every project, add the correct assembly binding redirects again. Compile, run, and continue your day without rage. Enjoy!
PS: For the other cases where this trick does not help, check Damir Dobric’s post on troubleshooting NuGet references.