How Do I...? Common Tasks QuickStart Tutorial

Go To...

Assemblies

Create an assembly with a strong name

Change the default search path

Use version policy

How Do I...Use Assembly Version Policy?

A primary goal of the deployment system in the .NET Framework is to eliminate conflicts between applications caused by shared components and shared states (or DLL conflicts). A key solution to this problem is a robust versioning system. The .NET Framework records information about an application's dependencies in the assembly manifest. This dependency information includes a version number that is used at runtime to load the proper version of a dependency.

By default, the common language runtime will load the version of a dependency that is specified in the manifest. This is preferred in the majority of scenarios. However, there are cases where running an application with a different version of a dependency can be useful. In order to accomplish this, version policies can be included in an application's configuration file. For example, the following XML code fragment redirects references to version 5.0.0.0 of a shared assembly called "CalcR" up to version 6.0.0.0 of that assembly:

<configuration>   
    <runtime>
        <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">


            <dependentAssembly>
                <assemblyIdentity name="calcR" 
                                  publicKeyToken="a1690a5ea44bab32" 
                                  culture=""/>
              
                
                <bindingRedirect oldVersion="5.0.0.0"
                                 newVersion="6.0.0.0"/>


            </dependentAssembly>
        </assemblyBinding>
    </runtime>
</configuration>

In addition to policies specified at the application level, the .NET Framework also provides two other policy levels: publisher and administrator. A Publisher policy statement describes the compatibility of an assembly issued by the publisher of that shared assembly. Administrator level policy is a machine version policy that affects all applications. Administrator policy is created using the same XML syntax as application level policy. The administrator policy file is called machine.config, and resides in the common language runtime install directory. The three policy levels are evaluated in the following order:

Application Policy
Publisher Policy
Administrator Policy

Example

C# Math.exe

[This sample can be found at M:\web\users\Sites\AspnetQuickStart\v2.0\QuickStart\howto\samples\assemblies\version\
To build this sample, open the SDK command prompt and navigate to the above path. Build the sample using the build tool msbuild passing the solution file as the first parameter: msbuild mySample.sln. The compiled executable will be found in the sub directory \bin directory.]