Атрибуты уровня сборки, интерпретируемые компилятором C#

Большинство атрибутов применяются к определенным языковым элементам, таким как классы или методы. Однако некоторые атрибуты являются глобальными. Они применяются ко всей сборке или модулю. Например, используйте AssemblyVersionAttribute атрибут для внедрения сведений о версии в сборку, как показано ниже.

[assembly: AssemblyVersion("1.0.0.0")]

Глобальные атрибуты отображаются в исходном коде после любых директив using верхнего уровня и перед всеми объявлениями типов, модулей или пространств имен. Глобальные атрибуты можно включить в несколько исходных файлов, но необходимо скомпилировать файлы в одном проходе компиляции. В проектах .NET Framework Visual Studio добавляет глобальные атрибуты в файл AssemblyInfo.cs. Эти атрибуты не добавляются в проекты .NET Core.

Справочные документы на языке C#, выпущенные последней версией языка C#. Она также содержит начальную документацию по функциям в общедоступных предварительных версиях для предстоящего языкового выпуска.

Документация определяет любую функцию, впервые представленную в последних трех версиях языка или в текущих общедоступных предварительных версиях.

Подсказка

Чтобы узнать, когда функция впервые появилась в C#, ознакомьтесь со статьей по журналу версий языка C#.

Атрибуты сборки предоставляют сведения о сборке. Они делятся на следующие категории:

• Атрибуты удостоверения сборки
• Информационные атрибуты
• Атрибуты манифеста сборки

Атрибуты удостоверения сборки

Три атрибута (со строгим именем, если оно применимо) определяют удостоверение сборки: имя, версию, язык и региональные параметры. Эти атрибуты формируют полное имя сборки и являются обязательными при ссылке на нее в коде. Вы можете задать версию и региональные параметры сборки с помощью атрибутов. Однако при создании сборки вы задаете значение имени компилятором, интегрированной среды разработки Visual Studio в диалоговом окне сведений о сборке или компоновщик сборок (Al.exe). Имя сборки основано на манифесте сборки. Атрибут AssemblyFlagsAttribute указывает, могут ли сосуществовать несколько копий сборки.

В следующей таблице приведены атрибуты удостоверения.

Атрибут	Характер использования
AssemblyVersionAttribute	Задает версию сборки.
AssemblyCultureAttribute	Указывает, какой язык и региональные параметры поддерживает сборка.
AssemblyFlagsAttribute	Определяет побитовое сочетание флагов для сборки, описывающих параметры JIT-компилятора, возможность переопределить целевые объекты сборки, а также вид открытого ключа сборки — полный или измененный с использованием маркера.

Информационные атрибуты

Используйте информационные атрибуты для предоставления дополнительных сведений о компании или продукте для сборки. В следующей таблице показаны информационные атрибуты, определенные в пространстве имен System.Reflection.

Атрибут	Характер использования
AssemblyProductAttribute	Указывает имя продукта для манифеста сборки.
AssemblyTrademarkAttribute	Указывает товарный знак для манифеста сборки.
AssemblyInformationalVersionAttribute	Определяет сведения о версии для манифеста сборки.
AssemblyCompanyAttribute	Указывает имя организации для манифеста сборки.
AssemblyCopyrightAttribute	Определяет настраиваемый атрибут, задающий уведомление об авторских правах для манифеста сборки.
AssemblyFileVersionAttribute	Задает определенный номер версии для ресурса версии файла Win32.
CLSCompliantAttribute	Указывает, соответствует ли сборка спецификации CLS.

Атрибуты манифеста сборки

Используйте атрибуты манифеста сборки для предоставления сведений в манифесте сборки. К ним относится заголовок, описание, псевдоним по умолчанию и конфигурация. В следующей таблице показаны атрибуты манифеста сборки, определенные в пространстве имен System.Reflection.

Атрибут	Характер использования
AssemblyTitleAttribute	Указывает название сборки для манифеста сборки.
AssemblyDescriptionAttribute	Указывает описание сборки для манифеста сборки.
AssemblyConfigurationAttribute	Указывает конфигурацию сборки (например, "Розница" или "Отладка") для манифеста сборки.
AssemblyDefaultAliasAttribute	Определяет понятный псевдоним по умолчанию для манифеста сборки.