Compartilhar via


<disableCachingBindingFailures> Elemento

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

<configuração>
   <Runtime>
     <disableCachingBindingFailures>

Sintaxe

<disableCachingBindingFailures enabled="0|1"/>

Atributos e elementos

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

Attributes

Attribute Description
enabled Atributo necessá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

Value Description
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 começando com o .NET Framework versão 2.0.
1 Desabilite o cache de falhas de associação que ocorrem porque o assembly não foi encontrado pela investigação. Essa configuração reverte para o comportamento de associação do .NET Framework versão 1.1.

Elementos filho

Nenhum.

Elementos pai

Elemento Description
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 de assembly e coleta de lixo.

Observações

A partir do .NET Framework versão 2.0, 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 são geradas 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. Eles jogam BadImageFormatException ou FileLoadException. A lista a seguir inclui alguns exemplos dessas falhas.

  • Se você tentar carregar um arquivo não for 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 após o assembly ser liberado 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.

Example

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>

Consulte também