Assembly binding redirection in ASP.NET


When dealing with signed strongly-named assemblies in .NET, we’ve all come across the dreaded

BadImageFormatException "An attempt was made to load a program with an incorrect format"


System.IO.FileLoadException: Could not load file or assembly 'Utility, Version=, Culture=neutral, PublicKeyToken=37dd581281d764f7' or one of its dependencies. The located assembly's manifest definition does not match the assembly reference. (Exception from HRESULT: 0x80131040)

In the first case, we need to find the right dll for the platform that we are on, i.e. 64bit vs 32bit. In my case the first error led to the second, since once I found the right dll, of course the version number was newer, and I could not find the older version to download.

Of course in .NET desktop apps, we could add an assembly binding redirect to get the right .dll loaded up provided that we have it. In a Web application, it is just as easy, you just have to add a runtime section directly under the main configuration tag.

For example, I wanted to drop a different version of SQLite into my SiteCore installation, so I grabbed the System.Data.SQLite binaries and dropped the one that I wanted into SiteCore’s \bin directory. Then I tried to load up the site and looked at the error message to see which version it was looking for. Once we know what it is looking for, we can write a binding redirection in the web.config file like this:

    <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
        <assemblyIdentity name="System.Data.SQLite"
                          culture="neutral" />
        <bindingRedirect oldVersion=""

Here is the documentation for bindingRedirect from MSDN. It doesn’t explicitly cover redirects in Web applications, and there is a lot of confusing information out on the web about this. Hopefully this post clears some of it up.


No Responses Yet to “Assembly binding redirection in ASP.NET”

  1. Leave a Comment

Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s

%d bloggers like this: