Freigeben über

<bindingRedirect> Element

Leitet eine Assemblyversion an eine andere um.

<Konfiguration>
   <Laufzeit>
     <assemblyBinding>
       <abhängige Montage>
         <bindingRedirect>

Syntax

   <bindingRedirect
oldVersion="existing assembly version"
newVersion="new assembly version"/>

Attribute und Elemente

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

Attribute

Merkmal Description
oldVersion Erforderliches Attribut.

Gibt die Version der Assembly an, die ursprünglich angefordert wurde. Das Format einer Assemblyversionsnummer ist "major.minor.build.revision". Gültige Werte für jeden Teil dieser Versionsnummer sind 0 bis 65535.

Sie können auch einen Bereich von Versionen im folgenden Format angeben:

n.n.n.n.n - n.n.n.n
newVersion Erforderliches Attribut.

Gibt die Version der Assembly an, die anstelle der ursprünglich angeforderten Version im Format verwendet werden soll: n.n.n.n.n

Dieser Wert kann eine frühere Version als oldVersion.

Untergeordnete Elemente

Element Description
Nichts

Übergeordnete Elemente

Element Description
assemblyBinding Enthält Informationen zur Assemblyversionsumleitung und zu den Speicherorten von Assemblys.
configuration Das Stammelement in jeder von den Common Language Runtime- und .NET Framework-Anwendungen verwendeten Konfigurationsdatei.
dependentAssembly Kapselt Bindungsrichtlinien und Assemblyspeicherort für jede Assembly. Verwenden Sie für jede Assembly ein abhängigesAssembly-Element.
runtime Enthält Informationen zur Assemblybindung und Garbage Collection.

Bemerkungen

Wenn Sie eine .NET Framework-Anwendung für eine assembly mit starkem Namen erstellen, verwendet die Anwendung diese Version der Assembly zur Laufzeit standardmäßig, auch wenn eine neue Version verfügbar ist. Sie können die Anwendung jedoch so konfigurieren, dass sie für eine neuere Version der Assembly ausgeführt wird. Ausführliche Informationen dazu, wie die Laufzeit diese Dateien verwendet, um zu bestimmen, welche Assemblyversion verwendet werden soll, finden Sie unter How the Runtime Locates Assemblies.

Sie können mehrere Assemblyversionen umleiten, indem Sie mehrere bindingRedirect Elemente in ein dependentAssembly Element einschließen. Sie können auch von einer neueren Version zu einer älteren Version der Assembly umleiten.

Die explizite Assemblybindungsumleitung in einer Anwendungskonfigurationsdatei erfordert eine Sicherheitsberechtigung. Dies gilt für die Umleitung von .NET Framework-Assemblys und Assemblys von Drittanbietern. Die Berechtigung wird durch Festlegen der SecurityPermissionFlag Kennzeichnung auf der SecurityPermission. Weitere Informationen finden Sie unter Sicherheitsberechtigung für die Assemblybindungsumleitung.

Example

Das folgende Beispiel zeigt, wie Eine Assemblyversion an eine andere umgeleitet wird.

<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"/>
         </dependentAssembly>
      </assemblyBinding>
   </runtime>
</configuration>

Siehe auch

  • Last updated on