Version-Klasse

Normalerweise wird die Version-Klasse nicht verwendet, um einer Assembly eine Versionsnummer zuzuweisen. Stattdessen wird die AssemblyVersionAttribute-Klasse verwendet, um die Version einer Assembly zu definieren, wie vom Beispiel in diesem Thema illustriert.

Version -Objekte werden am häufigsten verwendet, um Versionsinformationen einer System- oder Anwendungskomponente (z. B. das Betriebssystem), der Common Language Runtime, der ausführbaren Datei der aktuellen Anwendung oder einer bestimmten Assembly zu speichern. In den folgenden Beispielen werden einige der häufigsten Szenarios veranschaulicht:

• Abrufen der Betriebssystemversion. Im folgenden Beispiel wird mit der OperatingSystem.Version-Eigenschaft die Versionsnummer des Betriebssystems abgerufen.

  C#

  VB

  Kopieren

  
  // Get the operating system version.
  OperatingSystem os = Environment.OSVersion;
  Version ver = os.Version;
  Console.WriteLine("Operating System: {0} ({1})", os.VersionString, ver.ToString());
  
  
  

• Abrufen der Version der Common Language Runtime. Im folgenden Beispiel wird die Environment.Version-Eigenschaft verwendet, um Versionsinformationen über die Common Language Runtime abzurufen.

  C#

  VB

  Kopieren

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

• Abrufen der aktuellen Assemblyversion der Anwendung. Im folgenden Beispiel wird die Assembly.GetEntryAssembly-Methode, um ein Verweis auf ein Assembly-Objekt, das die ausführbare Datei der Anwendung darstellt und dann ihre Assemblyversionsnummer abruft.

  C#

  VB

  Kopieren

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

• Abrufen der aktuellen Version der Assembly. Im folgenden Beispiel wird die Assembly.GetExecutingAssembly-Methode verwendet, um einen Verweis auf ein Assembly-Objekt abzurufen, das die aktuelle Assembly darstellt, und anschließend werden ihre Versionsinformationen abgerufen.

  C#

  VB

  Kopieren

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

• Abrufen der Version einer bestimmten Assembly. Im folgenden Beispiel wird die Assembly.ReflectionOnlyLoadFrom-Methode verwendet, um einen Verweis auf ein Assembly-Objekt abzurufen, das über einen bestimmten Dateinamen verfügt, und anschließend werden seine Versionsinformationen abgerufen. Beachten Sie, dass auch mehrere andere Methoden vorhanden sind, um ein Assembly-Objekt nach Dateinamen oder starkem Namen zu instanziieren.

  C#

  VB

  Kopieren

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

• Abrufen der Veröffentlichungsversion einer ClickOnce-Anwendung. Im folgenden Beispiel wird die - Eigenschaft ApplicationDeployment.CurrentVersion, um einer Anwendung anzeigen veröffentlichen Version. Beachten Sie, dass die erfolgreiche Ausführung erfordert, dass die Anwendung des Beispiels wird festgelegt identifizieren. Dies wird automatisch vom Visual Studio-Veröffentlichungs-Assistenten behandelt.

  C#

  VB

  Kopieren

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

  Wichtig
  Die Veröffentlichungsversion einer Anwendung für die ClickOnce-Bereitstellung wurde aus der Assemblyversion vollkommen unabhängig.

Sie können die CompareTo-Methode verwenden, um zu ermitteln, ob ein Version-Objekt früher oder später als ein zweites oder gleich einem zweiten Version-Objekt ist. Das folgende Beispiel gibt an, dass Version 2.1 höher als Version 2.0 ist.

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.

Damit zwei Versionen gleich sind, müssen die Haupt-, Neben-, Build- und Revisionsnummern des ersten Version-Objekts mit jenen des zweiten Version-Objekts identisch sein. Wenn die Build- oder der Revisionsnummer eines Version-Objekts nicht definiert ist, wird von diesem Version-Objekt angenommen, dass es vor einem Version-Objekt liegt, deren Build- oder Revisionsnummer gleich 0 (null) ist. Im folgenden Beispiel wird dies veranschaulicht, indem drei Version-Objekte verglichen werden, die undefinierte Versionskomponenten besitzen.

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