Élément <disableCachingBindingFailures>

Article
05/09/2023

Spécifie s’il faut désactiver la mise en cache des échecs de liaison qui se produisent parce que l’assembly n’a pas été trouvé par la détection.

<configuration>
<runtime>
<disableCachingBindingFailures>

Syntaxe

<disableCachingBindingFailures enabled="0|1"/>

Attributs et éléments

Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents.

Attributs

Attribut	Description
enabled	Attribut requis. Spécifie s’il faut désactiver la mise en cache des échecs de liaison qui se produisent parce que l’assembly n’a pas été trouvé par la détection.

Attribut enabled

Valeur	Description
0	Ne pas désactiver la mise en cache des échecs de liaison qui se produisent parce que l’assembly n’a pas été trouvé par la détection. Il s’agit du comportement de liaison par défaut commençant par .NET Framework version 2.0.
1	Désactiver la mise en cache des échecs de liaison qui se produisent parce que l’assembly n’a pas été trouvé par la détection. Ce paramètre rétablit le comportement de liaison de .NET Framework version 1.1.

Éléments enfants

Aucune.

Éléments parents

Élément	Description
`configuration`	Élément racine de chaque fichier de configuration utilisé par le Common Language Runtime et les applications .NET Framework.
`runtime`	Contient des informations sur les liaisons d’assembly et l’opération garbage collection.

Notes

À compter de .NET Framework version 2.0, le comportement par défaut pour le chargement des assemblys consiste à mettre en cache toutes les défaillances de liaison et de chargement. Autrement dit, si une tentative de chargement d’un assembly échoue, les demandes suivantes de chargement du même assembly échouent immédiatement, sans aucune tentative de localisation de l’assembly. Cet élément désactive ce comportement par défaut pour les échecs de liaison qui se produisent, car l’assembly est introuvable dans le chemin de détection. Ces échecs lèvent FileNotFoundException.

Certaines défaillances de liaison et de chargement ne sont pas affectées par cet élément et sont toujours mises en cache. Ces échecs se produisent car l’assembly a été trouvé, mais n’a pas pu être chargé. Ils lèvent BadImageFormatException ou FileLoadException. La liste suivante inclut quelques exemples de telles défaillances.

Si vous tentez de charger un fichier qui n’est pas un assembly valide, les tentatives suivantes de chargement de l’assembly échouent même si le fichier incorrect est remplacé par l’assembly correct.
Si vous tentez de charger un assembly verrouillé par le système de fichiers, les tentatives suivantes de chargement de l’assembly échouent même après la libération de l’assembly par le système de fichiers.
Si une ou plusieurs versions de l’assembly que vous essayez de charger se trouvent dans le chemin de détection, mais que la version spécifique que vous demandez n’est pas parmi elles, les tentatives suivantes de chargement de cette version échouent même si la version correcte est déplacée dans le chemin de détection.

Exemple

L’exemple suivant montre comment désactiver la mise en cache des échecs de liaison d’assembly qui se produisent, car l’assembly n’a pas été trouvé en effectuant une détection.

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

Partager via