Partilhar via


<bindingRedirect> Elemento

Redireciona uma versão do assembly para outro.

<bindingRedirect  
   oldVersion="old 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. Para cada parte deste número de versão, os valores válidos são 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 obrigatório.

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

Elementos filho

Elemento

Descrição

Nenhum

Elementos pai

Elemento

Descrição

assemblyBinding

Contém informações sobre o redirecionamento de versão do assembly e os locais de assemblies.

configuration

O elemento raiz em cada arquivo de configuração usadas pelos common language runtime e .NET Framework aplicativos.

dependentAssembly

Encapsula a diretiva e o conjunto de encadernação de cada assembly. Use um elemento dependentAssembly para cada assembly.

runtime

Contém informações sobre o assembly ligação e coleta de lixo.

Comentários

Quando você constrói um.NET Framework aplicativo contra um assembly de nome forte, o aplicativo usa 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 seja executado em uma versão mais recente do assembly. Para obter detalhes sobre como o tempo de execução usa esses arquivos para determinar qual versão do assembly usar, consulte Como o Runtime localiza Assemblies.

Você pode redirecionar a mais de uma versão do assembly, incluindo vários bindingRedirect elementos em um dependentAssembly elemento.

O redirecionamento de ligação de explícito do assembly em um arquivo de configuração de aplicativo requer uma permissão de segurança. Isso se aplica o redirecionamento de.NET Framework e montagens de terceiros. A permissão é concedida, definindo a BindingRedirects sinalizar sobre o Classe SecurityPermission. Para obter mais informações, consulte Permissão de segurança de redirecionamento de ligação do Assembly.

Exemplo

O exemplo a seguir mostra como redirecionar uma versão do assembly para outro.

<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

Referência

Esquema configurações Runtime

Conceitos

Redirecionando as versões do Assembly

Outros recursos

Esquema do arquivo de configuração para o.NET Framework