Élément <assemblyIdentity> pour <runtime>

Article
05/09/2023

Contient les informations d’identification de l’assembly.

<configuration>
  <runtime>
    <assemblyBinding>
      <dependentAssembly>
        <assemblyIdentity>

Syntaxe

   <assemblyIdentity
name="assembly name"  
publicKeyToken="public key token"  
culture="assembly culture"/>

Attributs et éléments

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

Attributs

Attribut	Description
`name`	Attribut requis. Nom de l’assembly.
`culture`	Attribut facultatif. Chaîne qui spécifie la langue et le pays ou la région de l’assembly.
`publicKeyToken`	Attribut facultatif. Valeur hexadécimale qui spécifie le nom fort de l’assembly.
`processorArchitecture`	Attribut facultatif. Une des valeurs « x86 », « amd64 », « msil » ou « ia64 », spécifiant l’architecture du processeur pour un assembly qui contient du code spécifique au processeur. Les valeurs ne respectent pas la casse. Si une autre valeur est affectée à l’attribut, l’élément `<assemblyIdentity>` est ignoré. Consultez ProcessorArchitecture.

processorArchitecture Attribute

Valeur	Description
`amd64`	Architecture AMD x86-64 uniquement.
`ia64`	Architecture Intel Itanium uniquement.
`msil`	Neutre en ce qui concerne le processeur et les bits par mot.
`x86`	Processeur x86 32 bits, natif ou dans l’environnement Windows on Windows (WOW) sur une plateforme 64 bits.

É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.
`dependentAssembly`	Encapsule la stratégie de liaisons et l’emplacement de chaque assembly. Utilisez un élément `<dependentAssembly>` pour chaque assembly.
`runtime`	Contient des informations sur les liaisons d’assembly et l’opération garbage collection.

Notes

Chaque élément <dépendantAssembly> doit avoir un élément <assemblyIdentity> enfant.

Si l’attribut processorArchitecture est présent, l’élément <assemblyIdentity> s’applique uniquement à l’assembly avec l’architecture de processeur correspondante. Si l’attribut processorArchitecture n’est pas présent, l’attribut <assemblyIdentity> élément peut s’appliquer à un assembly avec n’importe quelle architecture de processeur.

L’exemple suivant montre un fichier de configuration pour deux assemblys avec le même nom ciblant deux architectures de processeur différentes, et dont les versions n’ont pas été conservées dans la synchronisation. Lorsque l’application s’exécute sur la plateforme x86, le premier élément <assemblyIdentity> s’applique et l’autre est ignoré. Si l’application s’exécute sur une plateforme autre que x86 ou ia64, les deux sont ignorés.

<configuration>  
   <runtime>  
      <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">  
         <dependentAssembly>  
            <assemblyIdentity name="MyAssembly"  
                  publicKeyToken="14a739be0244c389"  
                  culture="neutral"  
                  processorArchitecture="x86" />  
            <bindingRedirect oldVersion= "1.0.0.0"
                  newVersion="1.1.0.0" />  
         </dependentAssembly>  
         <dependentAssembly>  
            <assemblyIdentity name="MyAssembly"  
                  publicKeyToken="14a739be0244c389"  
                  culture="neutral"
                  processorArchitecture="ia64" />  
            <bindingRedirect oldVersion="1.0.0.0"
                  newVersion="2.0.0.0" />  
         </dependentAssembly>  
      </assemblyBinding>  
   </runtime>  
</configuration>

Si un fichier de configuration contient un élément <assemblyIdentity> sans processorArchitecture attribut, et ne contient pas d’élément qui correspond à la plateforme, l’élément sans l’attribut processorArchitecture est utilisé.

Exemple

L’exemple suivant montre comment fournir des informations sur un assembly.

<configuration>  
   <runtime>  
      <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">  
         <dependentAssembly>  
            <assemblyIdentity name="myAssembly"  
                              publicKeyToken="32ab4ba45e0a69a1"  
                              culture="neutral" />  
            <!--Redirection and codeBase policy for myAssembly.-->  
         </dependentAssembly>  
      </assemblyBinding>  
   </runtime>  
</configuration>

Partager via