<qualifyAssembly>, élément

Article
08/21/2007

Spécifie le nom complet de l'assembly qui doit être chargé dynamiquement lorsqu'un nom partiel est utilisé.

<configuration>, élément
  <runtime>, élément
    <assemblyBinding>, élément
      <qualifyAssembly>, élément

<qualifyAssembly partialName="PartialAssemblyName"
                                  fullName="FullAssemblyName"/>

Attributs et éléments

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

Attributs

Attribut	Description
partialName	Attribut requis. Spécifie le nom partiel de l'assembly tel qu'il s'affiche dans le code.
fullName	Attribut requis. Spécifie le nom complet de l'assembly tel qu'il s'affiche dans le Global Assembly Cache.

partialName

Attribut requis.

Spécifie le nom partiel de l'assembly tel qu'il s'affiche dans le code.

fullName

Attribut requis.

Spécifie le nom complet de l'assembly tel qu'il s'affiche dans le Global Assembly Cache.

Éléments enfants

Aucun.

Éléments parents

Élément	Description
assemblyBinding	Contient des informations sur la redirection des versions des assemblys et sur l'emplacement de ces derniers.
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

L'appel de la méthode Assembly.Load à l'aide des noms d'assemblys partiels force le Common Language Runtime à rechercher l'assembly uniquement dans le répertoire de base de l'application. Utilisez l'élément <qualifyAssembly> dans le fichier de configuration de votre application pour fournir les informations d'assembly complètes (nom, version, jeton de clé publique et culture) et forcer le Common Language Runtime à rechercher l'assembly dans le Global Assembly Cache.

L'attribut fullName doit inclure les quatre champs d'identité d'un assembly : nom, version, jeton de clé publique et culture. L'attribut partialName doit faire partiellement référence à un assembly. Vous devez spécifier au moins le nom de l'assembly (cas le plus courant), mais vous pouvez également inclure la version, le jeton de clé publique ou la culture (ou n'importe quelle association des quatre, mais pas les quatre à la fois). L'attribut partialName doit correspondre au nom spécifié dans votre appel. Par exemple, vous ne pouvez pas spécifier "math" comme attribut partialName dans votre fichier de configuration et appeler Assembly.Load("math, Version=3.3.3.3") dans votre code.

Exemple

L'exemple suivant transforme logiquement l'appel Assembly.Load("math") en Assembly.Load("math,version=1.0.0.0,publicKeyToken=a1690a5ea44bab32,culture=neutral").

<configuration>
   <runtime>
      <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
         <qualifyAssembly partialName="math" 
                         fullName=
"math,version=1.0.0.0,publicKeyToken=a1690a5ea44bab32,culture=neutral"/>
      </assemblyBinding>
   </runtime>
</configuration>

Voir aussi

Référence

Schéma des paramètres d'exécution

Concepts

Méthode de localisation des assemblys par le runtime
Références d'assembly partielles

Share via