Partager via


Définition des attributs d'assembly

Mise à jour : novembre 2007

Les attributs d'assembly sont des valeurs qui fournissent des informations au sujet d'un assembly. Les attributs sont répartis entre les ensembles d'informations suivants :

  • Attributs d'identité de l'assembly.

  • Attributs d'informations.

  • Attributs de manifeste d'assembly.

  • Attributs de nom fort.

Attributs d'identité de l'assembly

Trois attributs, ainsi qu'un nom fort (le cas échéant), déterminent l'identité d'un assembly : nom, version et culture. Ces attributs constituent le nom complet de l'assembly. Ils sont requis lorsque l'assembly est référencé en code. Vous pouvez les utiliser pour définir la version et la culture d'un assembly. Le compilateur ou l'utilitaire Assembly Linker (Al.exe) définit la valeur du nom lors de la création de l'assembly, en fonction du fichier contenant le manifeste d'assembly.

Le tableau suivant décrit les attributs de culture et de version.

Attribut d'identité de l'assembly

Description

AssemblyCultureAttribute

Champ énuméré indiquant la culture prise en charge par l'assembly. Un assembly peut également spécifier une indépendance de culture, indiquant qu'il contient les ressources pour la culture par défaut.

Remarque :

Le runtime gère tout assembly dont l'attribut de culture n'a pas la valeur null comme un assembly satellite. Ces assemblys sont soumis aux règles de liaison des assemblys satellites. Pour plus d'informations, consultez Méthode de localisation des assemblys par le runtime.

AssemblyFlagsAttribute

Valeur définissant les attributs d'assembly, par exemple, si l'assembly peut être exécuté en mode côte à côte.

AssemblyVersionAttribute

Valeur numérique au format major.minor.build.revision (par exemple, 2.4.0.0). Le Common Language Runtime utilise cette valeur pour effectuer les opérations de liaison dans des assemblys avec nom fort.

Remarque :

Si l'attribut AssemblyInformationalVersionAttribute n'est pas appliqué à un assembly, le numéro de version spécifié par l'attribut AssemblyVersionAttribute est utilisé par les propriétés Application.ProductVersion, Application.UserAppDataPath et Application.UserAppDataRegistry

L'exemple de code suivant montre comment appliquer les attributs de version et de culture à un assembly.

'Set version number for the assembly.
<Assembly:AssemblyVersionAttribute("4.3.2.1")>
'Set culture as German.
<Assembly:AssemblyCultureAttribute("de")>
//Set version number for the assembly.
[assembly:AssemblyVersionAttribute("4.3.2.1")]
//Set culture as German.
[assembly:AssemblyCultureAttribute("de")]

Attributs d'informations

Vous pouvez utiliser des attributs d'informations pour fournir des informations complémentaires relatives à la société ou au produit au sujet d'un assembly. Le tableau suivant décrit les attributs d'informations que vous pouvez appliquer à un assembly.

Attribut d'informations

Description

AssemblyCompanyAttribute

Valeur de chaîne spécifiant un nom de société.

AssemblyCopyrightAttribute

Valeur de chaîne spécifiant des informations de copyright.

AssemblyFileVersionAttribute

Valeur de chaîne spécifiant le numéro de version du fichier Win32. Par défaut, il s'agit de la version de l'assembly.

AssemblyInformationalVersionAttribute

Valeur de chaîne spécifiant des informations de version qui ne sont pas utilisées par le Common Language Runtime, telles que le numéro de version complet d'un produit.

Remarque :

Si cet attribut est appliqué à un assembly, la chaîne qu'il spécifie peut être obtenue au moment de l'exécution à l'aide de la propriété Application.ProductVersion. La chaîne est également utilisée dans le chemin d'accès et la clé de Registre fournis par les propriétés Application.UserAppDataPath et Application.UserAppDataRegistry.

AssemblyProductAttribute

Valeur de chaîne spécifiant des informations sur le produit.

AssemblyTrademarkAttribute

Valeur de chaîne spécifiant des informations sur la marque.

Ces attributs peuvent s'afficher dans la page Propriétés Windows de l'assembly. Vous pouvez également les substituer à l'aide de l'option du compilateur /win32res afin de spécifier votre propre fichier de ressources Win32.

Attributs de manifeste d'assembly

Vous pouvez utiliser les attributs de manifeste d'assembly pour fournir des informations dans le manifeste d'assembly, notamment le titre, la description, l'alias par défaut et la configuration. Le tableau suivant décrit les attributs de manifeste d'assembly.

Attribut de manifeste d'assembly

Description

AssemblyConfigurationAttribute

Valeur de chaîne indiquant la configuration de l'assembly, comme Retail ou Debug. Le runtime n'utilise pas cette valeur.

AssemblyDefaultAliasAttribute

Valeur de chaîne spécifiant un alias par défaut à utiliser en référençant les assemblys. Cette valeur fournit un nom convivial lorsque le nom de l'assembly lui-même n'est pas convivial (comme une valeur GUID). Cette valeur peut également être utilisée comme forme abrégée du nom complet de l'assembly.

AssemblyDescriptionAttribute

Valeur de chaîne spécifiant une brève description résumant la nature et la fonction de l'assembly.

AssemblyTitleAttribute

Valeur de chaîne spécifiant un nom convivial pour l'assembly. Par exemple, un assembly appelé comdlg peut avoir le titre Contrôle Microsoft Common Dialog.

Attributs de nom fort

Vous pouvez avoir recours à des attributs de nom fort pour définir le nom fort d'un assembly. Le tableau suivant décrit les attributs de nom fort.

Attributs de nom fort

Description

AssemblyDelaySignAttribute

Valeur booléenne indiquant l'utilisation de la temporisation de signature.

AssemblyKeyFileAttribute

Valeur de chaîne indiquant le nom du fichier qui contient soit la clé publique (en cas d'utilisation de la temporisation de signature), soit la clé publique et la clé privée passées comme paramètre au constructeur de cet attribut. Notez que le nom de fichier est fonction du chemin d'accès du fichier de sortie (.exe ou .dll), pas de celui du fichier source.

AssemblyKeyNameAttribute

Indique le conteneur de clé qui contient la clé passée comme paramètre au constructeur de cet attribut.

L'exemple de code suivant montre les attributs à appliquer lors de l'utilisation de la temporisation de signature pour créer un assembly avec nom fort avec un fichier de clé publique myKey.snk.

      <Assembly:AssemblyKeyFileAttribute("myKey.snk")>
      <Assembly:AssemblyDelaySignAttribute(True)>
      [assembly:AssemblyKeyFileAttribute(@"..\..\myKey.snk")]
      [assembly:AssemblyDelaySignAttribute(true)]

Voir aussi

Concepts

Création d'assemblys

Autres ressources

Programmation à l'aide d'assemblys