Configuração de redirecionamento de ligação de assembleia

Observação

Este artigo é específico do .NET Framework. Ele não se aplica a implementações mais recentes do .NET, incluindo o .NET 6 e versões posteriores.

Por padrão, os aplicativos usam o conjunto de assemblies do .NET Framework fornecidos com a versão de tempo de execução usada para compilar o aplicativo. Pode utilizar o atributo appliesTo no elemento <assemblyBinding> num ficheiro de configuração de aplicação para redirecionar as referências de associação de assembly para uma versão específica dos assemblies do .NET Framework. Esse atributo opcional usa um número de versão do .NET Framework para indicar a qual versão ele se aplica. Se não for especificado nenhum appliesTo atributo, o <assemblyBinding> elemento aplica-se a todas as versões do .NET Framework.

O appliesTo atributo foi introduzido na versão 1.1 do .NET Framework; é ignorado pelo .NET Framework versão 1.0. Isto significa que todos <assemblyBinding> os elementos são aplicados ao usar o .NET Framework versão 1.0, mesmo que um appliesTo atributo seja especificado.

Observação

Use o appliesTo atributo para limitar o redirecionamento de binding assembly para uma versão específica do runtime.

Por exemplo, para redirecionar a vinculação de assembly para um assembly do .NET Framework versão 1.0, você deve incluir o seguinte código XML no arquivo de configuração do aplicativo.

<runtime>
        <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1" appliesTo="v1.0.3705">
            <dependentAssembly>
               * assembly information goes here *
            </dependentAssembly>
       </assemblyBinding>
</runtime>

Os <assemblyBinding> elementos são sensíveis à ordem. Você deve inserir informações de redirecionamento de vinculação de assembly para quaisquer assemblies do .NET Framework versão 1.0 primeiro, e depois para quaisquer assemblies do .NET Framework versão 1.1. Finalmente, introduza a informação de redirecionamento assembly binding para qualquer redirecionamento assembly do .NET Framework que não utilize o appliesTo atributo e, portanto, se aplique a todas as versões do .NET Framework. Em caso de conflito no redirecionamento, a primeira instrução de redirecionamento correspondente no arquivo de configuração é usada.

Por exemplo, para redirecionar uma referência a um assembly do .NET Framework versão 1.0 e outra referência a um assembly do .NET Framework versão 1.1, você usaria o padrão mostrado no pseudocódigo a seguir.

<assemblyBinding xmlns="..." appliesTo="v1.0.3705">
  <!-- .NET Framework version 1.0 redirects here. -->
</assemblyBinding>

<assemblyBinding xmlns="..." appliesTo="v1.1.4322">
  <!-- .NET Framework version 1.1 redirects here. -->
</assemblyBinding>

<assemblyBinding xmlns="...">
  <!-- Redirects meant for all versions of the .NET Framework. -->
</assemblyBinding>

Depuração de erros no arquivo de configuração

O tempo de execução analisa os arquivos de configuração uma vez quando um domínio de aplicativo é criado e carrega o código nesse domínio de aplicativo. O common language runtime lida com erros em um arquivo de configuração ignorando a entrada. O tempo de execução ignora todo o arquivo de configuração se ele contiver XML malformado. Para XML inválido, apenas as seções inválidas são ignoradas.

Você pode determinar se um arquivo de configuração está a ser usado verificando se estão a ocorrer redirecionamentos de ligação de assemblies. Utilize o Assembly Binding Log Viewer (Fuslogvw.exe) para ver quais assemblies estão a ser carregados. Para ver todas as ligações de assembly, você deve definir uma entrada para ForceLog no registro.

Ver também

• Como ativar e desativar o redirecionamento automático de vinculação