Définition des attributs d'assembly
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 |
|---|---|
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. .gif "Remarque") 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.
|
|
Valeur définissant les attributs d'assembly, par exemple, si l'assembly peut être exécuté en mode côte à côte. |
|
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")]
// 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 |
|---|---|
Valeur de chaîne spécifiant un nom de société. |
|
Valeur de chaîne spécifiant des informations de copyright. |
|
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. |
|
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.
|
|
Valeur de chaîne spécifiant des informations sur le produit. |
|
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 |
|---|---|
Valeur de chaîne indiquant la configuration de l'assembly, comme Retail ou Debug. Le runtime n'utilise pas cette valeur. |
|
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. |
|
Valeur de chaîne spécifiant une brève description résumant la nature et la fonction de l'assembly. |
|
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 |
|---|---|
Valeur booléenne indiquant l'utilisation de la temporisation de signature. |
|
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. |
|
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)]
[assembly:AssemblyKeyFileAttribute("myKey.snk")];
[assembly:AssemblyDelaySignAttribute(true)];