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

Задача Csc

  • Статья

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

Повторно выполняет программу CSC.exe и создает исполняемые файлы (EXE-файлы), библиотеки динамической компоновки (DLL-файлы) и модули кода (NETMODULE-файлы). Дополнительные сведения о программе CSC.EXE см. в разделе Параметры компилятора C#.

Параметры

В следующей таблице описаны параметры задачи Csc.

Параметр

Описание

AdditionalLibPaths

Необязательный параметр типа String[].

Задает дополнительные папки для поиска ссылок. Дополнительные сведения см. в разделе /lib (указание расположений для ссылок на сборки) (параметры компилятора C#).

AddModules

Необязательный параметр типа String.

Задает один или несколько модулей, которые войдут в сборку. Дополнительные сведения см. в разделе /addmodule (импорт метаданных) (параметры компилятора C#).

AllowUnsafeBlocks

Необязательный параметр типа Boolean.

Если этот параметр равен true, то выполняется компиляция кода, в котором используется ключевое слово unsafe. Дополнительные сведения см. в разделе /unsafe (включить небезопасный режим) (параметры компилятора C#).

BaseAddress

Необязательный параметр типа String.

Задает предпочтительный базовый адрес для загрузки библиотеки DLL. Базовый адрес по умолчанию для библиотеки DLL задается в среде CLR .NET Framework. Дополнительные сведения см. в разделе /baseaddress (указание базового адреса библиотеки DLL) (параметры компилятора C#).

CheckForOverflowUnderflow

Необязательный параметр типа Boolean.

Указывает, должны ли целочисленные арифметические операции, вызывающие переполнение типа данных, вызывать исключение во время выполнения. Дополнительные сведения см. в разделе /checked (проверка целочисленных арифметических операций) (параметры компилятора C#).

CodePage

Необязательный параметр типа Int32.

Задает кодовую страницу, которая должна использоваться для всех файлов исходного кода при компиляции. Дополнительные сведения см. в разделе /codepage (указание кодовой страницы для файлов исходного кода) (параметры компилятора C#).

DebugType

Необязательный параметр типа String.

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

Этот параметр переопределяет параметр EmitDebugInformation.

Дополнительные сведения см. в разделе /debug (вывод отладочной информации) (параметры компилятора C#).

DefineConstants

Необязательный параметр типа String.

Определяет символы препроцессора. Дополнительные сведения см. в разделе /define (определение препроцессора) (параметр компилятора C#).

DelaySign

Необязательный параметр типа Boolean.

Значение, равное true, предписывает создание полностью подписанной сборки. Значение, равное false, предписывает только поместить в сборку открытый ключ.

Этот параметр не имеет эффекта, если не используется вместе с параметром KeyFile или KeyContainer.

Дополнительные сведения см. в разделе /delaysign (отложенная подпись сборки) (параметры компилятора C#).

DisabledWarnings

Необязательный параметр типа String.

Задает список предупреждений, которые следует отключить. Дополнительные сведения см. в разделе /nowarn (отключение указанных предупреждений) (параметры компилятора C#).

DocumentationFile

Необязательный параметр типа String.

Обрабатывает комментарии для документации и помещает их в XML-файл. Дополнительные сведения см. в разделе /doc (комментарии документации процесса) (параметры компилятора C#).

EmitDebugInformation

Необязательный параметр типа Boolean.

Если этот параметр равен true, задача генерирует отладочную информацию и помещает ее в файл базы данных программы (PDB-файл). Если задано значение false, задача не генерирует отладочную информацию. По умолчанию используется значение false. Дополнительные сведения см. в разделе /debug (вывод отладочной информации) (параметры компилятора C#).

ErrorReport

Необязательный параметр типа String.

Представляет собой удобный способ для сообщения о внутренней ошибке C# в корпорацию Майкрософт. Этот параметр может иметь следующие значения: prompt, send или none. Если установлено значение prompt, в случае внутренней ошибки компилятора будет выведено сообщение. с предложением отправить электронный отчет об ошибке в корпорацию Майкрософт. Если установлено значение send, сообщение об ошибке отправляется автоматически. Если установлено значение none, отчет об ошибке выводится только в текстовых выходных данных компилятора. По умолчанию используется значение none. Дополнительные сведения см. в разделе /errorreport (установка поведения отчетов об ошибках) (параметры компилятора C#).

FileAlignment

Необязательный параметр типа Int32.

Задает размер разделов в выходном файле. Дополнительные сведения см. в разделе /filealign (задать выравнивание разделов) (параметры компилятора C#).

GenerateFullPaths

Необязательный параметр типа Boolean.

Если этот параметр равен true, то в выходных компилятора задается абсолютный путь к файлу. Если установлено значение false, задается имя файла. По умолчанию используется значение false. Дополнительные сведения см. в разделе /fullpaths (указание полного пути в результатах компилятора) (параметры компилятора C#).

KeyContainer

Необязательный параметр типа String.

Задает имя контейнера криптографического ключа. Дополнительные сведения см. в разделе /keycontainer (указание строгого имени контейнера ключа) (параметры компилятора C#).

KeyFile

Необязательный параметр типа String.

Задает имя файла, содержащего криптографический ключ. Дополнительные сведения см. в разделе /keyfile (указать файл с ключом строгого имени) (параметры компилятора C#).

LangVersion

Необязательный параметр типа String.

Задает используемую версию языка. Дополнительные сведения см. в разделе /langversion (совместимый синтаксис) (параметры компилятора C#).

LinkResources

Необязательный параметр ITaskItem[] .

Создает ссылку на ресурс .NET Framework в выходном файле; файл ресурса не помещается в выходной файл.

Элементы, передаваемые в этот параметр, могут иметь дополнительные записи метаданных с именами LogicalName и Access. LogicalName соответствует параметру identifier ключа /linkresource, а Access соответствует параметру accessibility-modifier. Дополнительные сведения см. в разделе /linkresource (ссылка на ресурс платформы .NET Framework) (параметры компилятора C#).

MainEntryPoint

Необязательный параметр типа String.

Задает местоположение метода Main. Дополнительные сведения см. в разделе /main (указание расположения метода "Main") (параметры компилятора C#).

NoConfig

Необязательный параметр типа Boolean.

Значение true предписывает компилятору не использовать файл CSC.RSP. Дополнительные сведения см. в разделе /noconfig (пропуск csc.rsp) (параметры компилятора C#).

NoLogo

Необязательный параметр типа Boolean.

Если этот параметр равен true, отображение заголовка компилятора отключается. Дополнительные сведения см. в разделе /nologo (отключение рекламной информации) (параметры компилятора C#).

NoStandardLib

Необязательный параметр типа Boolean.

Значение true отключает импорт библиотеки mscorlib.dll, определяющей все пространство имен System. Используйте этот параметр в случае, если вам необходимо определить или создать собственное пространство имен System и соответствующие объекты. Дополнительные сведения см. в разделе /nostdlib (не импортировать стандартную библиотеку) (параметры компилятора C#).

Optimize

Необязательный параметр типа Boolean.

Значение true включает оптимизации. Значение false отключает оптимизации. Дополнительные сведения см. в разделе /optimize (включение и отключение оптимизации) (параметры компилятора C#).

OutputAssembly

Необязательный выходной параметр String.

Задает имя выходного файла. Дополнительные сведения см. в разделе /out (установка имени выходного файла) (параметры компилятора C#).

Platform

Необязательный параметр типа String.

Задает платформу процессора, для которой следует создавать выходной файл. Этот параметр может иметь следующие значения: x86, x64 или anycpu. По умолчанию используется значение anycpu. Дополнительные сведения см. в разделе /platform (указание выходной платформы) (параметры компилятора C#).

References

Необязательный параметр ITaskItem[] .

Вызывает импорт задачей информации об открытых типах из заданных элементов в текущий проект. Дополнительные сведения см. в разделе /reference (импорт метаданных) (параметры компилятора C#).

Вы можете задать псевдоним ссылки Visual C# в файле MSBuild, добавив метаданные Aliases к исходному элементу "Reference". Например, пусть требуется установить псевдоним "LS1" в следующей командной строке CSC:

csc /r:LS1=MyCodeLibrary.dll /r:LS2=MyCodeLibrary2.dll *.cs

Для этого используется следующий код:

<Reference Include="MyCodeLibrary">
  <Aliases>LS1</Aliases>
</Reference>

Resources

Необязательный параметр ITaskItem[] .

Внедряет ресурс .NET Framework в выходной файл.

Элементы, передаваемые в этот параметр, могут иметь дополнительные записи метаданных с именами LogicalName и Access. LogicalName соответствует параметру identifier ключа /resource, а Access соответствует параметру accessibility-modifier. Дополнительные сведения см. в разделе /resource (внедрить файл ресурсов в выходной файл) (параметры компилятора C#).

ResponseFiles

Необязательный параметр типа String.

Задает файл ответов, содержащий команды для данной задачи. Дополнительные сведения см. в разделе @ (указание файла ответа) (параметры компилятора C#).

Sources

Необязательный параметр ITaskItem[].

Задает один или несколько исходных файлов Visual C#.

TargetType

Необязательный параметр типа String.

Задает формат выходного файла. Этот параметр может принимать одно из следующих значений: library (создается библиотека кода), exe (создается консольное приложение), module (создается модуль) или winexe (создается Windows-программа). Значение по умолчанию – library. Дополнительные сведения см. в разделе /target (указание формата выходного файла) (параметры компилятора C#).

Timeout

Необязательный параметр типа Int32.

Указывает время в миллисекундах, по истечении которого исполнение файла задания останавливается. Значение по умолчанию Int.MaxValue указывает, что тайм-аут не задан.

ToolPath

Дополнительный параметр String.

Указывает расположение, откуда задачей загружается базовый исполняемый файл (CSC.exe). Если значение этого параметра не задано, используется путь установки пакета SDK, соответствующий версии среды, в которой выполняется MSBuild.

TreatWarningsAsErrors

Необязательный параметр типа Boolean.

Если этот параметр равен true, все предупреждения обрабатываются как ошибки. Дополнительные сведения см. в разделе /warnaserror (обрабатывать предупреждения как ошибки) (параметры компилятора C#).

UseHostCompilerIfAvailable

Необязательный параметр типа Boolean.

Предписывает задаче использовать внутрипроцессный объект компилятора, если он доступен. Используется только Visual Studio.

Utf8Output

Необязательный параметр типа Boolean.

Регистрирует выходные данные компилятора в кодировке UTF-8. Дополнительные сведения см. в разделе /utf8output (отображать сообщения компилятора в кодировке UTF-8) (параметры компилятора C#).

WarningLevel

Необязательный параметр типа Int32.

Задает уровень предупреждений, которые должны отображаться компилятором. Дополнительные сведения см. в разделе /warn (выбор уровня предупреждения) (параметры компилятора C#).

WarningsAsErrors

Необязательный параметр типа String.

Задает список предупреждений, которые следует обрабатывать как ошибки. Дополнительные сведения см. в разделе /warnaserror (обрабатывать предупреждения как ошибки) (параметры компилятора C#).

Этот параметр переопределяет параметр TreatWarningsAsErrors.

WarningsNotAsErrors

Необязательный параметр типа String.

Задает список предупреждений, которые не следует обрабатывать как ошибки. Дополнительные сведения см. в разделе /warnaserror (обрабатывать предупреждения как ошибки) (параметры компилятора C#).

Этот параметр имеет смысл только в том случае, если параметр TreatWarningsAsErrors установлен равным true.

WarningLevel

Необязательный параметр типа Int32.

Задает соответствующий уровень предупреждения в диапазоне от 0 до 4. Дополнительные сведения см. в разделе /warn (выбор уровня предупреждения) (параметры компилятора C#).

Win32Icon

Необязательный параметр типа String.

Внедряет в сборку ICO-файл, который придает выходному файлу требуемый вид в проводнике Windows. Дополнительные сведения см. в разделе /win32icon (импорт ICO-файла) (параметры компилятора C#).

Win32Resource

Необязательный параметр типа String.

Внедряет файл ресурсов Win32 (RES-файл) в выходной файл. Дополнительные сведения см. в разделе /win32res (импорт файла ресурсов Win32) (параметры компилятора C#).

Пример

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

<CSC
    Sources="@(Compile)"
    OutputAssembly="$(AppName).exe"
    EmitDebugInformation="true" />

См. также

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

Задачи MSBuild

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

Справочные сведения о задачах MSBuild