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

Większość atrybutów ma zastosowanie 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 użyj atrybutu AssemblyVersionAttribute , aby osadzić informacje 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. Można uwzględnić atrybuty globalne w wielu plikach źródłowych, ale należy skompilować pliki w jednym przebiegu kompilacji. W projektach programu .NET Framework program Visual Studio dodaje atrybuty globalne do pliku AssemblyInfo.cs. Te atrybuty nie są dodawane do projektów platformy .NET Core.

Dokumentacja języka C# zawiera ostatnio wydaną wersję języka C#. Zawiera również początkową dokumentację funkcji w publicznej wersji zapoznawczej nadchodzącej wersji językowej.

Dokumentacja identyfikuje dowolną funkcję po raz pierwszy wprowadzoną w ostatnich trzech wersjach języka lub w bieżącej publicznej wersji zapoznawczej.

Wskazówka

Aby dowiedzieć się, kiedy funkcja została po raz pierwszy wprowadzona w języku C#, zapoznaj się z artykułem dotyczącym historii wersji języka C#.

Atrybuty zestawu 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. Należy jednak ustawić wartość nazwy 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

Użyj atrybutów informacyjnych, aby udostępnić więcej 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

Użyj atrybutów manifestu zestawu, aby podać informacje 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.