Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

Version classe

 

Date de publication : novembre 2016

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>

NomDescription
System_CAPS_pubmethodVersion()

Initialise une nouvelle instance de la classe Version.

System_CAPS_pubmethodVersion(Int32, Int32)

Initialise une nouvelle instance de la Version classe les valeurs major et minor spécifiées.

System_CAPS_pubmethodVersion(Int32, Int32, Int32)

Initialise une nouvelle instance de la Version classe spécifié major, minor et générer des valeurs.

System_CAPS_pubmethodVersion(Int32, Int32, Int32, Int32)

Initialise une nouvelle instance de la Version classe avec spécifié major, minor, build et le numéro de révision.

System_CAPS_pubmethodVersion(String)

Initialise une nouvelle instance de la classe Version à l'aide de la chaîne spécifiée.

NomDescription
System_CAPS_pubpropertyBuild

Obtient la valeur du composant build du numéro de version pour le Version objet.

System_CAPS_pubpropertyMajor

Obtient la valeur du composant principal du numéro de version pour le Version objet.

System_CAPS_pubpropertyMajorRevision

Obtient les 16 bits de poids fort du numéro de révision.

System_CAPS_pubpropertyMinor

Obtient la valeur du composant secondaire du numéro de version pour le Version objet.

System_CAPS_pubpropertyMinorRevision

Obtient les 16 bits de poids faible du numéro de révision.

System_CAPS_pubpropertyRevision

Obtient la valeur du composant révision du numéro de version pour le Version objet.

NomDescription
System_CAPS_pubmethodClone()

Retourne un nouveau Version objet dont la valeur est le même que l’actuel Version objet.

System_CAPS_pubmethodCompareTo(Object)

Compare l’actuel Version objet à un objet spécifié et retourne une indication de leurs valeurs relatives.

System_CAPS_pubmethodCompareTo(Version)

Compare l’actuel Version objet spécifié Version de l’objet et retourne une indication de leurs valeurs relatives.

System_CAPS_pubmethodEquals(Object)

Retourne une valeur indiquant si l’actuel Version objet est égal à un objet spécifié.(Remplace Object.Equals(Object).)

System_CAPS_pubmethodEquals(Version)

Retourne une valeur indiquant si l’actuel Version objet et une certaine Version objet représentent la même valeur.

System_CAPS_pubmethodGetHashCode()

Retourne un code de hachage pour actuel Version objet.(Remplace Object.GetHashCode().)

System_CAPS_pubmethodGetType()

Obtient le Type de l'instance actuelle.(Hérité de Object.)

System_CAPS_pubmethodSystem_CAPS_staticParse(String)

Convertit la représentation sous forme de chaîne d’un numéro de version en un équivalent Version objet.

System_CAPS_pubmethodToString()

Convertit la valeur de l’utilisateur actuel Version objet en son équivalent String représentation.(Remplace Object.ToString().)

System_CAPS_pubmethodToString(Int32)

Convertit la valeur de l’utilisateur actuel Version objet en son équivalent String représentation. Un nombre spécifié indique le nombre de composants à retourner.

System_CAPS_pubmethodSystem_CAPS_staticTryParse(String, Version)

Tente de convertir la représentation sous forme de chaîne d’un numéro de version en un équivalent Version de l’objet et retourne une valeur qui indique si la conversion a réussi.

NomDescription
System_CAPS_puboperatorSystem_CAPS_staticEquality(Version, Version)

Détermine si deux objets Version spécifiés sont identiques.

System_CAPS_puboperatorSystem_CAPS_staticGreaterThan(Version, Version)

Détermine si le premier spécifié Version objet est supérieur au second spécifié Version objet.

System_CAPS_puboperatorSystem_CAPS_staticGreaterThanOrEqual(Version, Version)

Détermine si le premier spécifié Version objet est supérieur ou égal au second spécifié Version objet.

System_CAPS_puboperatorSystem_CAPS_staticInequality(Version, Version)

Détermine si deux objets Version spécifiés ne sont pas identiques.

System_CAPS_puboperatorSystem_CAPS_staticLessThan(Version, Version)

Détermine si le premier spécifié Version objet est inférieur au second spécifié Version objet.

System_CAPS_puboperatorSystem_CAPS_staticLessThanOrEqual(Version, Version)

Détermine si le premier spécifié Version objet est inférieur ou égal au second Version objet.

