Компоновщик сборок (Al.exe)

Чтобы избежать виртуализации на компьютере Windows Vista, сборка должна включать манифест win32 с указанием запрошенного уровня выполнения. Запуская al.exe непосредственно из командной строки, можно либо внедрить манифест в файл ресурсов win32, либо с помощью программы mt.exe присоединить манифест позже в процессе построения. В Visual Studio 2008 компиляторы C# и Visual Basic автоматически внедряют манифест win32 в сборку. Дополнительные сведения см. в разделе /win32manifest (импорт пользовательского файла манифеста Win32) (параметры компилятора C#).

file[,target]

Копирует содержимое файла file (модуля) в файл, указанный параметром target. После копирования программа Al.exe компилирует файл target в сборку.

/link[resource]:file[,name[,target[,private]]]

Связывает файл ресурсов со сборкой. Ресурс, заданный параметром file, становится частью сборки; файл не копируется. Файл, указанный параметром file, может иметь любой формат. Например, в качестве параметра file можно указать библиотеку DLL в машинном коде. После выполнения этой команды библиотека DLL станет частью сборки, так что она может быть установлена в глобальный кэш сборок и станет доступна из управляемого кода в сборке. Того же самого можно добиться с помощью параметра компилятора /linkresource. Дополнительные сведения см. в разделе /linkresource (ссылка на ресурс платформы .NET Framework) (параметры компилятора C#).

Параметрname задает внутренний идентификатор ресурса. Параметр targetзадает путь и имя файла, в который программа Al.exe скопирует file. После копирования программа Al.exe компилирует файл target в сборку. По умолчанию ресурсы в сборке открыты (т. е. доступны для других сборок). При указании параметра private ресурс будет скрыт от других сборок.

Если file является файлом ресурсов .NET Framework, созданным, например, генератором файлов ресурсов (Resgen.exe) или в среде разработки, то к нему можно обращаться с помощью членов пространства имен System.Resources. Дополнительные сведения см. в разделе ResourceManager. Чтобы получить доступ ко всем остальным ресурсам во время выполнения, используйте методы GetManifestResource * в классе Assembly.

Если в Al.exe передаются только файлы ресурсов, результатом работы является вспомогательная сборка ресурсов.

/algid:id

Задает алгоритм хэширования всех файлов многофайловой сборки, кроме файла, содержащего манифест сборки. По умолчанию используется алгоритм CALG_SHA1. Для получения дополнительных сведений о других алгоритмах см. раздел "ALG_ID" в документации Platform SDK. В первом выпуске .NET Framework доступны только алгоритмы CALG_SHA1 и CALG_MD5.

Хэш-значения хранятся в таблице файлов манифеста сборки. Во время установки и загрузки файлы сборки сравниваются со своими хэш-значениями.

Этот параметр можно также указать в исходном коде любого модуля в качестве настраиваемого атрибута (AssemblyAlgorithmIdAttribute).

/bugreport:filename

Создает файл (filename), содержащий сведения об обнаруженных ошибках.

/config[uration]:text

Задает строковое значение поля Configuration в сборке. Если значение параметра text содержит пробел, следует заключать строку в двойные кавычки (" "). Эта строка является настраиваемым атрибутом сборки и доступна для просмотра с отражением.

Если текст — пустая строка, ресурс Win32 Configuration отображается в виде одного пробела.

Этот параметр можно также указать в исходном коде любого модуля MSIL в качестве настраиваемого атрибута (AssemblyConfigurationAttribute).

/c[ulture]:text

Задает строку языка и региональных параметров для связывания со сборкой. Допустимые значения этого параметра определяются документом RFC 1766 "Tags for the Identification of Languages" (Теги идентификации языков).

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

Дополнительные сведения о допустимых строках text см. в разделе CultureInfo.

Этот параметр можно также указать в исходном коде любого модуля MSIL в качестве настраиваемого атрибута (AssemblyCultureAttribute).

/descr[iption]:text

Задает строковое значение для поля Description в сборке. Если значение параметра text содержит пробел, следует заключать строку в двойные кавычки (" "). Эта строка является настраиваемым атрибутом сборки и доступна для просмотра с отражением.

Если параметр /win32res не указан, строка /description будет отображаться в проводнике Windows как ресурс Win32 Comments.

Если текст — пустая строка, ресурс Win32 Comments отображается в виде одиночного пробела.

Если параметр /win32res задан, параметр /description не повлияет на сведения о ресурсах Win32.

Этот параметр можно также указать в исходном коде любого модуля MSIL в качестве настраиваемого атрибута (Description).

/fileversion:version

Задает строковое значение поля File Version в сборке. Эта строка является настраиваемым атрибутом сборки и доступна для просмотра с отражением.

Если параметр /win32res не указан, строка /fileversion будет использоваться в качестве ресурса Win32 File Version. Если параметр /fileversion не указан, ресурс Win32 File Version будет взят из ресурса Win32 Assembly Version.

Если параметр /win32res задан, параметр /fileversion не оказывает влияния на ресурс Win32.

Этот параметр можно также указать в исходном коде любого модуля MSIL в качестве настраиваемого атрибута (AssemblyFileVersionAttribute).

/fullpaths

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

/keyf[ile]:filename

Задает файл (filename), содержащий пару ключей или только открытый ключ для подписывания сборки. Компилятор вставляет открытый ключ в манифест сборки, а затем подписывает окончательную сборку закрытым ключом. Сведения о генерации файлов ключей и установке пар ключей в контейнеры ключей см. в разделе Средство для работы со строгими именами (Sn.exe).

Для сборок с отложенной подписью в этом файле обычно помещается открытый, но не закрытый ключ.

Данные открытого ключа (из пары ключей) находятся в поле .publickey сборки.

Этот параметр можно также указать в исходном коде любого модуля MSIL в качестве настраиваемого атрибута (AssemblyKeyFileAttribute).

Если параметры /keyfile и /keyname указаны одновременно (в командной строке или с помощью настраиваемого атрибута) в одной компиляции, сначала будет предпринята попытка обработать контейнер, заданный параметром /keyname. В случае успеха сборка подписывается данными контейнера ключей. Если контейнер ключей не обнаружен, будет предпринята попытка использовать файл, заданный параметром /keyfile. В случае успеха сборка подписывается данными из файла ключей и сведения о ключах будут помещены в контейнер ключей (аналогично действию параметра -i в программе Sn.exe), так что при следующей компиляции параметр /keyname будет действительным.

/main:method

Задает полное имя (class.method) метода, являющегося точкой входа при преобразовании модуля в исполняемый файл.

/out:filename

Задает имя файла, создаваемого программой Al.exe. Это обязательный параметр.

/prod[uct]:text

Задает строковое значение для поля Product в сборке. Если значение параметра text содержит пробел, следует заключать строку в двойные кавычки (" "). Эта строка является настраиваемым атрибутом сборки и доступна для просмотра с отражением.

Если параметр /win32res не указан, строка /product отображается в проводнике Windows как ресурс Win32 Product Name.

Если текст — пустая строка, ресурс Win32 Product Name отображается в виде одного пробела.

Если параметр /win32res задан, параметр /product не повлияет на сведения о ресурсах Win32.

Этот параметр можно также указать в исходном коде любого модуля MSIL в качестве настраиваемого атрибута (AssemblyProductAttribute).

/t[arget]:lib[rary] | exe | win[exe]

Задает формат выходного файла: lib[rary] (библиотека кода), exe (консольное приложение) или win[exe] (приложение Windows). По умолчанию предполагается lib[rary].

/title:text

Задает строковое значение для поля Title в сборке. Если значение параметра text содержит пробел, следует заключать строку в двойные кавычки (" "). Эта строка является настраиваемым атрибутом сборки и доступна для просмотра с отражением.

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

Если текст — пустая строка, ресурс Win32 Description отображается в виде одного пробела.

Если параметр /win32res задан, параметр /title не повлияет на сведения о ресурсах Win32.

Этот параметр можно также указать в исходном коде любого модуля MSIL в качестве настраиваемого атрибута (AssemblyTitleAttribute).

/v[ersion]:version

Определяет сведения о версии данной сборки. Строка версии имеет следующий формат: major.minor.build.revision. Значение по умолчанию — 0.

При указании параметра /version необходимо также указать параметр major. Если заданы значения major и minor, можно указать знак звездочки (*) для build. В этом случае значение build будет равно количеству дней, прошедших с 1 января 2000 г. по местному времени, а значение revision будет равно количеству секунд, прошедших с полуночи 1 января 2000 г. по местному времени, деленному на 2.

Если заданы значения major, minor и build, можно указать знак звездочки (*) для revision. В этом случае значение revision будет равно половине числа секунд, прошедших с полуночи 1 января 2000 г. по местному времени.

Итак, допускаются следующие форматы строки версии:

X

X.X

X.X.*

X.X.X

X.X.X.*

X.X.X.X

где X — любая короткая целая константа без знака, кроме 65535 (т. е. от 0 до 65534 включительно).

Если параметр /win32res не указан, строка /version будет использоваться в качестве ресурса Win32 Assembly Version.

Если параметры /win32res, /productversion и /fileversion не указаны, строка /version будет использоваться в качестве ресурсов Win32 Assembly Version, File Version и Product Version.

Если параметр /win32res задан, параметр /version не повлияет на сведения о ресурсах Win32.

Этот параметр можно также указать в исходном коде любого модуля MSIL в качестве настраиваемого атрибута (AssemblyVersionAttribute).

/win32res:filename

Вставляет файл ресурсов Win32 (RES-файл) в выходной файл. Файл ресурсов Win32 может быть создан компилятором ресурсов. Компилятор ресурсов вызывается при компиляции программы Visual C++ и создает RES-файл из RC-файла.

/?

Отображает синтаксис команд и параметров программы.