Freigeben über

<assemblyBinding>-Element

  • Artikel

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

<configuration>-Element
  <runtime>-Element
    <assemblyBinding>-Element

<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

Attribut Beschreibung

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

Erforderliches Attribut.

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 Beschreibung

<dependentAssembly>

Kapselt die Bindungsrichtlinie und den Assembly­speicherort für eine Assembly ein. 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 Beschreibung

configuration

Das Stammelement in jeder Konfigurationsdatei, das von der Common Language Runtime und den .NET Framework-Anwendungen verwendet wird.

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