<appDomainManagerAssembly>, élément

  • Article

Spécifie l’assembly qui fournit le Gestionnaire du domaine d’application par défaut du processus.

<configuration>
  <runtime>
    <appDomainManagerAssembly>

Syntaxe

<appDomainManagerAssembly
   value="assembly display name" />

Attributs et éléments

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

Attributs

Attribut Description
value Attribut requis. Spécifie le nom d’affichage de l’assembly qui fournit le gestionnaire de domaine d’application pour le domaine d'application par défaut du processus.

É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

Pour spécifier le type du gestionnaire de domaine d’application, vous devez spécifier cet élément et l’élément <appDomainManagerType>. Si l’un de ces éléments n’est pas spécifié, l’autre est ignoré.

Quand le domaine d’application par défaut est chargé, l’exception TypeLoadException est levée si l’assembly spécifié n’existe pas ou s’il ne contient pas le type spécifié par l’élément <appDomainManagerType> ; et le processus ne démarre pas. Si l’assembly est trouvé, mais que les informations de version ne correspondent pas, une exceptionFileLoadException est levée.

Quand vous spécifiez le type de gestionnaire de domaine d’application pour le domaine d’application par défaut, les autres domaines d’application créés à partir du domaine d’application par défaut héritent du type de gestionnaire de domaine d’application. Utilisez les propriétés AppDomainSetup.AppDomainManagerType et AppDomainSetup.AppDomainManagerAssembly pour spécifier un autre type de gestionnaire de domaine d’application pour un nouveau domaine d’application.

Pour spécifier le type de gestionnaire de domaine d’application, l’application doit bénéficier d’une confiance totale. (Par exemple, une application s’exécutant sur le bureau bénéficie d’une confiance totale.) Si l’application ne dispose pas d’une confiance totale, une exception TypeLoadException est levée.

Pour connaître le format du nom d’affichage de l’assembly, consultez la propriété Assembly.FullName.

Cet élément de configuration est disponible uniquement dans .NET Framework 4 et les versions ultérieures.

Exemple

L’exemple suivant montre comment préciser que le gestionnaire de domaine d’application pour le domaine d’application par défaut d’un processus correspond au type MyMgr dans l’assembly AdMgrExample.

<configuration>  
   <runtime>  
      <appDomainManagerType value="MyMgr" />  
      <appDomainManagerAssembly
         value="AdMgrExample, Version=1.0.0.0, Culture=neutral, PublicKeyToken=6856bccf150f00b3" />  
   </runtime>  
</configuration>

Voir aussi