Vom C#-Compiler interpretierte Attribute auf Assemblyebene

Die meisten Attribute gelten für bestimmte Sprachelemente wie Klassen oder Methoden. Einige Attribute sind jedoch global. Sie gelten für eine gesamte Assembly oder ein gesamtes Modul. Verwenden Sie z. B. das AssemblyVersionAttribute Attribut, um Versionsinformationen in eine Assembly einzubetten, z. B. wie folgt:

[assembly: AssemblyVersion("1.0.0.0")]

Globale Attribute werden im Quellcode nach allen using-Direktiven der obersten Ebene und vor Typ-, Modul- oder Namespacedeklarationen angezeigt. Sie können globale Attribute in mehrere Quelldateien einschließen, aber Sie müssen die Dateien in einem einzigen Kompilierungsdurchlauf kompilieren. In .NET Framework-Projekten fügt Visual Studio der AssemblyInfo.cs Datei globale Attribute hinzu. Diese Attribute werden nicht zu .NET Core-Projekten hinzugefügt.

Die C#-Sprachreferenz dokumentiert die zuletzt veröffentlichte Version der C#-Sprache. Außerdem enthält sie erste Dokumentation für Features in der öffentlichen Vorschau für die kommende Sprachversion.

In der Dokumentation werden alle Features identifiziert, die in den letzten drei Versionen der Sprache oder in der aktuellen öffentlichen Vorschau eingeführt wurden.

Tipp

Informationen dazu, wann ein Feature erstmals in C# eingeführt wurde, finden Sie im Artikel zum Versionsverlauf der C#-Sprache.

Assemblyattribute stellen Informationen zu einer Assembly bereit. Sie werden in die folgenden Kategorien eingeteilt:

• Attribute für Assemblyidentitäten
• Informationsattribute
• Attribute für Assemblymanifeste.

Attribute für Assemblyidentitäten

Drei Attribute bestimmen mit einem starken Namen (falls zutreffend) die Identität einer Assembly: „name“, „version“ und „culture“. Diese Attribute bilden den vollständigen Namen der Assembly und sind erforderlich, wenn im Code auf sie verwiesen wird. Sie können die Version und Kultur einer Assembly mithilfe von Attributen festlegen. Sie legen jedoch den Namenwert durch den Compiler, die Visual Studio-IDE im Dialogfeld " Assemblyinformation" oder den Assemblylinker (Al.exe) fest, wenn Sie die Assembly erstellen. Der Assemblyname basiert auf dem Assemblymanifest. Das Attribut AssemblyFlagsAttribute gibt an, ob mehrere Kopien der Assembly parallel bestehen können.

In der folgenden Tabelle werden die Identitätsattribute aufgeführt.

Attribut	Zweck
AssemblyVersionAttribute	Gibt die Version einer Assembly an
AssemblyCultureAttribute	Gibt an, welche Kultur die Assembly unterstützt.
AssemblyFlagsAttribute	Gibt eine bitweise Kombination von Flags für eine Assembly an. Diese dienen zur Beschreibung von Optionen für den JIT-Compiler (Just In Time) und geben an, ob die Assembly erneut zugewiesen werden kann und ob sie einen vollen oder als Token dargestellten öffentlichen Schlüssel besitzt.

Informationsattribute

Verwenden Sie Informationsattribute, um weitere Unternehmens- oder Produktinformationen für eine Assembly bereitzustellen. Die folgende Tabelle zeigt die Informationsattribute, die im Namespace System.Reflection definiert werden.

Attribut	Zweck
AssemblyProductAttribute	Gibt einen Produktnamen für ein Assemblymanifest an.
AssemblyTrademarkAttribute	Gibt eine Marke für ein Assemblymanifest an.
AssemblyInformationalVersionAttribute	Gibt Versionsinformationen für ein Assemblymanifest an.
AssemblyCompanyAttribute	Gibt einen Unternehmensnamen für ein Assemblymanifest an.
AssemblyCopyrightAttribute	Definiert ein benutzerdefiniertes Attribut, das ein Copyright für ein Assemblymanifest angibt
AssemblyFileVersionAttribute	Legt eine bestimmte Versionsnummer für die Win32-Dateiversionsressource fest.
CLSCompliantAttribute	Gibt an, ob die Assembly mit der Common Language Specification (CLS) kompatibel ist

Attribute für Assemblymanifeste.

Verwenden Sie Assemblymanifestattribute, um Informationen im Assemblymanifest bereitzustellen. Dies schließt Attribute für Titel, Beschreibung, Standardalias und Konfiguration ein. Die folgende Tabelle zeigt die Attribute für Assemblymanifeste, die im Namespace System.Reflection definiert werden.

Attribut	Zweck
AssemblyTitleAttribute	Gibt einen Assemblytitel für ein Assemblymanifest an.
AssemblyDescriptionAttribute	Gibt eine Assemblybeschreibung für ein Assemblymanifest an.
AssemblyConfigurationAttribute	Gibt eine Assemblykonfiguration (z. B. „Einzelhandel“ oder „Debug“) für ein Assemblymanifest an.
AssemblyDefaultAliasAttribute	Definiert einen anzeigefreundlichen Standardalias für ein Assemblymanifest.