Atributy na úrovni sestavení interpretované kompilátorem jazyka C#

  • Článek

Většina atributů se používá u konkrétních jazykových prvků, jako jsou třídy nebo metody; Některé atributy jsou však globální – vztahují se na celé sestavení nebo modul. AssemblyVersionAttribute Například atribut lze použít k vložení informací o verzi do sestavení, například takto:

[assembly: AssemblyVersion("1.0.0.0")]

Globální atributy se zobrazí ve zdrojovém kódu za všemi direktivami nejvyšší úrovně using a před deklaracemi typu, modulu nebo oboru názvů. Globální atributy se můžou objevit ve více zdrojových souborech, ale soubory musí být zkompilovány v rámci jednoho průchodu kompilace. Visual Studio přidá globální atributy do souboru AssemblyInfo.cs v projektech .NET Framework. Tyto atributy nejsou přidány do projektů .NET Core.

Atributy sestavení jsou hodnoty, které poskytují informace o sestavení. Spadají do následujících kategorií:

  • Atributy identity sestavení
  • Informační atributy
  • Atributy manifestu sestavení

Atributy identity sestavení

Tři atributy (s silným názvem, pokud je k dispozici) určují identitu sestavení: název, verze a jazyková verze. Tyto atributy tvoří úplný název sestavení a jsou vyžadovány při odkazování v kódu. Pomocí atributů můžete nastavit verzi a jazykovou verzi sestavení. Hodnota názvu je však nastavena kompilátorem, integrovaném vývojovém prostředí sady Visual Studio v dialogovém okně Informace o sestavení nebo linker sestavení (Al.exe) při vytváření sestavení. Název sestavení je založený na manifestu sestavení. Atribut AssemblyFlagsAttribute určuje, zda může existovat více kopií sestavení.

V následující tabulce jsou uvedeny atributy identity.

Atribut Účel
AssemblyVersionAttribute Určuje verzi sestavení.
AssemblyCultureAttribute Určuje, která jazyková verze sestavení podporuje.
AssemblyFlagsAttribute Určuje bitové kombinace příznaků pro sestavení, popisující možnosti kompilátoru JIT (just-in-time), zda je sestavení retargetable a zda má úplný nebo tokenizovaný veřejný klíč.

Informační atributy

Pomocí informačních atributů poskytnete více informací o společnosti nebo produktu pro sestavení. Následující tabulka ukazuje informační atributy definované v System.Reflection oboru názvů.

Atribut Účel
AssemblyProductAttribute Určuje název produktu pro manifest sestavení.
AssemblyTrademarkAttribute Určuje ochrannou známku manifestu sestavení.
AssemblyInformationalVersionAttribute Určuje informační verzi manifestu sestavení.
AssemblyCompanyAttribute Určuje název společnosti pro manifest sestavení.
AssemblyCopyrightAttribute Definuje vlastní atribut, který určuje autorská práva pro manifest sestavení.
AssemblyFileVersionAttribute Nastaví konkrétní číslo verze pro prostředek verze souboru Win32.
CLSCompliantAttribute Určuje, jestli sestavení vyhovuje specifikaci CLS (Common Language Specification).

Atributy manifestu sestavení

K poskytnutí informací v manifestu sestavení můžete použít atributy manifestu sestavení. Mezi atributy patří název, popis, výchozí alias a konfigurace. Následující tabulka ukazuje atributy manifestu sestavení definované v System.Reflection oboru názvů.

Atribut Účel
AssemblyTitleAttribute Určuje název sestavení manifestu sestavení.
AssemblyDescriptionAttribute Určuje popis sestavení manifestu sestavení.
AssemblyConfigurationAttribute Určuje konfiguraci sestavení (například maloobchodní nebo ladění) pro manifest sestavení.
AssemblyDefaultAliasAttribute Definuje popisný výchozí alias manifestu sestavení.