<bindingRedirect-element>

Artikel
05/10/2023

De ene assemblyversie wordt omgeleid naar een andere.

<configuratie>
  <Runtime>
    <assemblyBinding>
      <dependentAssembly>
        <bindingRedirect>

Syntax

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

Kenmerken en elementen

In de volgende secties worden kenmerken, onderliggende elementen en bovenliggende elementen beschreven.

Kenmerken

Kenmerk	Beschrijving
`oldVersion`	Vereist kenmerk. Hiermee geeft u de versie van de assembly die oorspronkelijk is aangevraagd. De notatie van een assemblyversienummer is major.minor.build.revision. Geldige waarden voor elk deel van dit versienummer zijn 0 tot 65535. U kunt ook een reeks versies in de volgende indeling opgeven: n.n.n.n - n.n.n.n
`newVersion`	Vereist kenmerk. Hiermee geeft u de versie van de assembly te gebruiken in plaats van de oorspronkelijk aangevraagde versie in de indeling: n.n.n.n. n Deze waarde kan een eerdere versie dan `oldVersion`opgeven.

Onderliggende elementen

Element	Beschrijving
Geen

Bovenliggende elementen

Element	Beschrijving
`assemblyBinding`	Bevat informatie over omleiding van assemblyversies en de locaties van assembly's.
`configuration`	Het hoofdelement in elk configuratiebestand dat wordt gebruikt door de common language runtime en .NET Framework toepassingen.
`dependentAssembly`	Het bindingsbeleid en de assemblylocatie voor elke assembly worden ingekapseld. Gebruik één dependentAssembly-element voor elke assembly.
`runtime`	Bevat informatie over assemblagebinding en garbagecollection.

Opmerkingen

Wanneer u een .NET Framework-toepassing bouwt op basis van een assembly met een sterke naam, gebruikt de toepassing standaard die versie van de assembly tijdens runtime, zelfs als er een nieuwe versie beschikbaar is. U kunt de toepassing echter zo configureren dat deze wordt uitgevoerd op basis van een nieuwere versie van de assembly. Zie Hoe de runtime assembly's zoekt voor meer informatie over hoe de runtime deze bestanden gebruikt om te bepalen welke assemblyversie moet worden gebruikt.

U kunt meer dan één assemblyversie omleiden door meerdere bindingRedirect elementen in een dependentAssembly element op te neem. U kunt ook omleiden van een nieuwere versie naar een oudere versie van de assembly.

Expliciete assemblybindingsomleiding in een toepassingsconfiguratiebestand vereist een beveiligingsmachtiging. Dit geldt voor omleiding van .NET Framework assembly's en assembly's van derden. De machtiging wordt verleend door de SecurityPermissionFlag vlag in te stellen op de SecurityPermission. Zie Assembly Binding Redirection Security Permission (Beveiligingsmachtiging voor assemblybindingsomleiding) voor meer informatie.

Voorbeeld

In het volgende voorbeeld ziet u hoe u de ene assemblyversie omleidt naar een andere.

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

Delen via