<disableFusionUpdatesFromADManager>, élément

Article
05/10/2023

Indique si le comportement par défaut, qui consiste à permettre à l’hôte du runtime de remplacer les paramètres de configuration d’un domaine d’application, est désactivé.

<configuration>
<runtime>
<disableFusionUpdatesFromADManager>

Syntaxe

<disableFusionUpdatesFromADManager 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. Indique si la capacité par défaut à remplacer les paramètres de fusion est désactivée.

Attribut enabled

Valeur	Description
0	Ne désactive pas la capacité à remplacer les paramètres de fusion. Il s’agit du comportement par défaut, à compter de .NET Framework 4.
1	Désactive la capacité à remplacer les paramètres de fusion. Cela rétablit le comportement des versions antérieures de .NET Framework.

É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

Depuis .NET Framework 4, le comportement par défaut consiste à autoriser l’objet AppDomainManager à remplacer les paramètres de configuration en utilisant la propriété ConfigurationFile ou la méthode SetConfigurationBytes de l’objet AppDomainSetup qui est transmis à votre implémentation de la méthode AppDomainManager.InitializeNewDomain, dans votre sous-classe de AppDomainManager. Pour le domaine d’application par défaut, les paramètres que vous modifiez remplacent les paramètres spécifiés par le fichier de configuration de l’application. Pour les autres domaines d’application, ils remplacent les paramètres de configuration qui ont été transmis à la méthode AppDomainManager.CreateDomain ou AppDomain.CreateDomain.

Vous pouvez transmettre de nouvelles informations de configuration ou passer null (Nothing en Visual Basic) pour éliminer les informations de configuration qui ont été transmises.

Ne transmettez pas les informations de configuration à la fois à la propriété ConfigurationFile et à la méthode SetConfigurationBytes. Si vous transmettez les informations de configuration aux deux, les informations que vous transmettez à la propriété ConfigurationFile sont ignorées, car la méthode SetConfigurationBytes remplace les informations de configuration du fichier de configuration de l’application. Si vous utilisez la propriété ConfigurationFile, vous pouvez passer null (Nothing en Visual Basic) à la méthode SetConfigurationBytes pour éliminer les éventuels octets de configuration qui ont été spécifiés dans l’appel à la méthode AppDomainManager.CreateDomain ou AppDomain.CreateDomain.

En plus des informations de configuration, vous pouvez modifier les paramètres suivants au niveau de l’objet AppDomainSetup qui est transmis à votre implémentation de la méthode AppDomainManager.InitializeNewDomain : ApplicationBase, ApplicationName, CachePath, DisallowApplicationBaseProbing, DisallowBindingRedirects, DisallowCodeDownload, DisallowPublisherPolicy, DynamicBase, LoaderOptimization, PrivateBinPath, PrivateBinPathProbe, ShadowCopyDirectories et ShadowCopyFiles.

Au lieu d’utiliser l’élément <disableFusionUpdatesFromADManager>, vous pouvez aussi désactiver le comportement par défaut en créant un paramètre de Registre ou en définissant une variable d’environnement. Dans le Registre, créez une valeur DWORD nommée COMPLUS_disableFusionUpdatesFromADManager sous HKCU\Software\Microsoft\.NETFramework ou HKLM\Software\Microsoft\.NETFramework, puis définissez la valeur sur 1. Sur la ligne de commande, définissez la variable d’environnement COMPLUS_disableFusionUpdatesFromADManager sur 1.

Exemple

L’exemple suivant montre comment désactiver la capacité à remplacer les paramètres de fusion à l’aide de l’élément <disableFusionUpdatesFromADManager>.

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

Partager via