<bindingRedirect> , element

Artykuł
05/10/2023

Przekierowuje jedną wersję zestawu do innej.

<Konfiguracji>
  <Środowiska wykonawczego>
    <Assemblybinding>
      <dependentAssembly>
        <Bindingredirect>

Składnia

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

Atrybuty i elementy

W poniższych sekcjach opisano atrybuty, elementy podrzędne i elementy nadrzędne.

Atrybuty

Atrybut	Opis
`oldVersion`	Atrybut wymagany. Określa pierwotnie żądaną wersję zestawu. Format numeru wersji zestawu to major.minor.build.revision. Prawidłowe wartości każdej części tego numeru wersji należą do zakresu od 0 do 65535. Można również określić zakres wersji w następującym formacie: n.n.n.n.- n.n.n.n.n
`newVersion`	Atrybut wymagany. Określa wersję zestawu do użycia zamiast pierwotnie żądanej wersji w formacie: n.n.n.n Ta wartość może określać starszą wersję niż `oldVersion`.

Elementy podrzędne

Element	Opis
Brak

Elementy nadrzędne

Element	Opis
`assemblyBinding`	Zawiera informacje o przekierowaniu wersji zestawu i lokalizacji zestawów.
`configuration`	Element główny w każdym pliku konfiguracji używanym przez środowisko uruchomieniowe języka wspólnego i aplikacje programu .NET Framework.
`dependentAssembly`	Hermetyzuje zasady powiązań oraz lokalizację zestawu dla każdego zestawu. Dla każdego zestawu należy użyć jednego elementu dependentAssembly.
`runtime`	Zawiera informacje dotyczące powiązania zestawu oraz wyrzucania elementów bezużytecznych.

Uwagi

W przypadku skompilowania aplikacji programu .NET Framework z użyciem zestawu o silnej nazwie aplikacja domyślnie używa tej wersji w czasie działania, nawet jeśli jest dostępna nowa wersja. Można jednak skonfigurować aplikację do działania z użyciem nowszej wersji zestawu. Aby uzyskać szczegółowe informacje na temat sposobu używania tych plików przez środowisko uruchomieniowe do określenia wersji zestawu, zobacz Jak środowisko uruchomieniowe lokalizuje zestawy.

Można przekierować więcej niż jedną wersję zestawu, dołączając wiele bindingRedirect elementów do dependentAssembly elementu. Można również wykonać przekierowanie z nowszej wersji zestawu do starszej.

Jawne przekierowanie powiązań zestawu w pliku konfiguracji aplikacji wymaga uprawnienia zabezpieczeń. Dotyczy to przekierowań zestawów programu .NET Framework i zestawów firm trzecich. Uprawnienie jest przyznawane przez ustawienie flagi SecurityPermissionFlag na .SecurityPermission Aby uzyskać więcej informacji, zobacz Uprawnienia zabezpieczeń przekierowania powiązania zestawu.

Przykład

W poniższym przykładzie pokazano sposób przekierowywania wersji zestawu.

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