Version, classe

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.

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.

  C#

  VB

  Copier

  
  // 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.

  C#

  VB

  Copier

  
  // Get the common language runtime version.
  Version ver = Environment.Version;
  Console.WriteLine("CLR Version {0}", ver.ToString());
  
  
  

• Récupération de la version de l'application active. 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 de l'application puis récupère son numéro de version.

  C#

  VB

  Copier

  
  // 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 de l'assembly actif. 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.

  C#

  VB

  Copier

  
  // Get the version of the current application.
  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.

  C#

  VB

  Copier

  
  // 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());
  
  
  

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