Verwenden der Attribute "AssemblyVersion" und "AssemblyFileVersion"

  • Artikel
  • 2 Minuten Lesedauer

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

Originalversion des Produkts:   .NET Framework
Ursprüngliche KB-Nummer:   556041

Zusammenfassung

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

Microsoft .NET Framework bietet die Möglichkeit, zwei verschiedene Arten von Versionsnummern für jede Assembly festzulegen.

Assemblyversion

Es ist die Versionsnummer, die vom 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, wird diese Versionsnummer eingebettet. 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, Token für öffentliche Schlüssel 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

Dies ist die Versionsnummer, die der Datei wie im Dateisystem zugewiesen wurde. Sie wird von Windows Explorer angezeigt und niemals von .NET Framework oder Runtime für Verweise 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 jedes Mal, wenn Sie erstellen, um eins.

Angenommen, Sie erstellen eine Frameworkassembly für Ihr Projekt, die von vielen Entwicklern beim Erstellen der Anwendungsassemblys verwendet wird. Wenn Sie häufig eine neue Version der Assembly veröffentlichen, z. B. einmal täglich, und Assemblys mit starkem Namen benannt sind, müssen Entwickler den Verweis jedes Mal ändern, wenn Sie eine neue Assembly veröffentlichen. Es kann umständlich sein und auch zu falschen Verweisen führen. Eine bessere Option in solchen geschlossenen Gruppen und volatilen Szenarien wäre es, nur die AssemblyVersion zu beheben und zu ändern AssemblyFileVersion. Verwenden Sie die Versionsnummer der Assemblydatei, um die neueste Version der Assembly 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 Release-Builds ist es sinnvoller, die AssemblyVersion Assemblyversion zu ändern und die AssemblyFileVersion meisten davon unverändert zu halten.