Настройка атрибутов сборки
Обновлен: Ноябрь 2007
Атрибуты сборок – это значения, которые содержат информацию о сборке. Атрибуты разделяются на следующие группы по содержанию информации:
Атрибуты идентификации сборки.
Информационные атрибуты.
Атрибуты манифеста сборки.
Атрибуты строгого имени.
Атрибуты идентификации сборки
Данные атрибуты вместе со строгим именем сборки (если оно применимо) определяют идентификацию сборки: имя, версию и региональные параметры. Эти атрибуты формируют полное имя сборки и являются обязательными при ссылке на сборку в коде. Они могут использоваться для задания версии сборки и региональных параметров. Компилятор или Компоновщик сборок (Al.exe) задает значение имени при создании сборки на основе файла, содержащего манифест сборки.
В следующей таблице описываются атрибуты версии и региональных параметров.
Атрибут идентификации сборки |
Описание |
|---|---|
Пронумерованное поле, которое задает язык и региональные параметры, поддерживаемые сборкой. Кроме того, можно задать независимость от языка и региональных параметров, указывающую на то, что сборка содержит ресурсы для языка и региональных параметров по умолчанию. .gif "Примечание") Примечание.
Среда выполнения рассматривает любую сборку, у которой атрибут языка и региональных параметров не установлен в null, как второстепенную. Такие сборки подчиняются правилам привязки второстепенных сборок. Дополнительные сведения содержатся в разделе Обнаружение сборок средой выполнения.
|
|
Значение, задающее атрибуты сборки, такие как возможность ее параллельного выполнения. |
|
Численное значение формате основной_номер.дополнительный_номер.построение.редакция (например, 2.4.0.0). Среда CLR использует это значение для выполнения операций привязки в сборках со строгими именами. Примечание.
Если атрибут 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")]
Информационные Атрибуты.
Информационные атрибуты могут использоваться для присвоения сборке дополнительной информации о компании или продукте. В следующей таблице описываются применимые к сборке информационные атрибуты.
Информационный атрибут |
Описание |
|---|---|
Строковое значение, определяющее название компании. |
|
Строковое значение, содержащее сведения об авторском праве. |
|
Строковое значение, содержащее номер версии файла Win32. По умолчанию это значение совпадает с версией сборки. |
|
Строковое значение, содержащее сведения о версии, но которое не используется средой CLR, например полный номер версии продукта. Примечание.
Если этот атрибут применен к сборке, заданную им строку можно получить во время выполнения, используя свойство Application.ProductVersion. Строка также используется в пути и разделе реестра, предоставляемых свойствами Application.UserAppDataPath и Application.UserAppDataRegistry.
|
|
Строковое значение, содержащее сведения о продукте. |
|
Строковое значение, содержащее сведения о торговой марке. |
Эти атрибуты могут появиться только на странице свойств Windows сборки, кроме того, они могут быть переопределены с помощью параметра компилятора /win32res, чтобы задать собственный файл ресурсов Win32.
Атрибуты манифеста сборки.
Эти атрибуты используются для указания в манифесте сборки таких сведений, как заголовок, описание, псевдоним по умолчанию и конфигурация. В следующей таблице описываются атрибуты манифеста сборки.
Атрибут манифеста сборки |
Описание |
|---|---|
Строковое значение, показывающее конфигурацию сборки, например, Retail или Debug. Это значение не используется средой выполнения. |
|
Строковое значение, задающее псевдоним по умолчанию, используемый при ссылке на сборку из других сборок. Это значение содержит понятное имя, если имя сборки само по себе не является понятным (например, если в качестве имени используется значение GUID). Кроме того, это значение может использоваться в качестве краткой формы полного имени сборки. |
|
Строковое значение, задающее краткое сводное описание свойств и целевого назначения сборки. |
|
Строковое значение, задающее понятное имя сборки. Например, сборка с именем comdlg может иметь заголовок "Microsoft Common Dialog Control". |
Атрибуты строгого имени.
Атрибуты строгого имени могут использоваться для присваивания сборке строгого имени. В следующей таблице описываются атрибуты строгого имени сборки.
Атрибуты строгого имени. |
Описание |
|---|---|
Логическое значение, указывающее на использование отложенной подписи. |
|
Строковое значение, задающее имя файла, содержащего или только открытый ключ (при использовании отложенной подписи), или открытый и закрытый ключи вместе, передаваемые в качестве параметра конструктору этого атрибута. Обратите внимание, что имя файла задается относительно пути выходного файла (с расширением .exe или .dll), а не к пути исходного файла. |
|
Задает контейнер ключей, содержащий пару ключей, передаваемую как параметр в конструктор этого атрибута. |
В следующем примере кода показаны атрибуты, применяемые в отложенной подписи для создания сборки со строгим именем с использованием файла открытого ключа myKey.snk.
<Assembly:AssemblyKeyFileAttribute("myKey.snk")>
<Assembly:AssemblyDelaySignAttribute(True)>
[assembly:AssemblyKeyFileAttribute(@"..\..\myKey.snk")]
[assembly:AssemblyDelaySignAttribute(true)]