Partilhar via


<disableCachingBindingFailures> Elemento

Especifica se deve desabilitar o cache de vinculação falhas que ocorrem porque o assembly não foi encontrado pelo probing.

<disableCachingBindingFailures enabled="0|1"/>

Atributos e elementos

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

Atributos

Atributo

Descrição

enabled

Atributo obrigatório.

Especifica se deve desabilitar o cache de vinculação falhas que ocorrem porque o assembly não foi encontrado pelo probing.

Atributo enabled

Valor

Descrição

0

Não desative o cache de vinculação falhas que ocorrem porque o assembly não foi encontrado pelo probing. Esse é o comportamento de ligação padrão começando com o.NET Framework versão 2.0.

1

Desabilite o cache de vinculação falhas que ocorrem porque o assembly não foi encontrado pelo probing. Essa configuração será revertido ao comportamento de ligaçã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 usadas pelos common language runtime e .NET Framework aplicativos.

runtime

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

Comentários

Começando com o.NET Framework versão 2.0, o comportamento padrão para carregar assemblies é armazenar em cache todos os ligação e falhas de carregamento. Ou seja, se uma tentativa de carregar um assembly falhar, as solicitações subseqüentes para carregar o mesmo assembly falharem imediatamente, sem qualquer tentativa de localizar o assembly. Este elemento desativa esse comportamento padrão para a vinculação de falhas que ocorrem porque o assembly não pôde ser encontrado no caminho de probing. Essas falhas throw FileNotFoundException.

Alguns ligação Carregando falhas não são afetados por esse elemento e sempre são armazenados em cache. Essas falhas ocorrem porque o assembly foi encontrado, mas não pôde ser carregado. Eles lançam BadImageFormatException ou FileLoadException. A lista a seguir inclui alguns exemplos de tais falhas.

  • Se você tentar carregar um arquivo não é um assembly válido, tentativas subseqüentes para carregar o assembly falhará mesmo se o arquivo defeituoso é substituído com o conjunto correto.

  • Se você tentar carregar um assembly que está bloqueado pelo sistema de arquivos, tentativas subseqüentes para carregar o assembly falhará mesmo depois que o assembly é liberado pelo sistema de arquivos.

  • Se uma ou mais versões do assembly que você está tentando carregar está no caminho de sondagem, mas a versão específica que você está solicitando não está entre eles, tentativas subseqüentes para carregar essa versão falhará, mesmo se a versão correta é movida para o caminho de probing.

Exemplo

O exemplo de código a seguir mostra como desabilitar o cache de falhas de ligação de assembly que ocorrem porque o assembly não foi encontrado pelo probing.

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

Consulte também

Referência

Esquema configurações Runtime

Conceitos

Como o Runtime Localiza Assemblies

Outros recursos

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