Partilhar via


<disableCachingBindingFailures Element (Elemento disableCachingBindingFailures> )

Especifica se pretende desativar a colocação em cache de falhas de enlace que ocorrem porque a assemblagem não foi encontrada ao sondar.

<configuração>
  <runtime>
    <disableCachingBindingFailures>

Syntax

<disableCachingBindingFailures enabled="0|1"/>  

Atributos e Elementos

As secções seguintes descrevem atributos, elementos subordinados e elementos principais.

Atributos

Atributo Descrição
ativado Atributo obrigatório.

Especifica se pretende desativar a colocação em cache de falhas de enlace que ocorrem porque a assemblagem não foi encontrada ao sondar.

Atributo ativado

Valor Descrição
0 Não desative a colocação em cache de falhas de enlace que ocorrem porque a assemblagem não foi encontrada ao sondar. Este é o comportamento de enlace predefinido que começa com .NET Framework versão 2.0.
1 Desative a colocação em cache de falhas de enlace que ocorrem porque a assemblagem não foi encontrada ao sondar. Esta definição reverte para o comportamento de enlace do .NET Framework versão 1.1.

Elementos Subordinados

Nenhum.

Elementos Principais

Elemento Descrição
configuration O elemento raiz em cada ficheiro de configuração utilizado pelo runtime de linguagem comum e .NET Framework aplicações.
runtime Contém informações sobre o enlace de montagem e a libertação da memória.

Observações

A partir do .NET Framework versão 2.0, o comportamento predefinido para carregar assemblagens é colocar em cache todas as falhas de enlace e carregamento. Ou seja, se uma tentativa de carregar uma assemblagem falhar, os pedidos subsequentes para carregar a mesma assemblagem falham imediatamente, sem qualquer tentativa de localizar a assemblagem. Este elemento desativa esse comportamento predefinido para falhas de enlace que ocorrem porque não foi possível encontrar a assemblagem no caminho de pesquisa. Estas falhas geram FileNotFoundException.

Algumas falhas de enlace e carregamento não são afetadas por este elemento e são sempre colocadas em cache. Estas falhas ocorrem porque a assemblagem foi encontrada, mas não foi possível carregá-la. BadImageFormatException Atiram ou FileLoadException. A lista seguinte inclui alguns exemplos de tais falhas.

  • Se tentar carregar um ficheiro não for uma assemblagem válida, as tentativas subsequentes de carregamento da assemblagem falharão mesmo que o ficheiro incorreto seja substituído pela assemblagem correta.

  • Se tentar carregar uma assemblagem bloqueada pelo sistema de ficheiros, as tentativas subsequentes de carregamento da assemblagem falharão mesmo depois de a assemblagem ser lançada pelo sistema de ficheiros.

  • Se uma ou mais versões da assemblagem que está a tentar carregar estiverem no caminho de pesquisa, mas a versão específica que está a pedir não estiver entre elas, as tentativas subsequentes de carregar essa versão falharão mesmo que a versão correta seja movida para o caminho de pesquisa.

Exemplo

O exemplo seguinte mostra como desativar a colocação em cache de falhas de enlace de assemblagem que ocorrem porque a assemblagem não foi encontrada ao sondar.

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

Ver também