Version Klasse
TOC
Inhaltsverzeichnis reduzieren
Inhaltsverzeichnis erweitern
Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

Version-Klasse

 

Stellt die Versionsnummer einer Assembly, eines Betriebssystems oder der Common Language Runtime dar. Diese Klasse kann nicht vererbt werden.

Namespace:   System
Assembly:  mscorlib (in mscorlib.dll)


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

NameBeschreibung
System_CAPS_pubmethodVersion()

Initialisiert eine neue Instanz der Version-Klasse.

System_CAPS_pubmethodVersion(Int32, Int32)

Initialisiert eine neue Instanz der Version -Klasse mit den angegebenen Werten für Haupt- und Nebenversionen.

System_CAPS_pubmethodVersion(Int32, Int32, Int32)

Initialisiert eine neue Instanz der Version -Klasse unter Verwendung der angegebenen Haupt-und Nebenversion und Werte zu erstellen.

System_CAPS_pubmethodVersion(Int32, Int32, Int32, Int32)

Initialisiert eine neue Instanz der Version -Klasse mit den angegebenen Hauptversions-, Nebenversions-, Build- und Revisionsnummern.

System_CAPS_pubmethodVersion(String)

Initialisiert eine neue Instanz der Version-Klasse unter Verwendung der angegebenen Zeichenfolge.

NameBeschreibung
System_CAPS_pubpropertyBuild

Ruft den Wert der Buildkomponente der Versionsnummer für das aktuelle Version Objekt.

System_CAPS_pubpropertyMajor

Ruft den Wert der Hauptkomponente der Versionsnummer für das aktuelle Version Objekt.

System_CAPS_pubpropertyMajorRevision

Ruft die oberen 16 Bits der Revisionsnummer ab.

System_CAPS_pubpropertyMinor

Ruft den Wert der Nebenkomponente der Versionsnummer für das aktuelle Version Objekt.

System_CAPS_pubpropertyMinorRevision

Ruft die unteren 16 Bits der Revisionsnummer ab.

System_CAPS_pubpropertyRevision

Ruft den Wert der Revisionskomponente der Versionsnummer für das aktuelle Version Objekt.

NameBeschreibung
System_CAPS_pubmethodClone()

Gibt ein neues Version -Objekt, dessen Wert identisch mit der aktuellen ist Version Objekt.

System_CAPS_pubmethodCompareTo(Object)

Vergleicht das aktuelle Version Objekt mit einem angegebenen Objekt und gibt eine Angabe über das Verhältnis der entsprechenden Werte zurück.

System_CAPS_pubmethodCompareTo(Version)

Vergleicht das aktuelle Version -Objekt mit einem angegebenen Version -Objekt und gibt eine Angabe über das Verhältnis der entsprechenden Werte zurück.

System_CAPS_pubmethodEquals(Object)

Gibt einen Wert, der angibt, ob die aktuelle Version -Objekt gleich einem angegebenen Objekt ist.(Setzt "Object.Equals(Object)" außer Kraft.)

System_CAPS_pubmethodEquals(Version)

Gibt einen Wert, der angibt, ob die aktuelle Version -Objekt und ein angegebenes Version -Objekt denselben Wert darstellen.

System_CAPS_pubmethodGetHashCode()

Gibt einen Hashcode für die aktuelle Version Objekt.(Setzt "Object.GetHashCode()" außer Kraft.)

System_CAPS_pubmethodGetType()

Ruft den Type der aktuellen Instanz ab.(Geerbt von Object.)

System_CAPS_pubmethodSystem_CAPS_staticParse(String)

Konvertiert die Zeichenfolgendarstellung einer Versionsnummer in ein entsprechendes Version Objekt.

System_CAPS_pubmethodToString()

Konvertiert den Wert des aktuellen Version -Objekts in die entsprechende String Darstellung.(Setzt "Object.ToString()" außer Kraft.)

System_CAPS_pubmethodToString(Int32)

Konvertiert den Wert des aktuellen Version -Objekts in die entsprechende String Darstellung. Eine angegebene Anzahl bezieht sich auf die Anzahl der zurückzugebenden Komponenten.

System_CAPS_pubmethodSystem_CAPS_staticTryParse(String, Version)

