Sdílet prostřednictvím


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

Většina atributů se vztahuje na konkrétní prvky jazyka, jako jsou třídy nebo metody. Některé atributy jsou však globální. Platí pro celé sestavení nebo modul. Pomocí atributu AssemblyVersionAttribute můžete například vložit informace 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 můžete zahrnout do více zdrojových souborů, ale musíte je zkompilovat v rámci jednoho průchodu kompilace. V projektech rozhraní .NET Framework visual Studio přidá do souboru AssemblyInfo.cs globální atributy. Tyto atributy nejsou přidány do projektů .NET Core.

Referenční dokumentace jazyka C# dokumentuje naposledy vydané verze jazyka C#. Obsahuje také počáteční dokumentaci k funkcím ve verzi Public Preview pro nadcházející jazykovou verzi.

Dokumentace identifikuje všechny funkce, které byly poprvé představeny v posledních třech verzích jazyka nebo v aktuálních verzích Public Preview.

Návod

Informace o tom, kdy byla funkce poprvé představena v jazyce C#, najdete v článku o historii verzí jazyka C#.

Atributy sestavení 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. Verzi a jazykovou verzi sestavení můžete nastavit pomocí atributů. Hodnotu názvu však nastavíte kompilátorem, integrované vývojové 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ů můžete poskytnout 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í

Pomocí atributů manifestu sestavení zadejte informace v 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í.