<bindingRedirect-element>

Artikel
05/10/2023

Omdirigerar en sammansättningsversion till en annan.

<Konfiguration>
  <Runtime>
    <assemblyBinding>
      <dependentAssembly>
        <bindingRedirect>

Syntax

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

Attribut och element

I följande avsnitt beskrivs attribut, underordnade element och överordnade element.

Attribut

Attribut	Beskrivning
`oldVersion`	Obligatoriskt attribut. Anger den version av sammansättningen som ursprungligen begärdes. Formatet för ett sammansättningsversionsnummer är major.minor.build.revision. Giltiga värden för varje del av det här versionsnumret är 0 till 65535. Du kan också ange ett intervall med versioner i följande format: n.n.n.n - n.n.n.n
`newVersion`	Obligatoriskt attribut. Anger vilken version av sammansättningen som ska användas i stället för den ursprungligen begärda versionen i formatet: n.n.n.n Det här värdet kan ange en tidigare version än `oldVersion`.

Underordnade element

Element	Beskrivning
Ingen

Överordnade element

Element	Beskrivning
`assemblyBinding`	Innehåller information om omdirigering av sammansättningsversioner och platserna för sammansättningar.
`configuration`	Rotelementet i varje konfigurationsfil som används av common language runtime och .NET Framework program.
`dependentAssembly`	Kapslar in bindningsprincip och sammansättningsplats för varje sammansättning. Använd ett beroendeAssembly-element för varje sammansättning.
`runtime`	Innehåller information om sammansättningsbindning och skräpinsamling.

Kommentarer

När du skapar ett .NET Framework program mot en starkt namngiven sammansättning använder programmet den versionen av sammansättningen vid körning som standard, även om en ny version är tillgänglig. Du kan dock konfigurera programmet så att det körs mot en nyare version av sammansättningen. Mer information om hur körningen använder dessa filer för att avgöra vilken sammansättningsversion som ska användas finns i How the Runtime Locates Assemblies (Så här letar Runtime upp sammansättningar).

Du kan omdirigera fler än en sammansättningsversion genom att inkludera flera bindingRedirect element i ett dependentAssembly element. Du kan också omdirigera från en nyare version till en äldre version av sammansättningen.

Explicit omdirigering av sammansättningsbindning i en programkonfigurationsfil kräver en säkerhetsbehörighet. Detta gäller omdirigering av .NET Framework sammansättningar och sammansättningar från tredje part. Behörigheten beviljas genom att ange SecurityPermissionFlag flaggan på SecurityPermission. Mer information finns i Säkerhetsbehörighet för omdirigering av sammansättningsbindning.

Exempel

I följande exempel visas hur du omdirigerar en sammansättningsversion till en annan.

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

Dela via