Freigeben über

<assemblyBinding>-Element für <runtime>

  • Artikel

Enthält Informationen über die Assemblyversionsumleitung und die Speicherorte von Assemblys.

<assemblyBinding  
   xmlns="urn:schemas-microsoft-com:asm.v1" appliesTo="v1.0.3705">
</assemblyBinding>

Attribute und Elemente

In den folgenden Abschnitten werden Attribute, untergeordnete Elemente und übergeordnete Elemente beschrieben.

Attribute

Attribute

Beschreibungen

xmlns

Erforderliches Attribut.

Gibt den XML‑Namespace an, der für die Assemblybindung benötigt wird. Verwenden Sie als Wert die Zeichenfolge urn:schemas-microsoft-com:asm.v1.

appliesTo

Gibt die Laufzeitversion der .NET Framework-Assembly an, auf die sich die Umleitung bezieht. Dieses optionale Attribut verwendet eine .NET Framework-Versionsnummer, um anzugeben, welche Version verwendet wird. Wenn kein appliesTo-Attribut angegeben wird, gilt das <assemblyBinding>-Element für alle Versionen von .NET Framework. Das appliesTo-Attribut wurde in .NET Framework, Version 1.1, eingeführt. Es wird von .NET Framework, Version 1.0, ignoriert. Dies bedeutet, dass bei der Verwendung von .NET Framework, Version 1.0, alle <assemblyBinding>-Elemente angewendet werden, selbst wenn ein appliesTo-Attribut angegeben wurde.

Untergeordnete Elemente

Element

Beschreibungen

<dependentAssembly>

Kapselt die Bindungsrichtlinie und den Assemblyspeicherort für eine Assembly. Verwenden Sie für jede Assembly ein <dependentAssembly>-Tag.

<probing>

Gibt Unterverzeichnisse an, die die Common Language Runtime beim Laden von Assemblys durchsucht.

<publisherPolicy>

Gibt an, ob die Runtime die Herausgeberrichtlinie anwendet.

<qualifyAssembly>

Gibt den vollständigen Namen der Assembly an, die dynamisch geladen werden soll, wenn ein partieller Name verwendet wird.

Übergeordnete Elemente

Element

Beschreibungen

configuration

Das Stammelement in jeder von den Common Language Runtime- und .NET Framework-Anwendungen verwendeten Konfigurationsdatei.

runtime

Enthält Informationen über die Assemblybindung und die Garbage Collection.

Beispiel

Das folgende Beispiel veranschaulicht, wie Sie eine Assemblyversion in eine andere umleiten und eine CodeBase bereitstellen.

<configuration>
   <runtime>
      <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
         <dependentAssembly>
            <assemblyIdentity name="myAssembly"
                              publicKeyToken="32ab4ba45e0a69a1"
                              culture="neutral" />
            <bindingRedirect oldVersion="1.0.0.0"
                             newVersion="2.0.0.0"/>
            <codeBase version="2.0.0.0"
                      href="http://www.litwareinc.com/myAssembly.dll"/>
         </dependentAssembly>
      </assemblyBinding>
   </runtime>
</configuration>

Das folgende Beispiel veranschaulicht die Verwendung des appliesTo-Attributs zum Umleiten der Bindung einer .NET Framework-Assembly.

<runtime>
   <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1" appliesTo="v1.0.3705">
      <dependentAssembly> 
         <assemblyIdentity name="mscorcfg" publicKeyToken="b03f5f7f11d50a3a" culture=""/>
         <bindingRedirect oldVersion="0.0.0.0-65535.65535.65535.65535" newVersion="1.0.3300.0"/>
      </dependentAssembly>
   </assemblyBinding>
</runtime>

Siehe auch

Referenz

Schema für Laufzeiteinstellungen

Konzepte

Umleiten von Assemblyversionen

Weitere Ressourcen

Konfigurationsdateischema für .NET Framework