Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
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 divisés en ensembles d’informations suivants :
- Attributs d’identité de l’assembly
- Attributs d’information
- 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 (et non dans le code), consultez Définir des attributs d’assembly dans un fichier projet.
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 forment le nom complet de l’assembly et sont requis lors du référencement de l’assembly dans le code. Vous pouvez utiliser des attributs pour définir la version et la culture d’un assembly. Le compilateur ou l’Assembly Linker (Al.exe) définit la valeur de 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 version et de culture.
| Attribut d’identité de l’assembly | Descriptif |
|---|---|
| AssemblyCultureAttribute | Champ énuméré indiquant la culture prise en charge par l'assemblage. Un assemblage peut également spécifier l'indépendance culturelle, indiquant qu'il contient les ressources pour la culture standard. Note: Le runtime traite tout assembly qui n’a pas l’attribut de culture défini sur Null comme assembly satellite. Ces assemblys sont soumis aux règles de liaison d’assembly satellite. Pour plus d’informations, consultez Comment le runtime localise les assemblys. |
| AssemblyFlagsAttribute | Valeur qui définit des attributs d’assembly, par exemple si l’assembly peut être exécuté côte à côte. |
| 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 des opérations de liaison dans des assemblys avec nom fort. Note : 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’information
Vous pouvez utiliser des attributs d’information pour fournir des renseignements supplémentaires sur l’entreprise ou le produit pour un assemblage. Le tableau suivant décrit les attributs d’information que vous pouvez appliquer à un assemblage.
| Attribut informationnel | Descriptif |
|---|---|
| AssemblyCompanyAttribute | Chaîne de caractères spécifiant un nom de société. |
| AssemblyCopyrightAttribute | Valeur de chaîne de texte spécifiant les informations de copyright. |
| AssemblyFileVersionAttribute | Valeur de chaîne spécifiant le numéro de version du fichier Win32. Cela est normalement défini par défaut sur la version de l’assembly. |
| AssemblyInformationalVersionAttribute | Valeur de chaîne spécifiant les informations de version qui ne sont pas utilisées par le Common Language Runtime, par exemple un numéro de version de produit complet. Note: Si cet attribut est appliqué à un assembly, la chaîne spécifiée peut être obtenue au moment de l’exécution à l’aide de la Application.ProductVersion propriété. La chaîne est également utilisée dans le chemin d’accès et la clé de Registre fournies par les propriétés Application.UserAppDataPath et Application.UserAppDataRegistry. |
| AssemblyProductAttribute | Valeur de chaîne spécifiant les informations de produit. |
| AssemblyTrademarkAttribute | Valeur de chaîne spécifiant les informations de marque. |
Ces attributs peuvent apparaître dans la page Propriétés Windows de l’assembly, ou ils peuvent être substitués à l’aide de l’option du compilateur /win32res pour spécifier votre fichier de ressources Win32.
Attributs de manifeste de l’assembly
Vous pouvez utiliser des 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 de l’assembly.
| Attribut de manifeste de l’assembly | Descriptif |
|---|---|
| AssemblyConfigurationAttribute | Valeur de chaîne indiquant la configuration de l’assembly, telle que 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 (par exemple, une valeur GUID). Cette valeur peut également être utilisée comme une abréviation du nom complet de l'assemblage. |
| AssemblyDescriptionAttribute | Valeur de chaîne spécifiant une brève description qui résume la nature et l’objectif de l’assemblage. |
| AssemblyTitleAttribute | Valeur de chaîne qui spécifie un nom convivial pour l’assembly. Par exemple, un assembly nommé comdlg peut avoir le titre Microsoft Common Dialog Control. |
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 | Descriptif |
|---|---|
| AssemblyDelaySignAttribute | Valeur booléenne indiquant que la signature différée est utilisée. |
| AssemblyKeyFileAttribute | Valeur de chaîne indiquant le nom du fichier qui contient la clé publique (si vous utilisez la signature différée) ou les clés publiques et privées passées en tant que paramètre au constructeur de cet attribut. Notez que le nom de fichier est relatif au chemin d’accès du fichier de sortie (la .exe ou .dll), et non au chemin d’accès du fichier source. |
| AssemblyKeyNameAttribute | Indique le conteneur de clés qui contient la paire de clés passée 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 à 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)>
Voir aussi
Collaborer avec nous sur GitHub
La source de ce contenu se trouve sur GitHub, où vous pouvez également créer et examiner les problèmes et les demandes de tirage. Pour plus d’informations, consultez notre guide du contributeur.
