Compartilhar via


<disableCachingBindingFailures> Element

Especifica se é necessário desabilitar o cache de falhas de associação que ocorrem porque o assembly não foi encontrado pela investigação.

<configuration>
  <runtime>
    <disableCachingBindingFailures>

Syntax

<disableCachingBindingFailures enabled="0|1"/>  

Atributos e elementos

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

Atributos

Atributo Descrição
Habilitado Atributo obrigatório.

Especifica se é necessário desabilitar o cache de falhas de associação que ocorrem porque o assembly não foi encontrado pela investigação.

Atributo habilitado

Valor Descrição
0 Não desabilite o cache de falhas de associação que ocorrem porque o assembly não foi encontrado pela investigação. Esse é o comportamento de associação padrão do .NET Framework versão 2.0 em diante.
1 Desabilite o cache de falhas de associação que ocorrem porque o assembly não foi encontrado pela investigação. Essa configuração é revertida para o comportamento de associação do .NET Framework versão 1.1.

Elementos filho

Nenhum.

Elementos pai

Elemento Descrição
configuration O elemento raiz em cada arquivo de configuração usado pelos aplicativos do Common Language Runtime e .NET Framework.
runtime Contém informações sobre associação do assembly e coleta de lixo.

Comentários

Do .NET Framework versão 2.0 em diante, o comportamento padrão para carregar assemblies é armazenar em cache todas as falhas de associação e carregamento. Ou seja, se uma tentativa de carregar um assembly falhar, as solicitações subsequentes para carregar o mesmo assembly falharão imediatamente, sem qualquer tentativa de localizar o assembly. Esse elemento desabilita esse comportamento padrão para falhas de associação que ocorrem porque o assembly não pôde ser encontrado no caminho de investigação. Essas falhas geram FileNotFoundException.

Algumas falhas de associação e carregamento não são afetadas por esse elemento e são sempre armazenadas em cache. Essas falhas ocorrem porque o assembly foi encontrado, mas não pôde ser carregado. Elas geram BadImageFormatException ou FileLoadException. A lista a seguir inclui alguns exemplos dessas falhas.

  • Se você tentar carregar um arquivo que não é um assembly válido, as tentativas subsequentes de carregar o assembly falharão mesmo se o arquivo incorreto for substituído pelo assembly correto.

  • Se você tentar carregar um assembly bloqueado pelo sistema de arquivos, as tentativas subsequentes de carregar o assembly falharão mesmo depois que o assembly for liberado do bloqueio pelo sistema de arquivos.

  • Se uma ou mais versões do assembly que você está tentando carregar estiverem no caminho de investigação, mas a versão específica que você está solicitando não estiver entre elas, as tentativas subsequentes de carregar essa versão falharão mesmo se a versão correta for movida para o caminho de investigação.

Exemplo

O exemplo a seguir mostra como desabilitar o cache de falhas de associação de assembly que ocorrem porque o assembly não foi encontrado pela investigação.

<configuration>  
   <runtime>  
      <disableCachingBindingFailures enabled="1" />  
   </runtime>  
</configuration>  

Confira também