Partager via


<qualifyAssembly> Élément

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

<Configuration>
   <Duree>
     <assemblyBinding>
       <qualifierAssembly>

Syntaxe

      <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.

Attributes

Caractéristique Descriptif
partialName Attribut obligatoire.

Spécifie le nom partiel de l’assembly tel qu’il apparaît dans le code.
fullName Attribut obligatoire.

Spécifie le nom complet de l’assembly tel qu’il apparaît dans le Global Assembly Cache.

Éléments enfants

Aucun.

Éléments parents

Élément Descriptif
assemblyBinding Contient des informations sur la redirection de version d’assembly et les emplacements des assemblys.
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 la liaison d’assembly et le garbage collection.

Remarques

L’appel de la méthode à l’aide Assembly.Load de noms d’assembly partiels entraîne le common language runtime à rechercher l’assembly uniquement dans le répertoire de base de l’application. Utilisez l’élément <qualifyAssembly> dans votre fichier de configuration d’application pour fournir les informations d’assembly complètes (nom, version, jeton de clé publique et culture) et provoquer la recherche de l’assembly dans le Global Assembly Cache.

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

Example

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