Cette documentation est archivée et n’est pas conservée.

AssemblyVersionAttribute, classe

Mise à jour : novembre 2007

Spécifie la version de l'assembly avec attributs.

Espace de noms :  System.Reflection
Assembly :  mscorlib (dans mscorlib.dll)

[ComVisibleAttribute(true)]
[AttributeUsageAttribute(AttributeTargets.Assembly, Inherited = false)]
public sealed class AssemblyVersionAttribute : Attribute
/** @attribute ComVisibleAttribute(true) */
/** @attribute AttributeUsageAttribute(AttributeTargets.Assembly, Inherited = false) */
public final class AssemblyVersionAttribute extends Attribute
public final class AssemblyVersionAttribute extends Attribute

Le numéro de version de l'assembly fait partie de l'identité d'un assembly et joue un rôle essentiel dans la liaison à l'assembly et dans la stratégie de version. La stratégie de version par défaut du runtime est la suivante : les applications s'exécutent uniquement avec les versions dans lesquelles elles ont été générées et testées, sauf en cas de substitution par une stratégie de version explicite dans des fichiers de configuration (le fichier de configuration de l'application, le fichier de stratégie de l'éditeur et le fichier de configuration de l'administrateur de l'ordinateur). See Vue d'ensemble des assemblys for more information.

Remarque :

La vérification de la version n'est effectuée qu'avec les assemblys avec nom fort.

Le numéro de version comprend les quatre parties suivantes :

<version principale>.<version secondaire>.<numéro de build>.<numéro de révision>

Remarque importante :

Tous les composants de la version doivent être des entiers supérieurs ou égaux à 0. Les métadonnées restreignent les composants principal, secondaire, build et révision d'un assembly à une valeur maximale de UInt16.MaxValue - 1. Si un composant dépasse cette valeur, une erreur de compilation se produit.

Vous pouvez spécifier toutes les valeurs ou vous pouvez accepter le numéro de build par défaut, le numéro de révision par défaut ou les deux en utilisant un astérisque (*). Par exemple, [assembly:AssemblyVersion("2.3.25.1")] indique que 2 est la version principale, 3 la version secondaire, 25 le numéro de build et 1 le numéro de révision. Un numéro de version tel que [assembly:AssemblyVersion("1.2.*")] spécifie 1 comme version principale, 2 comme version secondaire et accepte les numéros de build et de révision par défaut. Un numéro de version tel que [assembly:AssemblyVersion("1.2.15.*")] spécifie 1 comme version principale, 2 comme version secondaire, 15 comme numéro de build et accepte le numéro de révision par défaut. Le numéro de build par défaut s'incrémente quotidiennement. Le numéro de révision par défaut est aléatoire.

Remarque :

Si vous spécifiez un astérisque pour le numéro de build, vous ne pouvez pas spécifier un numéro de révision.

Les versions principale et secondaire de l'assembly sont utilisées comme numéro de version de bibliothèque de types quand l'assembly est exporté. Certains hôtes COM n'acceptent pas les bibliothèques de type avec le numéro de version 0.0. En conséquence, si vous voulez exposer un assembly à des clients COM, affectez explicitement la version d'assembly 1.0 dans la page AssemblyVersionAttribute pour les projets créés à l'extérieur de Visual Studio 2005 et sans AssemblyVersionAttribute spécifié. Procédez de la sorte même si la version de l'assembly est 0.0. Tous les projets créés dans Visual Studio 2005 ont une version d'assembly égale à 1.0* par défaut.

Pour obtenir le nom d'un assembly que vous avez chargé, appelez la méthode GetName sur l'assembly pour obtenir AssemblyName, puis la propriété Version. Pour obtenir le nom d'un assembly que vous n'avez pas chargé, appelez la méthode GetAssemblyName à partir de votre application cliente pour vérifier la version d'assembly utilisée par votre application.

System.Object
  System.Attribute
    System.Reflection.AssemblyVersionAttribute

Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professionnel Édition x64, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile pour Smartphone, Windows Mobile pour Pocket PC, Xbox 360

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

.NET Framework

Pris en charge dans : 3.5, 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Pris en charge dans : 3.5, 2.0, 1.0

XNA Framework

Pris en charge dans : 2.0, 1.0
Afficher: