<qualifyAssembly>, élément

Article
05/10/2023

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

<configuration>
  <runtime>
    <assemblyBinding>
      <qualifyAssembly>

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.

Attributs

Attribut	Description
`partialName`	Attribut requis. Spécifie le nom partiel de l’assembly tel qu’il apparaît dans le code.
`fullName`	Attribut requis. Spécifie le nom complet de l’assembly tel qu’il apparaît dans le Global Assembly Cache.

Éléments enfants

Aucune.

Éléments parents

Élément	Description
`assemblyBinding`	Contient des informations à propos de la redirection des versions d'assemblys et de 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 en utilisant un nom d’assembly partiel amène le Common Language Runtime à rechercher l’assembly uniquement dans le répertoire de base de l’application. Utilisez l’élément <qualifierAssembly> dans votre fichier de configuration d’application pour fournir les informations complètes sur l’assembly (nom, version, jeton de clé publique et culture) et faire en sorte que le Common Language Runtime recherche l’assembly dans le Global Assembly Cache.

L’attribut fullName doit inclure les quatre champs d’identité de l’assembly : nom, version, jeton de clé publique et culture. L’attribut partialName doit référencer partiellement un assembly. Vous devez spécifier au moins le nom textuel de l’assembly (cas le plus courant), mais vous pouvez aussi inclure la version, le jeton de clé publique ou la culture (ou n’importe quelle combinaison des quatre, mais pas les quatre à la fois). La valeur de PartialName doit correspondre au nom spécifié dans votre appel. Par exemple, vous ne pouvez pas spécifier "math" comme valeur de l’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>

Partager via