C# для профессионалов. Том II

Приложeниe D Параметры компиляции C#

Это приложение перечисляет различные параметры компиляции C#, которые можно применять, если необходимо компилировать проекты C#, не используя возможности Visual Studio.NET, или если необходимо выполнить операции компилятора, не поддерживаемые Visual Studio.NET. Они организованы как последовательность таблиц, составленных согласно категориям.

Первая таблица показывает различные форматы файлов, которые может выводить компилятор:

Параметр	Назначение
/doc:<имя файла>	Обрабатывает комментарии документации XML (помеченные тремя слэшами — ///) и выводит в указанный файл XML.
/nooutput	Компилирует код, но не создает файла вывода; полезно для отладочных целей, так как консоль будет показывать предупреждения и ошибки.
/out:<имя файла>	Определяет имя файла вывода. Если оно не указано, то компилятор создает стандартный файл .exe с тем же именем, что и у исходного файла (кроме расширения).
/target:<option> /t:<option>	Определяет формат файла вывода в одном из четырех вариантов: exe: создает стандартный исполняемый файл (задание по умолчанию). library: создает код библиотеки (DLL). module: создает модуль кода (сборку без манифеста), который позже добавляется к сборке (с помощью /addmodule). winexe: создает исполняемый файл для Windows.

Если только не определен параметр /target:module, компилятор будет добавлять манифест в создаваемый ЕХЕ файл (или первый файл DLL, если ЕХЕ не создается). Отметим, что /target можно сократить до /t.

Следующая таблица объясняет параметр командной строки для определения оптимизации компилятора.

Параметр	Назначение
/optimize<+ | -> /о<+ | ->	Включает или выключает оптимизацию, выполняемую компилятором для создания более короткого, быстрого и эффективного вывода. Отключено по умолчанию. Чтобы включить, применяйте синтаксис: /optimize или /optimize+ Чтобы выключить, применяйте синтаксис: /optimize-

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

Параметр	Назначение
/addmodule:<модуль>	Определяет один или несколько модулей, которые будут включены в указанную сборку. Если модулей более одного, то они разделяются с помощью точки с запятой. Этот параметр недоступен в Visual Studio.NET
/nostdlib<+ | ->	Определяет, нужно или нет импортировать стандартную библиотеку (mscorlib.dll), которая импортируется по умолчанию. Если желательно реализовать свое собственное пространство имен и классы System, то компилятор не будет загружать стандартную библиотеку. Синтаксис для этого выглядит следующим образом: /nostdlib или /nostdlib+ Синтаксис для импортирования следующий: /nostdlib-
/reference:<сборка> /r:<сборка>	Импортирует метаданные из файла сборки. Можно определить полный путь доступа к сборке, или определенный везде с помощью переменной окружения PATH, либо относительный путь начинающийся в текущем проекте. Если имеется больше одного файла, они разделяются посредством точки с запятой.

Следующая таблица объясняет параметры, которые применяются при отладке и контроле ошибок.

Параметр	Назначение
/bugreport <имя файла>	Создает указанный файл, который содержит всю информацию об ошибках, выданную компилятором. Содержимое файла включает: копию всего исходного кода, листинг параметров компилятора, информацию о версии компилятора, операционной системе и т.д., всю выдачу компилятора, описание