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

AssemblyVersionAttribute, classe

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
ComVisibleAttribute(true) 
AttributeUsageAttribute(AttributeTargets.Assembly, Inherited=false) 
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). Pour plus d'informations, consultez Vue d'ensemble des assemblys.

RemarqueRemarque

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>

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.

RemarqueRemarque

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

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

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

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

.NET Framework

Prise en charge dans : 2.0, 1.1, 1.0

.NET Compact Framework

Prise en charge dans : 2.0, 1.0
Afficher: