Поделиться через


Настройка атрибутов сборки

Обновлен: Ноябрь 2007

Атрибуты сборок – это значения, которые содержат информацию о сборке. Атрибуты разделяются на следующие группы по содержанию информации:

  • Атрибуты идентификации сборки.

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

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

  • Атрибуты строгого имени.

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

Данные атрибуты вместе со строгим именем сборки (если оно применимо) определяют идентификацию сборки: имя, версию и региональные параметры. Эти атрибуты формируют полное имя сборки и являются обязательными при ссылке на сборку в коде. Они могут использоваться для задания версии сборки и региональных параметров. Компилятор или Компоновщик сборок (Al.exe) задает значение имени при создании сборки на основе файла, содержащего манифест сборки.

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

Атрибут идентификации сборки

Описание

AssemblyCultureAttribute

Пронумерованное поле, которое задает язык и региональные параметры, поддерживаемые сборкой. Кроме того, можно задать независимость от языка и региональных параметров, указывающую на то, что сборка содержит ресурсы для языка и региональных параметров по умолчанию.

4w8c1y2s.alert_note(ru-ru,VS.90).gifПримечание.
Среда выполнения рассматривает любую сборку, у которой атрибут языка и региональных параметров не установлен в null, как второстепенную. Такие сборки подчиняются правилам привязки второстепенных сборок. Дополнительные сведения содержатся в разделе Обнаружение сборок средой выполнения.

AssemblyFlagsAttribute

Значение, задающее атрибуты сборки, такие как возможность ее параллельного выполнения. 

AssemblyVersionAttribute

Численное значение формате основной_номер.дополнительный_номер.построение.редакция (например, 2.4.0.0). Среда CLR использует это значение для выполнения операций привязки в сборках со строгими именами.

4w8c1y2s.alert_note(ru-ru,VS.90).gifПримечание.
Если атрибут AssemblyInformationalVersionAttribute не применен к сборке, в свойствах Application.ProductVersion, Application.UserAppDataPath и Application.UserAppDataRegistry используется номер версии, заданный атрибутом AssemblyVersionAttribute.

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

'Set version number for the assembly.
<Assembly:AssemblyVersionAttribute("4.3.2.1")>
'Set culture as German.
<Assembly:AssemblyCultureAttribute("de")>
//Set version number for the assembly.
[assembly:AssemblyVersionAttribute("4.3.2.1")]
//Set culture as German.
[assembly:AssemblyCultureAttribute("de")]

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

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

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

Описание

AssemblyCompanyAttribute

Строковое значение, определяющее название компании.

AssemblyCopyrightAttribute

Строковое значение, содержащее сведения об авторском праве.

AssemblyFileVersionAttribute

Строковое значение, содержащее номер версии файла Win32. По умолчанию это значение совпадает с версией сборки.

AssemblyInformationalVersionAttribute

Строковое значение, содержащее сведения о версии, но которое не используется средой CLR, например полный номер версии продукта.

4w8c1y2s.alert_note(ru-ru,VS.90).gifПримечание.
Если этот атрибут применен к сборке, заданную им строку можно получить во время выполнения, используя свойство Application.ProductVersion. Строка также используется в пути и разделе реестра, предоставляемых свойствами Application.UserAppDataPath и Application.UserAppDataRegistry.

AssemblyProductAttribute

Строковое значение, содержащее сведения о продукте.

AssemblyTrademarkAttribute

Строковое значение, содержащее сведения о торговой марке.

Эти атрибуты могут появиться только на странице свойств Windows сборки, кроме того, они могут быть переопределены с помощью параметра компилятора /win32res, чтобы задать собственный файл ресурсов Win32.

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

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

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

Описание

AssemblyConfigurationAttribute

Строковое значение, показывающее конфигурацию сборки, например, Retail или Debug. Это значение не используется средой выполнения.

AssemblyDefaultAliasAttribute

Строковое значение, задающее псевдоним по умолчанию, используемый при ссылке на сборку из других сборок. Это значение содержит понятное имя, если имя сборки само по себе не является понятным (например, если в качестве имени используется значение GUID). Кроме того, это значение может использоваться в качестве краткой формы полного имени сборки.

AssemblyDescriptionAttribute

Строковое значение, задающее краткое сводное описание свойств и целевого назначения сборки.

AssemblyTitleAttribute

Строковое значение, задающее понятное имя сборки. Например, сборка с именем comdlg может иметь заголовок "Microsoft Common Dialog Control".

Атрибуты строгого имени.

Атрибуты строгого имени могут использоваться для присваивания сборке строгого имени. В следующей таблице описываются атрибуты строгого имени сборки.

Атрибуты строгого имени.

Описание

AssemblyDelaySignAttribute

Логическое значение, указывающее на использование отложенной подписи.

AssemblyKeyFileAttribute

Строковое значение, задающее имя файла, содержащего или только открытый ключ (при использовании отложенной подписи), или открытый и закрытый ключи вместе, передаваемые в качестве параметра конструктору этого атрибута. Обратите внимание, что имя файла задается относительно пути выходного файла (с расширением .exe или .dll), а не к пути исходного файла.

AssemblyKeyNameAttribute

Задает контейнер ключей, содержащий пару ключей, передаваемую как параметр в конструктор этого атрибута.

В следующем примере кода показаны атрибуты, применяемые в отложенной подписи для создания сборки со строгим именем с использованием файла открытого ключа myKey.snk.

      <Assembly:AssemblyKeyFileAttribute("myKey.snk")>
      <Assembly:AssemblyDelaySignAttribute(True)>
      [assembly:AssemblyKeyFileAttribute(@"..\..\myKey.snk")]
      [assembly:AssemblyDelaySignAttribute(true)]

См. также

Основные понятия

Создание сборок

Другие ресурсы

Программирование с использованием сборок