<bindingRedirect> – element

Článek
05/10/2023

Přesměruje jednu verzi sestavení k jiné.

<Konfigurace>
  <Runtime>
    <sestaveníBinding>
      <dependentAssembly>
        <bindingRedirect>

Syntax

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

Atributy a elementy

Následující části popisují atributy, podřízené prvky a nadřazené prvky.

Atributy

Atribut	Popis
`oldVersion`	Požadovaný atribut. Určuje verzi sestavení, která byla původně požadována. Formát čísla verze sestavení je major.minor.build.revision. Platné hodnoty pro jednotlivé části tohoto čísla verze jsou 0 až 65535. Můžete také zadat rozsah verzí v tomto formátu: n.n.n.n.n – n.n.n.n
`newVersion`	Požadovaný atribut. Určuje verzi sestavení, která se má použít místo původně požadované verze, ve formátu : n.n.n.n. Tato hodnota může určovat starší verzi než `oldVersion`.

Podřízené elementy

Element	Description
Žádná

Nadřazené elementy

Element	Popis
`assemblyBinding`	Obsahuje informace o přesměrování verze sestavení a umístění sestavení.
`configuration`	Kořenový prvek v každém konfiguračním souboru, který je používán modulem Common Language Runtime (CLR) a aplikacemi rozhraní .NET Framework.
`dependentAssembly`	Zapouzdřuje pro jednotlivá sestavení zásady vazeb a umístění sestavení. Používá pro jednotlivá sestavení jeden prvek dependentAssembly.
`runtime`	Obsahuje informace o vazbách sestavení a uvolnění paměti.

Poznámky

Při sestavování aplikace rozhraní .NET Framework v rámci sestavení se silným názvem používá aplikace ve výchozím nastavení při spuštění zmíněnou verzi, a to i tehdy, pokud je k dispozici nová verze. Aplikaci však můžete nastavit tak, aby se spustila v rámci novější verze sestavení. Podrobnosti o tom, jak modul runtime používá tyto soubory k určení verze sestavení, která se má použít, naleznete v části Jak modul runtime vyhledá sestavení.

Zahrnutím více bindingRedirect prvků do elementu dependentAssembly můžete přesměrovat více verzí sestavení. Můžete také vytvořit přesměrování z novější verze na starší verzi sestavení.

Explicitní přesměrování vazeb sestavení v konfiguračním souboru aplikace vyžaduje oprávnění zabezpečení. To platí pro přesměrování sestavení rozhraní .NET Framework a sestavení třetích stran. Oprávnění se uděluje nastavením příznaku SecurityPermissionFlag na SecurityPermission. Další informace najdete v tématu Oprávnění zabezpečení přesměrování vazby sestavení.

Příklad

Následující příklad znázorňuje způsob přesměrování jedné verze sestavení na jinou.

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