Versucht, die Zeichenfolgendarstellung einer Versionsnummer in ein entsprechendes konvertieren Version -Objekt und gibt einen Wert, der angibt, ob die Konvertierung erfolgreich war.

NameBeschreibung
System_CAPS_puboperatorSystem_CAPS_staticEquality(Version, Version)

Bestimmt, ob zwei Version-Objekte gleich sind.

System_CAPS_puboperatorSystem_CAPS_staticGreaterThan(Version, Version)

Bestimmt, ob das erste angegebene Version Objekt ist größer als das zweite angegebene Version Objekt.

System_CAPS_puboperatorSystem_CAPS_staticGreaterThanOrEqual(Version, Version)

Bestimmt, ob das erste angegebene Version Objekt ist größer als oder gleich dem zweiten angegebenen Version Objekt.

System_CAPS_puboperatorSystem_CAPS_staticInequality(Version, Version)

Bestimmt, ob zwei angegebene Version-Objekte ungleich sind.

System_CAPS_puboperatorSystem_CAPS_staticLessThan(Version, Version)

Bestimmt, ob das erste angegebene Version Objekt ist kleiner als das zweite angegebene Version Objekt.

System_CAPS_puboperatorSystem_CAPS_staticLessThanOrEqual(Version, Version)

Bestimmt, ob das erste angegebene Version Objekt ist kleiner als oder gleich dem zweiten Version Objekt.

Versionsnummern bestehen aus zwei bis vier Komponenten: Hauptversion, Nebenversion, Build und Revision. Die Haupt- und Nebenversionsnummern Komponenten sind erforderlich. die Komponenten Build und Revision sind optional, aber die Buildkomponente ist erforderlich, wenn die Revisionskomponente definiert ist. Alle definierte Komponenten müssen ganze Zahlen größer oder gleich 0 sein. Das Format der Versionsnummer lautet wie folgt (optionale Komponenten werden angezeigt, in eckigen Klammern ([und]):

major.minor[.build[.Revision]]

Die Komponenten werden gemäß der Konvention wie folgt verwendet:

  • Wichtigsten: Assemblys mit demselben Namen, aber unterschiedlichen Hauptversionen sind nicht austauschbar. Eine höhere Versionsnummer möglicherweise eine umfassende Überarbeitung eines Produkts, in dem Abwärtskompatibilität angenommen werden kann.

  • Kleinere: Wenn der Name und die Hauptversionsnummer für zwei Assemblys identisch sind, aber die Nebenversionsnummer unterscheidet, bedeutet dies, wesentliche Verbesserung bei geplanter Abwärtskompatibilität. Diese höhere Nebenversionsnummer könnte eine Point Release eines Produkts oder eine vollständig abwärtskompatible neue Version eines Produkts anzugeben.

  • Erstellen: eine unterschiedliche Buildnummer verweist auf eine Neukompilierung desselben Quellcodes. Andere Buildnummern können verwendet werden, wenn sich der Prozessor, der Plattform oder der Compiler ändert.

  • Revision: Assemblys mit dem gleichen Namen, Haupt-und Nebenversionsnummern aber unterschiedlichen Revisionen sollen vollständig austauschbar sein. Eine höhere Revisionsnummer könnte in einem Build verwendet werden, die eine in einer zuvor veröffentlichten Assembly Sicherheitslücke.

Nachfolgende Versionen einer Assembly, die nur durch Build-oder Revisionsnummer unterscheiden, gelten als Hotfix-Updates der früheren Version.

System_CAPS_importantWichtig

Der Wert der Version Eigenschaften, die nicht explizit ein Wert zugewiesen wurde, ist nicht definiert (-1).

Ab .NET Framework 2.0 die MajorRevision und MinorRevision Eigenschaften ermöglichen Ihnen, eine temporäre Version Ihrer Anwendung zu identifizieren, z. B. ein Problem beheben, bis Sie eine dauerhafte Lösung erhältlich,. Darüber hinaus das Betriebssystem Windows NT verwendet die MajorRevision Eigenschaft, um die Nummer des Service Packs zu codieren.

Normalerweise die Version Klasse wird nicht verwendet, um eine Versionsnummer einer Assembly zuordnen. In diesem Fall die AssemblyVersionAttribute -Klasse wird zum definieren, die Version einer Assembly, wie im Beispiel in diesem Thema dargestellt.

Version Objekte werden am häufigsten verwendet, um Versionsinformationen über einige System- oder Anwendungskomponente (z. B. das Betriebssystem), die common Language Runtime, ausführbare Datei der aktuellen Anwendung oder einer bestimmten Assembly zu speichern. Die folgenden Beispiele veranschaulichen einige der häufigsten Szenarios:

  • Abrufen der Betriebssystemversion. Im folgenden Beispiel wird die OperatingSystem.Version Eigenschaft, um die Versionsnummer des Betriebssystems abzurufen.

    // 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, um Informationen über die common Language Runtime Version abzurufen.

    // Get the common language runtime version.
    Version ver = Environment.Version;
    Console.WriteLine("CLR Version {0}", ver.ToString());
    
  • Abrufen der aktuellen Anwendung Assembly-Version. Im folgenden Beispiel wird die Assembly.GetEntryAssembly -Methode zum Abrufen eines Verweises auf ein Assembly Objekt, das ausführbare Datei der Anwendung darstellt, und ruft dann die Versionsnummer der Assembly ab.

    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 Assembly Assemblyversion. Im folgenden Beispiel wird die Type.Assembly Eigenschaft zum Abrufen eines Verweises auf ein Assembly -Objekt, das die Assembly darstellt, die den Einstiegspunkt der Anwendung enthält und anschließend die Versionsinformationen abgerufen.

    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());
       }
    }
    
  • Abrufen der Version einer bestimmten Assembly. Im folgenden Beispiel wird die Assembly.ReflectionOnlyLoadFrom -Methode zum Abrufen eines Verweises auf ein Assembly -Objekt, das über einen bestimmten Dateinamen verfügt, und klicken Sie dann ihre Versionsinformationen abgerufen. Beachten Sie, dass mehrere andere Methoden auch vorhanden, zum Instanziieren sind einer Assembly Objekt nach dem Dateinamen oder mit einem starken Namen.

    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 Version Veröffentlichen einer ClickOnce-Anwendung. Im folgenden Beispiel wird die ApplicationDeployment.CurrentVersion Eigenschaft, um einer Anwendungsverzeichnis Veröffentlichungsversion anzuzeigen. Beachten Sie, dass die erfolgreiche Ausführung des Beispiels Anwendungsidentität festgelegt werden muss. Dies erfolgt automatisch über Visual Studio Veröffentlichen-Assistenten.

    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_importantWichtig

    Die Version Veröffentlichen einer Anwendung für die ClickOnce-Bereitstellung ist vollständig unabhängig von der Version der Assembly.

