<bindingRedirect Element (Elemento bindingRedirect> )

Artigo
04/08/2023

Redireciona uma versão de assemblagem para outra.

<configuração>
  <runtime>
    <assemblyBinding>
      <dependentAssembly>
        <bindingRedirect>

Syntax

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

Atributos e Elementos

As secções seguintes descrevem atributos, elementos subordinados e elementos principais.

Atributos

Atributo	Descrição
`oldVersion`	Atributo obrigatório. Especifica a versão da assemblagem que foi originalmente pedida. O formato de um número de versão de assemblagem é 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 um intervalo de versões no seguinte formato: n.n.n.n - n.n.n.n.n
`newVersion`	Atributo obrigatório. Especifica a versão da assemblagem a utilizar em vez da versão originalmente pedida no formato: n.n.n.n Este valor pode especificar uma versão anterior a `oldVersion`.

Elementos Subordinados

Elemento	Descrição
Nenhum

Elementos Principais

Elemento	Descrição
`assemblyBinding`	Contém informações sobre o redirecionamento da versão de assemblagem e as localizações das assemblagens.
`configuration`	O elemento raiz em cada ficheiro de configuração utilizado pelo runtime de linguagem comum e .NET Framework aplicações.
`dependentAssembly`	Encapsula a política de enlace e a localização de assemblagem para cada assemblagem. Utilize um elemento dependentAssembly para cada assemblagem.
`runtime`	Contém informações sobre o enlace de montagem e a libertação da memória.

Observações

Quando cria uma aplicação .NET Framework numa assemblagem com um nome forte, a aplicação utiliza essa versão da assemblagem no tempo de execução por predefinição, mesmo que esteja disponível uma nova versão. No entanto, pode configurar a aplicação para ser executada numa versão mais recente da assemblagem. Para obter detalhes sobre como o runtime utiliza estes ficheiros para determinar qual a versão de assemblagem a utilizar, veja Como o Runtime Localiza Assemblagens.

Pode redirecionar mais do que uma versão de assemblagem ao incluir vários bindingRedirect elementos num dependentAssembly elemento. Também pode redirecionar de uma versão mais recente para uma versão mais antiga da assemblagem.

O redirecionamento de enlace de assemblagem explícito num ficheiro de configuração de aplicação requer uma permissão de segurança. Isto aplica-se ao redirecionamento de .NET Framework assemblagens e assemblagens de terceiros. A permissão é concedida ao definir o SecurityPermissionFlag sinalizador no SecurityPermission. Para obter mais informações, veja Permissão de Segurança de Redirecionamento de Enlace de Assemblagem.

Exemplo

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