<bindingRedirect>-Element

Artikel
06/02/2023

Leitet eine Assemblyversion in eine andere um.

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

attribute	Beschreibung
`oldVersion`	Erforderliches Attribut. Gibt die Assemblyversion an, die ursprünglich angefordert wurde. Das Format einer Assemblyversionsnummer ist Hauptversion.Nebenversion.Build.Revision. Gültige Werte für jeden Abschnitt dieser Versionsnummer sind 0 bis 65535. Sie können auch einen Bereich an Versionsnummern angeben, und zwar im folgenden Format: n.n.n.n – n.n.n.n
`newVersion`	Erforderliches Attribut. Gibt die Assemblyversion an, die anstelle der ursprünglich angeforderten Version verwendet werden soll, im Format: n.n.n.n Dieser Wert kann eine frühere Version als `oldVersion` angeben.

Untergeordnete Elemente

Element	BESCHREIBUNG
Keine

Übergeordnete Elemente

Element	BESCHREIBUNG
`assemblyBinding`	Enthält Informationen über die Assemblyversionsumleitung und die Speicherorte von Assemblys.
`configuration`	Das Stammelement in jeder von den Common Language Runtime- und .NET Framework-Anwendungen verwendeten Konfigurationsdatei.
`dependentAssembly`	Kapselt die Bindungsrichtlinie und den Assemblyspeicherort für jede Assembly. Verwenden Sie für jede Assembly ein dependentAssembly-Element.
`runtime`	Enthält Informationen über die Assemblybindung und die Garbage Collection.

Bemerkungen

Wenn Sie eine .NET Framework-Anwendung mit einer Assembly mit starkem Namen erstellen, verwendet die Anwendung zur Laufzeit standardmäßig diese Version der Assembly, selbst wenn eine neue Version verfügbar ist. Sie können die Anwendung jedoch auch so konfigurieren, dass sie mit einer neueren Version der Assembly ausgeführt wird. Ausführliche Informationen darüber, wie die Runtime anhand dieser Dateien die zu verwendende Assemblyversion ermittelt, finden Sie unter So sucht Common Language Runtime nach Assemblys.

Sie können mehrere Assemblyversionen umleiten, indem Sie mehrere bindingRedirect-Elemente in ein dependentAssembly-Element aufnehmen. Sie können auch von einer neueren Version zu einer früheren Version der Assembly umleiten.

Für die explizite Umleitung einer Assemblybindung in einer Anwendungskonfigurationsdatei ist eine Sicherheitsberechtigung erforderlich. Dies betrifft die Umleitung von .NET Framework-Assemblys und Assemblys von Drittanbietern. Die Berechtigung wird erteilt, indem das SecurityPermissionFlag-Flag für die SecurityPermission festgelegt wird. Weitere Informationen finden Sie unter Sicherheitsberechtigung für die Umleitung der Assemblybindung.

Beispiel

Das folgende Beispiel veranschaulicht, wie Sie eine Assemblyversion zu einer anderen umleiten.

<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>