Numéros de version comportent de deux à quatre composants : major, minor, build et révision. Les composants principaux et secondaires sont requis ; les composants build et révision sont facultatifs, mais le composant build est requis si le composant révision est défini. Tous les composants définis doivent être des entiers supérieurs ou égales à 0. Le format du numéro de version est la suivante (composants facultatifs sont affichés entre crochets ([et]) :

major.minor[.build[.révision]]

Les composants sont utilisés par convention, comme suit :

  • Principales: les assemblys portant le même nom mais différentes versions principales ne sont pas interchangeables. Un numéro de version supérieur peut indiquer une réécriture importante d’un produit dont la compatibilité descendante ne peut pas être assurée.

  • Secondaire: si le nom et le numéro de version principal de deux assemblys sont identiques, mais le numéro de version secondaire est différent, cela indique une amélioration significative dans le but de compatibilité descendante. Ce numéro de version secondaire supérieur peut indiquer une version ponctuelle d’un produit ou une nouvelle version de compatibilité descendante est totale d’un produit.

  • 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: avec les mêmes numéros de version, nom, principales et secondaires, mais 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 un assembly précédemment publiée.

Les versions suivantes d’un assembly qui ne diffèrent que par les numéros de build ou de révision sont considérés comme des mises à jour de correctif de la version antérieure.

System_CAPS_importantImportant

La valeur de Version propriétés non affectées explicitement une valeur est non défini (-1).

Démarrage avec .NET Framework 2.0, le MajorRevision et MinorRevision les propriétés vous permettent d’identifier une version temporaire de votre application qui, par exemple, résout un problème jusqu'à ce que vous pouvez diffuser une solution permanente. En outre, le système d’exploitation Windows NT utilise le MajorRevision propriété pour encoder le numéro du service pack.

En règle générale, la Version classe n’est pas utilisée pour assigner un numéro de version à un assembly. Au lieu de cela, la AssemblyVersionAttribute classe est utilisée pour définir la version d’un assembly, comme illustré dans l’exemple dans cette rubrique.

Version objets sont fréquemment utilisés pour stocker des informations de version sur un composant système ou d’application (par exemple, le système d’exploitation), le common language runtime, fichier exécutable de l’application actuelle ou un assembly particulier. Les exemples suivants illustrent certains des scénarios plus courants :

  • Récupération de la version de système d’exploitation. L’exemple suivant utilise le OperatingSystem.Version propriété à 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 du common language runtime. L’exemple suivant utilise le Environment.Version propriété à 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 version de l’assembly de l’application active. L’exemple suivant utilise le Assembly.GetEntryAssembly méthode pour obtenir une référence à un Assembly objet qui représente l’exécutable de l’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 version de l’assembly de l’assembly actuel. L’exemple suivant utilise le Type.Assembly propriété pour obtenir une référence à un Assembly objet qui représente l’assembly qui contient le point d’entrée de l’application, 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 = typeof(Example).Assembly;
          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 le Assembly.ReflectionOnlyLoadFrom méthode pour obtenir une référence à un Assembly objet qui a un nom de fichier particulier, puis récupère ses informations de version. Notez que plusieurs autres méthodes existent pour instancier un Assembly objet 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 le ApplicationDeployment.CurrentVersion propriété pour afficher la Version de publication d’une application. Notez que son exécution réussie requiert l’identité de l’application de l’exemple à définir. Ceci est géré automatiquement par l’Assistant de publication de Visual Studio.

    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);
       }
    }
    
    System_CAPS_importantImportant

    La Version de publication d’une application pour le déploiement ClickOnce est complètement indépendante de la version de l’assembly.

Vous pouvez utiliser la CompareTo pour déterminer si une méthode Version objet est antérieur, identique ou postérieur à un deuxième Version objet. 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 les deux versions soient égales, major, minor, build et le numéro de révision de la première Version objet doit être identique à ceux de la seconde Version objet. Si le numéro de build ou de révision d’un Version objet n’est pas défini, qui Version objet est considéré comme étant antérieure à une Version dont la génération de l’objet ou le numéro de révision est égal à zéro. L’exemple suivant illustre ce comportement en comparant trois Version les objets 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 le AssemblyVersionAttribute attribut pour affecter 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 récupère la valeur de la Type.Assembly propriété sur un type trouvé dans l’assembly pour obtenir une référence à l’assembly en cours d’exécution, et il récupère les informations de version de l’assembly à partir de la Version propriété de la AssemblyName objet retourné par la Assembly.GetName (méthode).

using System;
using System.Reflection;

[assembly:AssemblyVersionAttribute("2.0.1")]

public class Example1
{
   public static void Main()
   {
      Assembly thisAssem = typeof(Example1).Assembly;
      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.

Plateforme Windows universelle
Disponible depuis 8
.NET Framework
Disponible depuis 1.1
Bibliothèque de classes portable
Pris en charge dans : plateformes .NET portables
Silverlight
Disponible depuis 2.0
Silverlight pour Windows Phone
Disponible depuis 7.0
Windows Phone
Disponible depuis 8.1

Tous les membres statiques publics ( Shared en Visual Basic) de ce type sont thread-safe. Les membres d’instance n’ont pas la garantie d’être thread-safe.

Retour au début
Afficher: