Elemento <bindingRedirect>

Artigo
05/10/2023

Redireciona uma versão do assembly para outra.

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

Syntax

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

Atributos e elementos

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

Atributos

Atributo	Descrição
`oldVersion`	Atributo obrigató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 desse número de versão estão entre 0 e 65535. Você também pode especificar um intervalo 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 ser usado em vez da versão originalmente solicitada no formato: n.n.n.n Esse valor pode especificar uma versão anterior do `oldVersion`.

Elementos filho

Elemento	Descrição
Nenhum

Elementos pai

Elemento	Descrição
`assemblyBinding`	Contém informações sobre o redirecionamento de versão 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 local do assembly e política de associação para cada assembly. Use um elemento dependentAssembly para cada assembly.
`runtime`	Contém informações sobre associação do assembly e coleta de lixo.

Comentários

Ao criar um aplicativo .NET Framework com base em um assembly com nome forte, o aplicativo usará essa versão do assembly em tempo de execução por padrão, mesmo se uma nova versão estiver disponível. No entanto, você pode configurar o aplicativo para ser executado com base em uma versão mais nova do assembly. Para obter detalhes sobre como o tempo de execução usa esses arquivos para determinar qual versão do assembly deve ser usada, consulte Como o runtime localiza assemblies.

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

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

Exemplo

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

Compartilhar via