Partilhar via


Elemento <bindingredirect>

Redireciona uma versão de assembly para outra.

<configuration> Element
  Elemento <tempo de execução>
    <assemblybinding>Elemento para <tempo de execução>
      Elemento <dependentassembly>
        Elemento <bindingredirect>

<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.compilação.Revision. Para cada parte deste número de versão, os valores válido 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 de na 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 redirecionamento de versão do assembly e os locais de módulos (assemblies).

configuration

O elemento raiz em cada arquivo de configuração usado pelo Common linguagem tempo de execução e aplicativos do .NET estrutura.

dependentAssembly

Encapsula a diretiva e o conjunto de encadernação cada conjunto de módulos (assembly). Use um elemento dependentAssembly para cada assembly.

runtime

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

Comentários

Quando você cria um aplicativo .NET estrutura em relação a um assembly de nome forte, o aplicativo usa essa versão do assembly em time 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 ambiente de execução usa esses arquivos para determinar qual versão do assembly usar, consulte Como o tempo de execução Localiza Assemblies.

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

Redirecionamento de ligação explícita de assembly em um arquivo de configuração do aplicativo requer uma permissão de segurança. Isso se aplica ao redirecionamento de módulos (assemblies) do .NET estrutura e montagens de terceiros. A permissão é concedida pelo configuração o BindingRedirects sinalizar sobre o Classe SecurityPermission. Para obter mais informações, consulte Permissão de segurança de redirecionamento de ligação de assembly.

Exemplo

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

Conceitos

Redirecionando versões de assembly

Referência

Esquema configurações Runtime

Outros recursos

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