Können Sie die CompareTo Methode, um zu bestimmen, ob ein Version -Objekt liegt vor, gleich, oder später als ein zweites Version Objekt. Das folgende Beispiel gibt an, dass Version 2.1 höher als 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.

Für zwei Versionen gleich, die Haupt-, neben-, build, und die Revisionsnummer des ersten Version Objekt muss identisch mit denen der zweiten Version Objekt. Wenn die Build- oder Revisionsnummer Anzahl der ein Version Objekt nicht definiert ist, Version Objekt gilt als älter als ein Version Objekt, deren Build- oder Revisionsnummer gleich NULL ist. Das folgende Beispiel veranschaulicht dies durch Vergleichen der drei Version Objekte, 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

Im folgenden Beispiel wird die AssemblyVersionAttribute Attribut einer Assembly eine Versionsnummer zugewiesen. Zum Zeitpunkt der Kompilierung wird diese Versionsinformationen mit den Metadaten der Assembly gespeichert. Zur Laufzeit ruft das Beispiel den Wert des der Type.Assembly Eigenschaft für einen Typ in der Assembly, die einen Verweis auf die derzeit ausgeführte Assembly gefunden, und die Assembly Versionsinformationen abgerufen die Version Eigenschaft der AssemblyName zurückgegebene Objekt die Assembly.GetName Methode.

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.

Universal Windows Platform
Verfügbar seit 8
.NET Framework
Verfügbar seit 1.1
Portable Class Library
Unterstützt in: portable .NET platforms
Silverlight
Verfügbar seit 2.0
Windows Phone Silverlight
Verfügbar seit 7.0
Windows Phone
Verfügbar seit 8.1

Öffentliche statische (in Visual Basic freigegebene) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Zurück zum Anfang
Anzeigen:
© 2016 Microsoft