Cette page vous a-t-elle été utile ?
Votre avis sur ce contenu est important. N'hésitez pas à nous faire part de vos commentaires.
Vous avez d'autres commentaires ?
1500 caractères restants
Version, classe
Collapse the table of content
Expand the table of content
Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source

Version, classe

Représente le numéro de version d'un assembly, d'un système d'exploitation ou du Common Language Runtime. Cette classe ne peut pas être héritée.

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

[SerializableAttribute]
[ComVisibleAttribute(true)]
public sealed class Version : ICloneable, 
	IComparable, IComparable<Version>, IEquatable<Version>

Le type Version expose les membres suivants.

  NomDescription
Méthode publiqueVersion()Initialise une nouvelle instance de la classe Version.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreVersion(String)Initialise une nouvelle instance de la classe Version à l'aide de la chaîne spécifiée.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreVersion(Int32, Int32)Initialise une nouvelle instance de la classe Version à l'aide des valeurs de numéros major et minor spécifiées.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreVersion(Int32, Int32, Int32)Initialise une nouvelle instance de la classe Version à l'aide des valeurs de numéros major et minor spécifiées.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreVersion(Int32, Int32, Int32, Int32)Initialise une nouvelle instance de la classe Version avec les numéros major, minor, build et revision spécifiés.
Début

  NomDescription
Propriété publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreBuildObtient la valeur du composant build du numéro de version de l'objet Version en cours.
Propriété publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreMajorObtient la valeur du composant principal du numéro de version de l'objet Version en cours.
Propriété publiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreMajorRevisionObtient les 16 bits de poids fort du numéro de révision.
Propriété publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreMinorObtient la valeur du composant secondaire du numéro de version de l'objet Version en cours.
Propriété publiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreMinorRevisionObtient les 16 bits de poids faible du numéro de révision.
Propriété publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreRevisionObtient la valeur du composant révision du numéro de version de l'objet Version en cours.
Début

  NomDescription
Méthode publiquePris en charge par XNA FrameworkCloneRetourne un nouvel objet Version dont la valeur est identique à celle de l'objet Version en cours.
Méthode publiquePris en charge par XNA FrameworkCompareTo(Object)Compare l'objet Version en cours à un objet spécifié et retourne une indication de leurs valeurs relatives.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreCompareTo(Version)Compare l'objet Version en cours à un objet Version spécifié et retourne une indication de leurs valeurs relatives.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreEquals(Object)Retourne une valeur indiquant si l'objet Version en cours est identique à un objet spécifié. (Substitue Object.Equals(Object).)
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreEquals(Version)Retourne une valeur indiquant si l'objet Version en cours et un objet Version spécifié représentent la même valeur.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreGetHashCodeRetourne un code de hachage pour l'objet Version en cours. (Substitue Object.GetHashCode().)
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreGetTypeObtient le Type de l'instance actuelle. (Hérité de Object.)
Méthode publiqueMembre statiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreParseConvertit la représentation sous forme de chaîne d'un numéro de version en un objet Version équivalent.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreToString()Convertit la valeur de l'objet Version en cours en sa représentation String équivalente. (Substitue Object.ToString().)
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreToString(Int32)Convertit la valeur de l'objet Version en cours en sa représentation String équivalente. Un nombre spécifié indique le nombre de composants à retourner.
Méthode publiqueMembre statiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreTryParseEssaie de convertir la représentation sous forme de chaîne d'un numéro de version en un objet Version équivalent et retourne une valeur indiquant si la conversion a réussi.
Début

  NomDescription
Opérateur publicMembre statiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreEqualityDétermine si deux objets Version spécifiés sont identiques.
Opérateur publicMembre statiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreGreaterThanDétermine si le premier objet Version spécifié est supérieur au second objet Version spécifié.
Opérateur publicMembre statiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreGreaterThanOrEqualDétermine si le premier objet Version spécifié est supérieur ou égal au second objet Version spécifié.
Opérateur publicMembre statiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreInequalityDétermine si deux objets Version spécifiés ne sont pas identiques.
Opérateur publicMembre statiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreLessThanDétermine si le premier objet Version spécifié est inférieur au second objet Version spécifié.
Opérateur publicMembre statiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreLessThanOrEqualDétermine si le premier objet Version spécifié est inférieur ou égal au second objet Version.
Début

  NomDescription
Implémentation d'interface expliciteMéthode privéePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreIComparable.CompareToCompare l'instance actuelle avec un autre objet du même type et retourne un entier qui indique si l'instance actuelle précède ou suit un autre objet ou se trouve à la même position dans l'ordre de tri.
Début

