Udostępnij za pośrednictwem

Atrybuty na poziomie zestawu interpretowane przez kompilator języka C#

  • Artykuł

Większość atrybutów jest stosowana do określonych elementów języka, takich jak klasy lub metody; jednak niektóre atrybuty są globalne — mają zastosowanie do całego zestawu lub modułu. Na przykład atrybut może służyć do osadzania AssemblyVersionAttribute informacji o wersji w zestawie, w następujący sposób:

[assembly: AssemblyVersion("1.0.0.0")]

Atrybuty globalne są wyświetlane w kodzie źródłowym po wszelkich dyrektywach najwyższego poziomu using i przed dowolnym typem, modułem lub deklaracjami przestrzeni nazw. Atrybuty globalne mogą być wyświetlane w wielu plikach źródłowych, ale pliki muszą zostać skompilowane w jednym przebiegu kompilacji. Program Visual Studio dodaje atrybuty globalne do pliku AssemblyInfo.cs w projektach programu .NET Framework. Te atrybuty nie są dodawane do projektów platformy .NET Core.

Atrybuty zestawu to wartości, które zawierają informacje o zestawie. Należą one do następujących kategorii:

  • Atrybuty tożsamości zestawu
  • Atrybuty informacyjne
  • Atrybuty manifestu zestawu

Atrybuty tożsamości zestawu

Trzy atrybuty (o silnej nazwie, jeśli ma zastosowanie) określają tożsamość zestawu: nazwę, wersję i kulturę. Te atrybuty tworzą pełną nazwę zestawu i są wymagane podczas odwołowania się do niego w kodzie. Wersję i kulturę zestawu można ustawić przy użyciu atrybutów. Jednak wartość nazwy jest ustawiana przez kompilator, środowisko IDE programu Visual Studio w oknie dialogowym Informacje o zestawie lub konsolidator zestawu (Al.exe) podczas tworzenia zestawu. Nazwa zestawu jest oparta na manifeście zestawu. Atrybut AssemblyFlagsAttribute określa, czy wiele kopii zestawu może współistnieć.

W poniższej tabeli przedstawiono atrybuty tożsamości.

Atrybut Purpose
AssemblyVersionAttribute Określa wersję zestawu.
AssemblyCultureAttribute Określa kulturę obsługiwaną przez zestaw.
AssemblyFlagsAttribute Określa bitową kombinację flag dla zestawu, opisując opcje kompilatora just in time (JIT), niezależnie od tego, czy zestaw jest retargetable, i czy ma pełny lub tokenizowany klucz publiczny.

Atrybuty informacyjne

Atrybuty informacyjne służą do dostarczania większej ilości informacji o firmie lub produkcie dla zestawu. W poniższej System.Reflection tabeli przedstawiono atrybuty informacyjne zdefiniowane w przestrzeni nazw.

Atrybut Purpose
AssemblyProductAttribute Określa nazwę produktu manifestu zestawu.
AssemblyTrademarkAttribute Określa znak towarowy manifestu zestawu.
AssemblyInformationalVersionAttribute Określa informacyjną wersję manifestu zestawu.
AssemblyCompanyAttribute Określa nazwę firmy dla manifestu zestawu.
AssemblyCopyrightAttribute Definiuje atrybut niestandardowy określający prawa autorskie do manifestu zestawu.
AssemblyFileVersionAttribute Ustawia określony numer wersji zasobu wersji pliku Win32.
CLSCompliantAttribute Wskazuje, czy zestaw jest zgodny ze specyfikacją języka wspólnego (CLS).

Atrybuty manifestu zestawu

Atrybuty manifestu zestawu umożliwiają podanie informacji w manifeście zestawu. Atrybuty obejmują tytuł, opis, alias domyślny i konfigurację. W poniższej System.Reflection tabeli przedstawiono atrybuty manifestu zestawu zdefiniowane w przestrzeni nazw.

Atrybut Purpose
AssemblyTitleAttribute Określa tytuł zestawu dla manifestu zestawu.
AssemblyDescriptionAttribute Określa opis zestawu dla manifestu zestawu.
AssemblyConfigurationAttribute Określa konfigurację zestawu (na przykład sprzedaż detaliczną lub debugowanie) dla manifestu zestawu.
AssemblyDefaultAliasAttribute Definiuje przyjazny alias domyślny manifestu zestawu