Définir des attributs d’assembly dans le code
Les attributs d’assembly sont des valeurs qui fournissent des informations sur un assembly. Ils sont généralement définis dans un fichier AssemblyInfo.cs. Les attributs sont répartis selon les ensembles d’informations suivants :
- Attributs d’identité de l’assembly
- Attributs d’informations
- Attributs de manifeste de l’assembly
- Attributs de nom fort
Cet article est limité à l’ajout d’attributs d’assembly à partir du code. Pour plus d’informations sur l’ajout d’attributs d’assembly à des projets (pas dans le code), consultez Définir des attributs d’assembly dans un fichier projet.
Attributs d’identité de l’assembly
Trois attributs avec 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 et sont requis lorsque vous référencez l’assembly dans le code. Vous pouvez utiliser les attributs 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 de l’assembly.
Le tableau suivant décrit les attributs de version et de culture.
| Attribut d’identité de l’assembly | Description |
|---|---|
| AssemblyCultureAttribute | Champ énuméré désignant la culture que l’assembly prend en charge. 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 qui n’a pas l’attribut de culture défini avec la valeur Null comme un assembly satellite. Ces assemblys sont soumis aux règles de liaison d’assembly satellite. Pour plus d’informations, consultez Méthode de localisation des assemblys par le runtime. |
| AssemblyFlagsAttribute | Valeur qui définit les attributs d’assembly, par exemple l’exécution côte à côte de l’assembly. |
| AssemblyVersionAttribute | Valeur numérique au format version principale.version secondaire.build.révision (p. ex. 2.4.0.0). Le common language runtime utilise cette valeur pour effectuer les opérations de liaison dans les 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")]
' 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 les attributs d’informations pour fournir des informations supplémentaires sur le produit ou la société de l’assembly. Le tableau suivant décrit les attributs d’informations que vous pouvez appliquer à l’assembly.
| Attributs d’informations | Description |
|---|---|
| AssemblyCompanyAttribute | Valeur de chaîne qui spécifie un nom de société. |
| AssemblyCopyrightAttribute | Valeur de chaîne qui spécifie les informations de copyright. |
| AssemblyFileVersionAttribute | Valeur de chaîne qui spécifie le numéro de version du fichier Win32. Par défaut, il s’agit normalement de la version de l’assembly. |
| AssemblyInformationalVersionAttribute | Valeur de chaîne qui spécifie les informations de version qui ne sont pas utilisées par le common language runtime, comme un numéro de version du produit complet. 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. Cette 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 qui spécifie les informations de produit. |
| AssemblyTrademarkAttribute | Valeur de chaîne qui spécifie les informations de marque. |
Ces attributs peuvent apparaître sur la page Propriétés Windows de l’assembly, ou ils peuvent être remplacés à l’aide de l’option /win32res du compilateur pour spécifier votre fichier de ressources Win32.
Attributs de manifeste de l’assembly
Vous pouvez utiliser les attributs de manifeste de l’assembly pour fournir des informations dans le manifeste de l’assembly, y compris le titre, la description, l’alias par défaut et la configuration. Le tableau suivant décrit les attributs de manifeste de l’assembly.
| Attribut de manifeste de l’assembly | Description |
|---|---|
| AssemblyConfigurationAttribute | Valeur de chaîne désignant la configuration de l’assembly, comme Retail ou Debug. Le runtime n’utilise pas cette valeur. |
| AssemblyDefaultAliasAttribute | Valeur de chaîne qui spécifie 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 ne l’est pas (comme une valeur GUID). Cette valeur peut également être utilisée comme une forme abrégée du nom complet de l’assembly. |
| AssemblyDescriptionAttribute | Valeur de chaîne désignant une brève description qui résume la nature et l’objectif de l’assembly. |
| AssemblyTitleAttribute | Valeur de chaîne qui spécifie un nom convivial pour l’assembly. Par exemple, un assembly appelé comdlg peut être nommé Contrôle boîte de dialogue commune Microsoft. |
Attributs de nom fort
Vous pouvez utiliser les attributs de nom fort pour définir un nom fort pour l’assembly. Le tableau suivant décrit les attributs de nom fort.
| Attribut de nom fort | Description |
|---|---|
| AssemblyDelaySignAttribute | Valeur booléenne qui indique que la signature différée est utilisée. |
| AssemblyKeyFileAttribute | Valeur de chaîne qui indique le nom du fichier contenant soit la clé publique (si la signature différée est utilisée), soit les clés publiques et privées transmises en tant que paramètres au constructeur de cet attribut. Notez que le nom de fichier est relatif au chemin d’accès du fichier de sortie (.exe ou .dll), et non au chemin d’accès du fichier source. |
| AssemblyKeyNameAttribute | Indique le conteneur de clé qui possède la paire de clés transmise en tant que paramètre au constructeur de cet attribut. |
L’exemple de code suivant montre les attributs à appliquer lors de l’utilisation de la signature différée pour créer un assembly avec nom fort avec un fichier de clé publique appelé myKey.snk.
[assembly:AssemblyKeyFileAttribute("myKey.snk")];
[assembly:AssemblyDelaySignAttribute(true)];
[assembly:AssemblyKeyFileAttribute("myKey.snk")]
[assembly:AssemblyDelaySignAttribute(true)]
<Assembly:AssemblyKeyFileAttribute("myKey.snk")>
<Assembly:AssemblyDelaySignAttribute(True)>
