Compartilhar via


Configurando o redirecionamento de ligação de Assembly

Por padrão, os aplicativos usam o conjunto de.Assemblies do NET Framework que acompanha a versão de tempo de execução usada para compilar o aplicativo. Você pode usar o appliesTo de atributo na <assemblyBinding> elemento em um arquivo de configuração do aplicativo para redirecionar referências de ligação de assembly para uma versão específica do.Assemblies do NET Framework. Este atributo opcional utiliza um.Número de versão do NET Framework para indicar qual versão ele se aplica ao. Se nenhum appliesTo atributo for especificado, o <assemblyBinding> elemento aplica-se a todas as versões do.NET Framework.

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

Observação

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

Por exemplo, para redirecionar assembly ligação para um.Assembly do NET Framework versão 1.0, você incluiria o seguinte código XML no seu 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>

O <assemblyBinding> elementos são sensíveis à ordem. Você deve inserir informações de redirecionamento de ligação de assembly para qualquer um.NET assemblies do Framework versão 1.0 primeiro, seguido de informações de redirecionamento de ligação de assembly para qualquer um.Assemblies do NET Framework versão 1.1. Finalmente, insira as informações de redirecionamento de ligação de assembly para qualquer um.Redirecionamento de assembly do NET Framework que não use o appliesTo de atributo e, portanto, se aplica a todas as versões do.NET Framework. No caso de um conflito no redirecionamento, a primeira instrução de redirecionamento correspondentes 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 para 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>

Consulte também

Tarefas

Como: Usar um arquivo de configuração do aplicativo para o destino um.NET Framework versão

Conceitos

Erros de arquivo de configuração de depuração.

Redirecionamento de ligação de assembly

Determinando qual versão do Runtime para carregar