Compartilhar via

<bindingRedirect> Elemento

Redireciona uma versão do assembly para outra.

<configuração>
   <Runtime>
     <assemblyBinding>
       <dependentMontagem>
         <bindingRedirect>

Sintaxe

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

Atributos e elementos

As seções a seguir descrevem atributos, elementos filho e elementos pai.

Attributes

Attribute Description
oldVersion Atributo necessário.

Especifica a versão do assembly que foi originalmente solicitada. O formato de um número de versão do assembly é major.minor.build.revision. Os valores válidos para cada parte deste número de versão são de 0 a 65535.

Você também pode especificar um intervalo de versões no seguinte formato:

n.n.n.n - n.n.n.n
newVersion Atributo necessário.

Especifica a versão do assembly a ser usada em vez da versão solicitada originalmente no formato: n.n.n.n

Esse valor pode especificar uma versão anterior a oldVersion.

Elementos filho

Elemento Description
None

Elementos pai

Elemento Description
assemblyBinding Contém informações sobre o redirecionamento da versão do assembly e os locais dos assemblies.
configuration O elemento raiz em cada arquivo de configuração usado pelos aplicativos do Common Language Runtime e .NET Framework.
dependentAssembly Encapsula a política de associação e o local do assembly para cada assembly. Use um elemento dependentAssembly para cada assembly.
runtime Contém informações sobre associação de assembly e coleta de lixo.

Observações

Quando você cria um aplicativo .NET Framework em um assembly de nome forte, o aplicativo usa essa versão do assembly em runtime por padrão, mesmo que uma nova versão esteja disponível. No entanto, você pode configurar o aplicativo para ser executado em uma versão mais recente do assembly. Para obter detalhes sobre como o runtime usa esses arquivos para determinar qual versão do assembly usar, consulte Como o Runtime localiza assemblies.

Você pode redirecionar mais de uma versão do assembly incluindo vários bindingRedirect elementos em um dependentAssembly elemento. Você também pode redirecionar de uma versão mais recente para uma versão mais antiga do assembly.

O redirecionamento de associação de assembly explícito em um arquivo de configuração de aplicativo requer uma permissão de segurança. Isso se aplica ao redirecionamento de assemblies e assemblies do .NET Framework de terceiros. A permissão é concedida definindo o SecurityPermissionFlag sinalizador no SecurityPermission. Para obter mais informações, consulte a Permissão de Segurança de Redirecionamento de Associação de Assembly.

Example

O exemplo a seguir mostra como redirecionar uma versão de assembly para outra.

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

Consulte também

  • Last updated on