Partilhar via

<bindingRedirect> Elemento

Redireciona uma versão assembly para outra.

<configuração>
   <tempo de execução>
     <assemblyBinding>
       <dependenteAssembleia>
         <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 obrigatório.

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

Também pode especificar uma gama de versões no seguinte formato:

n.n.n.n - n.n.n.n
newVersion Atributo obrigatório.

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

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

Elementos Subordinados

Elemento Description
Nenhum

Elementos Principais

Elemento Description
assemblyBinding Contém informação sobre a redireção de versões de montagem e as localizações das assembleias.
configuration O elemento raiz em cada arquivo de configuração usado pelo Common Language Runtime e aplicativos .NET Framework.
dependentAssembly Encapsula a política de ligação e a localização da montagem para cada montagem. Use um elemento dependentAssembly para cada assembly.
runtime Contém informações sobre encadernação de montagem e recolha de lixo.

Observações

Quando constrói uma aplicação .NET Framework contra um assembly com nome forte, a aplicação usa essa versão do assembly em tempo de execução por defeito, mesmo que uma nova versão esteja disponível. No entanto, pode configurar a aplicação para correr contra uma versão mais recente da assembleia. Para detalhes sobre como o runtime utiliza estes ficheiros para determinar qual a versão assembly a usar, veja Como o Runtime Localiza Assemblies.

Podes redirecionar mais do que uma versão assembly incluindo vários bindingRedirect elementos num dependentAssembly elemento. Também podes redirecionar de uma versão mais recente para uma versão mais antiga do assembly.

O redirecionamento explícito de ligação de montagem num ficheiro de configuração de aplicação requer uma permissão de segurança. Isto aplica-se ao redirecionamento de assemblies do .NET Framework e assemblies de terceiros. A permissão é concedida ao colocar a SecurityPermissionFlag bandeira no SecurityPermission. Para mais informações, consulte Permissão de Segurança de Redirecionamento de Vinculação de Assembleia.

Example

O exemplo seguinte mostra como redirecionar uma versão 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