AssemblyVersionAttribute-Klasse

Artikel
08/20/2007

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

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

Syntax

'Declaration
<ComVisibleAttribute(True)> _
<AttributeUsageAttribute(AttributeTargets.Assembly, Inherited:=False)> _
Public NotInheritable Class AssemblyVersionAttribute
    Inherits Attribute
'Usage
Dim instance As AssemblyVersionAttribute

[ComVisibleAttribute(true)] 
[AttributeUsageAttribute(AttributeTargets.Assembly, Inherited=false)] 
public sealed class AssemblyVersionAttribute : Attribute

[ComVisibleAttribute(true)] 
[AttributeUsageAttribute(AttributeTargets::Assembly, Inherited=false)] 
public ref class AssemblyVersionAttribute sealed : public Attribute

/** @attribute ComVisibleAttribute(true) */ 
/** @attribute AttributeUsageAttribute(AttributeTargets.Assembly, Inherited=false) */ 
public final class AssemblyVersionAttribute extends Attribute

ComVisibleAttribute(true) 
AttributeUsageAttribute(AttributeTargets.Assembly, Inherited=false) 
public final class AssemblyVersionAttribute extends Attribute

Hinweise

Die Assemblyversionsnummer ist Bestandteil der Identität einer Assembly und für das Binden der Assembly sowie für die Versionsrichtlinien von großer Bedeutung. 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 Übersicht über Assemblys.

Hinweis

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

Die Versionsnummer besteht aus den folgenden vier folgenden Bestandteilen:

Sie können alle genannten Werte angeben, oder Sie übernehmen die Standardwerte für Buildnummer und/oder Revisionsnummer, indem Sie ein Sternchen (*) eingeben. Die Versionsnummer [assembly:AssemblyVersion("2.3.25.1")] weist z. B. 2 als Hauptversion, 3 als Nebenversion, 25 als Buildnummer und 1 als Revisionsnummer aus. Die Versionsnummer [assembly:AssemblyVersion("1.2.*")] weist 1 als Hauptversion und 2 als Nebenversion aus, und die Standardwerte für Build- und Revisionsnummer werden übernommen. Die Versionsnummer [assembly:AssemblyVersion("1.2.15.*")] weist 1 als Hauptversion, 2 als Nebenversion und 15 als Buildnummer aus, und die Standardrevisionsnummer wird übernommen. Die Standardbuildnummer wird täglich erhöht. Die Standardrevisionsnummer wird zufällig vergeben.

Hinweis

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

Die Haupt- und Nebenversionen der Assembly werden beim Exportieren der Assembly als Versionsnummer für Typbibliotheken verwendet. Einige COM-Hosts akzeptieren keine Typbibliotheken mit der Versionsnummer 0.0. Um eine Assembly für COM-Clients verfügbar zu machen, müssen Sie deshalb auf der AssemblyVersionAttribute-Seite für außerhalb von Visual Studio 2005 erstellte Projekte ausdrücklich 1.0 als Assemblyversion festlegen und dürfen kein AssemblyVersionAttribute angeben. Dies gilt auch, wenn die Assemblyversion 0.0 lautet. Bei allen in Visual Studio 2005 erstellten Projekten wird für die Assemblyversion der Standardwert 1.0* verwendet.

Wenn Sie den Namen einer geladenen Assembly abrufen möchten, rufen Sie GetName für die Assembly auf, um einen AssemblyName zu erhalten, und rufen Sie dann die Version-Eigenschaft ab. Um den Namen einer nicht geladenen Assembly zu ermitteln, rufen Sie in der Clientanwendung GetAssemblyName auf, um die von der Anwendung verwendete Assemblyversion zu überprüfen.

Vererbungshierarchie

System.Object
System.Attribute
System.Reflection.AssemblyVersionAttribute

Threadsicherheit

Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

AssemblyVersionAttribute-Member
System.Reflection-Namespace
AssemblyName.Version-Eigenschaft

Weitere Ressourcen

Festlegen von Assemblyattributen
Metadaten und selbstbeschreibende Komponenten
Kompilieren in MSIL
Metadatenübersicht
Übersicht über Assemblys

Freigeben über