AssemblyVersionAttribute Klasse

Referenz

Definition

Namespace:: System.Reflection

Assembly:: System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Gibt die Version der Assembly an, die gerade mit Attributen versehen wird.

public ref class AssemblyVersionAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Assembly, Inherited=false)]
public sealed class AssemblyVersionAttribute : Attribute

[System.AttributeUsage(System.AttributeTargets.Assembly, AllowMultiple=false)]
public sealed class AssemblyVersionAttribute : Attribute

[System.AttributeUsage(System.AttributeTargets.Assembly, Inherited=false)]
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class AssemblyVersionAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Assembly, Inherited=false)>]
type AssemblyVersionAttribute = class
    inherit Attribute

[<System.AttributeUsage(System.AttributeTargets.Assembly, AllowMultiple=false)>]
type AssemblyVersionAttribute = class
    inherit Attribute

[<System.AttributeUsage(System.AttributeTargets.Assembly, Inherited=false)>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type AssemblyVersionAttribute = class
    inherit Attribute

Public NotInheritable Class AssemblyVersionAttribute
Inherits Attribute

Vererbung: Object

Attribute
AssemblyVersionAttribute

Attribute: AttributeUsageAttribute ComVisibleAttribute

Beispiele

Im folgenden Beispiel wird das AssemblyVersionAttribute Attribut verwendet, um einer Assembly eine Versionsnummer zuzuweisen. Zur Kompilierungszeit werden diese Versionsinformationen mit den Metadaten der Assembly gespeichert. Zur Laufzeit ruft das Beispiel den Wert der Type.Assembly Eigenschaft für einen Typ ab, der in der Assembly gefunden wurde, um einen Verweis auf die ausgeführte Assembly abzurufen, und es ruft die Versionsinformationen der Assembly aus der Version Eigenschaft des Objekts ab, das AssemblyName von der Assembly.GetName Methode zurückgegeben wird.

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.

Imports System.Reflection

<Assembly:AssemblyVersionAttribute("2.0.1")>
Module Example1
   Public Sub Main()
       Dim thisAssem As Assembly = GetType(Example1).Assembly
       Dim thisAssemName As AssemblyName = thisAssem.GetName()
       
       Dim ver As Version = thisAssemName.Version
       
       Console.WriteLine("This is version {0} of {1}.", ver, thisAssemName.Name)    
   End Sub
End Module
' The example displays the following output:
'      This is version 2.0.1.0 of Example1.

Hinweise

Das AssemblyVersionAttribute Attribut wird verwendet, um einer Assembly eine Versionsnummer zuzuweisen. Diese Versionsnummer wird dann mit den Metadaten der Assembly gespeichert.

Die Assemblyversionsnummer ist Teil der Identität einer Assembly und spielt einen wichtigen Bestandteil der Bindung an die Assembly und in der Versionsrichtlinie. Der Standardversionsrichtlinie für die Laufzeit zufolge werden Anwendungen nur in der Version ausgeführt, in der sie erstellt und getestet wurden, sofern dies nicht durch eine explizite Versionsrichtlinie in den Konfigurationsdateien (die Anwendungskonfigurationsdatei, die Herausgeberrichtliniendatei und die Administratorkonfigurationsdatei für den Computer) überschrieben wird. Weitere Informationen finden Sie unter Assemblys in .NET .

Hinweis

Die Version wird nur bei Assemblys mit starkem Namen überprüft.

Die Versionsnummer weist vier Teile auf:

Wichtig

Alle Komponenten der Version müssen ganze Zahlen größer oder gleich 0 sein. Metadaten beschränken die Haupt-, Neben-, Build- und Revisionskomponenten für eine Assembly auf einen Maximalwert von UInt16.MaxValue - 1. Wenn eine Komponente diesen Wert überschreitet, tritt ein Kompilierungsfehler auf.

Sie können alle Werte angeben oder die Standardbuildnummer, die Revisionsnummer oder beides mithilfe eines Sternchens (*) akzeptieren. Gibt beispielsweise [assembly:AssemblyVersion("2.3.25.1")] 2 als Hauptversion an, 3 als Nebenversion, 25 als Buildnummer und 1 als Revisionsnummer. Eine Versionsnummer, z [assembly:AssemblyVersion("1.2.*")] . B. 1 als Hauptversion, 2 als Nebenversion, und akzeptiert die Standardbuild- und Revisionsnummern. Eine Versionsnummer, z [assembly:AssemblyVersion("1.2.15.*")] . B. gibt 1 als Hauptversion an, 2 als Nebenversion, 15 als Buildnummer und akzeptiert die Standardversionsnummer. Die Standardbuildnummer erhöht täglich. Die Standardrevisionsnummer ist die Anzahl von Sekunden seit Mitternacht ortszeit (ohne Berücksichtigung von Zeitzonenanpassungen für Sommerzeit), dividiert durch 2.

Hinweis

Wenn Sie ein Sternchen für die Buildnummer angeben, können Sie keine Revisionsnummer angeben.

Die Haupt- und Nebenversionen der Assembly werden als Versionsnummer der Typbibliothek verwendet, wenn die Assembly exportiert wird. Einige COM-Hosts akzeptieren keine Typbibliotheken mit der Versionsnummer 0.0. Wenn Sie daher eine Assembly für COM-Clients verfügbar machen möchten, legen Sie die Assemblyversion explizit auf 1.0 auf der Seite für Projekte fest, die AssemblyVersionAttribute außerhalb Visual Studio 2005 erstellt wurden, und ohne AssemblyVersionAttribute Angabe. Führen Sie dies auch dann aus, wenn die Assemblyversion 0.0 ist. Alle in Visual Studio 2005 erstellten Projekte verfügen über eine Standardassemblyversion von 1.0.*.

Um den Namen einer Assembly abzurufen, die Sie geladen haben, rufen Sie GetName die Assembly auf, um eine AssemblyName, und rufen Sie dann die Version Eigenschaft ab. Um den Namen einer Assembly abzurufen, die Sie nicht geladen haben, rufen Sie von Ihrer Clientanwendung auf GetAssemblyName , um die Von Ihrer Anwendung verwendete Assemblyversion zu überprüfen.

Das AssemblyVersionAttribute Attribut kann nur einmal angewendet werden. Einige Visual Studio Projektvorlagen enthalten bereits das Attribut. Bei diesen Projekten verursacht das Hinzufügen des Attributs im Code einen Compilerfehler.

Konstruktoren

AssemblyVersionAttribute(String)

Initialisiert eine neue Instanz der AssemblyVersionAttribute-Klasse mit der Versionsnummer der Assembly, die mit Attributen versehen wird.

Eigenschaften

TypeId	Ruft bei Implementierung in einer abgeleiteten Klasse einen eindeutigen Bezeichner für dieses Attribute ab. (Geerbt von Attribute)
Version	Ruft die Versionsnummer der mit Attributen versehenen Assembly ab.

Methoden

Equals(Object)	Gibt einen Wert zurück, der angibt, ob diese Instanz gleich einem angegebenen Objekt ist. (Geerbt von Attribute)
GetHashCode()	Gibt den Hashcode für diese Instanz zurück. (Geerbt von Attribute)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
IsDefaultAttribute()	Gibt beim Überschreiben in einer abgeleiteten Klasse an, ob der Wert der Instanz der Standardwert für die abgeleitete Klasse ist. (Geerbt von Attribute)
Match(Object)	Beim Überschreiben in einer abgeleiteten Klasse wird ein Wert zurückgegeben, der angibt, ob diese Instanz einem bestimmten Objekt entspricht. (Geerbt von Attribute)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Explizite Schnittstellenimplementierungen

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Ordnet eine Reihe von Namen einer entsprechenden Reihe von Dispatchbezeichnern zu. (Geerbt von Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Ruft die Typinformationen für ein Objekt ab, mit deren Hilfe die Typinformationen für eine Schnittstelle abgerufen werden können. (Geerbt von Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Ruft die Anzahl der Schnittstellen mit Typinformationen ab, die von einem Objekt bereitgestellt werden (0 oder 1). (Geerbt von Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Stellt den Zugriff auf von einem Objekt verfügbar gemachte Eigenschaften und Methoden bereit. (Geerbt von Attribute)

Gilt für