Verwenden von AssemblyVersion- und AssemblyFileVersion-Attributen

In diesem Artikel wird die Verwendung AssemblyVersion und AssemblyFileVersion Attribute in der AssemblyInfo.cs-Datei erläutert.

Originalproduktversion: .NET Framework
Ursprüngliche KB-Nummer: 556041

Zusammenfassung

AssemblyInfo.cs stellt zwei Attribute bereit, um zwei verschiedene Versionstypen festzulegen. Dieser Tipp zeigt, wie diese beiden Attribute verwendet werden.

Microsoft .NET Framework bietet die Möglichkeit, zwei verschiedene Typen von Versionsnummern auf jede Assembly festzulegen.

AssemblyVersion

Es ist die Versionsnummer, die von Framework während des Builds und zur Laufzeit verwendet wird, um die Assemblys zu suchen, zu verknüpfen und zu laden. Wenn Sie einen Verweis auf eine beliebige Assembly in Ihrem Projekt hinzufügen, handelt es sich um diese Versionsnummer, die eingebettet wird. Zur Laufzeit sucht Common Language Runtime (CLR) nach Assembly mit dieser Versionsnummer, die geladen werden soll. Denken Sie jedoch daran, dass diese Version zusammen mit Namen, Öffentlichen Schlüsseltoken und Kulturinformationen nur verwendet wird, wenn die Assemblys mit starkem Namen signiert sind. Wenn Assemblys nicht mit starkem Namen signiert sind, werden nur Dateinamen zum Laden verwendet.

AssemblyFileVersion

Es ist die Versionsnummer, die für die Datei angegeben ist, wie im Dateisystem. Sie wird vom Windows-Explorer angezeigt und wird nie von .NET Framework oder Laufzeit zum Verweisen verwendet.

Attribute in AssemblyInfo.cs

// Version information for an assembly consists of the following four values:
// Major Version
// Minor Version
// Build Number
// Revision
[assembly: AssemblyVersion("1.0.0.0")]  
[assembly: AssemblyFileVersion("1.0.0.0")]

Wenn Sie ein (*) anstelle der absoluten Zahl angeben, erhöht der Compiler die Zahl bei jedem Erstellen um eins.

Angenommen, Sie erstellen eine Frameworkassembly für Ihr Projekt, die von vielen Entwicklern beim Erstellen der Anwendungsassemblys verwendet wird. Wenn Sie eine neue Assemblyversion häufig freigeben, sagen Sie einmal täglich, und wenn Assemblys stark benannt sind, müssen Entwickler den Verweis jedes Mal ändern, wenn Sie neue Assembly freigeben. Es kann umständlich sein und kann auch zu falschen Verweisen führen. Eine bessere Option in solchen geschlossenen Gruppen- und veränderliche Szenarien wäre das AssemblyVersion Beheben und Ändern nur der AssemblyFileVersion. Verwenden Sie die Versionsnummer der Assemblydatei, um die neueste Assemblyversion zu kommunizieren. In diesem Fall müssen Entwickler die Verweise nicht ändern und können die Assembly im Referenzpfad überschreiben. In zentralen oder endgültigen Releasebuilds ist es sinnvoller, die AssemblyVersion Assemblyversion zu ändern und am meisten gleich AssemblyFileVersion zu halten.