Udostępnij przez

<bindingRedirect> Pierwiastek

Przekierowuje jedną wersję zestawu do innej.

<konfiguracji>
   <Środowiska wykonawczego>
     <Assemblybinding>
       <dependentAssembly (Zestaw zależny)>
         <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.

Attributes

Attribute Description
oldVersion Wymagany atrybut.

Określa wersję zestawu, którego pierwotnie zażądano. Format numeru wersji zestawu to major.minor.build.revision. Prawidłowe wartości dla każdej części tego numeru wersji to 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.n
newVersion Wymagany atrybut.

Określa wersję zestawu do użycia zamiast pierwotnie żądanej wersji w formacie: n.n.n.n.n.

Ta wartość może określać starszą wersję niż oldVersion.

Elementy podrzędne

Składnik Description
Żaden

Elementy nadrzędne

Składnik Description
assemblyBinding Zawiera informacje o przekierowywaniu wersji zestawu i lokalizacjach 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ązania i lokalizację zestawu dla każdego zestawu. Użyj jednego elementu zależnegoAssembly dla każdego zestawu.
runtime Zawiera informacje na temat powiązania zestawu i odzyskiwania pamięci.

Uwagi

Podczas kompilowania aplikacji .NET Framework względem zestawu o silnej nazwie aplikacja domyślnie używa tej wersji zestawu w czasie wykonywania, nawet jeśli jest dostępna nowa wersja. Można jednak skonfigurować aplikację do uruchamiania względem nowszej wersji zestawu. Aby uzyskać szczegółowe informacje na temat sposobu używania tych plików przez środowisko uruchomieniowe w celu określenia wersji zestawu do użycia, zobacz Jak środowisko uruchomieniowe lokalizuje zestawy.

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

Jawne przekierowanie powiązania zestawu w pliku konfiguracji aplikacji wymaga uprawnień zabezpieczeń. Dotyczy to przekierowania zestawów i zestawów programu .NET Framework pochodzących od innych firm. Uprawnienie jest przyznawane przez ustawienie flagi SecurityPermissionFlagSecurityPermissionna . Aby uzyskać więcej informacji, zobacz Uprawnienia zabezpieczeń przekierowania powiązania zestawu.

Example

W poniższym przykładzie pokazano, jak przekierować jedną wersję zestawu do innej.

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

Zobacz także

  • Last updated on