Les numéros de version comportent de deux à quatre composants : principal, secondaire, build et révision. Les composants principal et secondaire sont obligatoires ; les composants build et révision sont facultatifs, mais le composant build est obligatoire si le composant révision est défini. Tous les composants définis doivent être des entiers supérieurs ou égaux à 0. Le format du numéro de version est comme suit (les composants facultatifs sont affichés entre crochets ([ et ]) :

major.minor[.build[.revision]]

Les composants sont utilisés par convention de la façon suivante :

  • Major : Les assemblys portant le même nom, mais ayant des versions principales différentes, ne sont pas interchangeables. Un numéro de version supérieur peut indiquer une réécriture majeure d'un produit lorsque la compatibilité descendante ne peut pas être assumée.

  • Secondaire : Si le nom et le numéro de version principal de deux assemblys sont identiques, mais que le numéro de version secondaire est différent, cela indique une amélioration significative avec intention de conserver une compatibilité descendante. Ce numéro de version secondaire supérieur peut indiquer une version ponctuelle d'un produit ou une nouvelle version d'un produit dont la compatibilité descendante est totale.

  • Build : une différence dans le numéro de build représente une recompilation de la même source. Différents numéros de build peuvent être utilisés lorsque le processeur, la plateforme ou le compilateur change.

  • Révision : Les assemblys portant le même nom et les mêmes numéros de versions principale et secondaire, mais ayant des révisions différentes sont destinés à être totalement interchangeables. Un numéro de révision supérieur peut être utilisé dans un build qui résout une faille de sécurité dans une version précédente d'un assembly.

Les versions suivantes d'un assembly, lorsqu'elles ne diffèrent que par les numéros de build ou de révision, sont considérées comme des mises à jour correctives de la version précédente.

À partir du .NET Framework 2.0, les propriétés MajorRevision et MinorRevision vous permettent d'identifier une version temporaire de votre application qui, par exemple, résout un problème en attendant la diffusion d'une solution permanente. En outre, le système d'exploitation Windows NT utilise la propriété MajorRevision pour encoder le numéro de Service Pack.

Assignation des informations de version aux assemblys

D'ordinaire, la classe Version n'est pas utilisée pour assigner un numéro de version à un assembly. Au lieu de cela, la classe AssemblyVersionAttribute est utilisée pour définir la version d'un assembly, comme l'illustre l'exemple dans cette rubrique.

Récupération des informations de version

Les objets Version sont plus fréquemment utilisés pour stocker des informations de version au sujet d'un composant du système ou d'une application (tel que le système d'exploitation), du Common Language Runtime, du fichier exécutable de l'application active ou d'un assembly particulier. Voici quelques exemples des scénarios les plus courants :

  • Récupération de la version du système d'exploitation. L'exemple suivant utilise la propriété OperatingSystem.Version pour récupérer le numéro de version du système d'exploitation.

    
    // Get the operating system version.
    OperatingSystem os = Environment.OSVersion;
    Version ver = os.Version;
    Console.WriteLine("Operating System: {0} ({1})", os.VersionString, ver.ToString());
    
    
    
  • Récupération de la version actuelle du Common Language Runtime. L'exemple suivant utilise la propriété Environment.Version pour récupérer les informations de version du Common Language Runtime.

    
    // Get the common language runtime version.
    Version ver = Environment.Version;
    Console.WriteLine("CLR Version {0}", ver.ToString());
    
    
    
  • Récupération de la version actuelle de l'assembly de l'application. L'exemple suivant utilise la méthode Assembly.GetEntryAssembly pour obtenir une référence à un objet Assembly qui représente le fichier exécutable d'application puis récupère son numéro de version d'assembly.

    
    using System;
    using System.Reflection;
    
    public class Example
    {
       public static void Main()
       {
          // Get the version of the executing assembly (that is, this assembly).
          Assembly assem = Assembly.GetEntryAssembly();
          AssemblyName assemName = assem.GetName();
          Version ver = assemName.Version;
          Console.WriteLine("Application {0}, Version {1}", assemName.Name, ver.ToString());
       }
    }
    
    
    
  • Récupération de la version actuelle de l'assembly de l'assembly. L'exemple suivant utilise la méthode Assembly.GetExecutingAssembly pour obtenir une référence à un objet Assembly qui représente le fichier exécutable de l'assembly actif puis récupère ses informations de version.

    
    using System;
    using System.Reflection;
    
    public class Example
    {
       public static void Main()
       {
          // Get the version of the current assembly.
          Assembly assem = Assembly.GetExecutingAssembly();
          AssemblyName assemName = assem.GetName();
          Version ver = assemName.Version;
          Console.WriteLine("{0}, Version {1}", assemName.Name, ver.ToString());
       }
    }
    
    
    
  • Récupération de la version d'un assembly spécifique. L'exemple suivant utilise la méthode Assembly.ReflectionOnlyLoadFrom pour obtenir une référence à un objet Assembly qui a un nom de fichier particulier, puis récupère ses informations de version. Notez que d'autres méthodes existent pour instancier un objet Assembly par nom de fichier ou par nom fort.

    
    using System;
    using System.Reflection;
    
    public class Example
    {
       public static void Main()
       {
          // Get the version of a specific assembly.
          string filename = @".\StringLibrary.dll";
          Assembly assem = Assembly.ReflectionOnlyLoadFrom(filename);
          AssemblyName assemName = assem.GetName();
          Version ver = assemName.Version;
          Console.WriteLine("{0}, Version {1}", assemName.Name, ver.ToString());
       }
    
    
    
  • Récupération de la version de publication d'une application ClickOnce. L'exemple suivant utilise la propriété ApplicationDeployment.CurrentVersion pour afficher une application publient la version. Notez que son exécution réussie requiert l'identité de l'application de l'exemple à définir. Celle-ci est gérée automatiquement par Visual Studio Assistant Publication.

    
    using System;
    using System.Deployment.Application;
    
    public class Example
    {
       public static void Main()
       {
          Version ver = ApplicationDeployment.CurrentDeployment.CurrentVersion;
          Console.WriteLine("ClickOnce Publish Version: {0}", ver);
       }
    }
    
    
    
    Remarque importanteImportant

    La version de publication d'une demande de déploiement ClickOnce est totalement indépendante de sa version d'assembly.

Comparaison d'objets Version

Vous pouvez utiliser la méthode CompareTo pour déterminer si un objet Version est antérieur, identique ou postérieur à un deuxième objet Version. L'exemple suivant indique que la version 2.1 est postérieure à la version 2.0.


Version v1 = new Version(2, 0);
Version v2 = new Version("2.1");
Console.Write("Version {0} is ", v1);
switch(v1.CompareTo(v2))
{
   case 0:
      Console.Write("the same as");
      break;
   case 1:
      Console.Write("later than");
      break;
   case -1:
      Console.Write("earlier than");
      break;
}
Console.WriteLine(" Version {0}.", v2);                  
// The example displays the following output:
//       Version 2.0 is earlier than Version 2.1.


Pour que les deux versions soient égales, les numéros de version principale, secondaire, de build et de révision du premier objet Version doivent être identiques à ceux du deuxième objet Version. Si le numéro de build ou de révision d'un objet Version est non défini, cet objet Version est considéré comme antérieur à un objet Version dont le numéro de build ou de révision est égal à zéro. L'exemple suivant l'illustre en comparant trois objets Version qui ont des composants de version indéfinis.


using System;

enum VersionTime {Earlier = -1, Same = 0, Later = 1 };

public class Example
{
   public static void Main()
   {
      Version v1 = new Version(1, 1);
      Version v1a = new Version("1.1.0");
      ShowRelationship(v1, v1a);

      Version v1b = new Version(1, 1, 0, 0);
      ShowRelationship(v1b, v1a);
   }

   private static void ShowRelationship(Version v1, Version v2)
   {
      Console.WriteLine("Relationship of {0} to {1}: {2}", 
                        v1, v2, (VersionTime) v1.CompareTo(v2));       
   }
}
// The example displays the following output:
//       Relationship of 1.1 to 1.1.0: Earlier
//       Relationship of 1.1.0.0 to 1.1.0: Later


L'exemple suivant utilise l'attribut AssemblyVersionAttribute pour assigner un numéro de version à un assembly. Au moment de la compilation, ces informations de version sont stockées avec les métadonnées de l'assembly. Au moment de l'exécution, l'exemple utilise la méthode Assembly.GetExecutingAssembly pour obtenir une référence pour l'assembly exécutable, et il extrait les informations de version de l'assembly de la propriété Version de l'objet AssemblyName retourné par la méthode Assembly.GetName.


using System;
using System.Reflection;

[assembly:AssemblyVersionAttribute("2.0.1")]

public class Example1
{
   public static void Main()
   {
      Assembly thisAssem = Assembly.GetExecutingAssembly();
      AssemblyName thisAssemName = thisAssem.GetName();

      Version ver = thisAssemName.Version;

      Console.WriteLine("This is version {0} of {1}.", ver, thisAssemName.Name);    
   }
}
// The example displays the following output:
//        This is version 2.0.1.0 of Example1.


.NET Framework

Pris en charge dans : 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

Bibliothèque de classes portable

Pris en charge dans : Bibliothèque de classes portable

.NET pour les applications du Windows Store

Pris en charge dans : Windows 8

.NET pour les applications Windows Phone

Pris en charge dans : Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

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

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.

Ajouts de la communauté

AJOUTER
Afficher:
© 2015 Microsoft