Csc - задача
Использует программу-оболочку для файла csc.exe и создает исполняемые файлы (EXE-файлы), библиотеки динамической компоновки (DLL-файлы) или модули кода (NETMODULE-файлы). Дополнительные сведения о программе csc.exe см. в разделе Параметры компилятора C#.
Параметры
В следующей таблице приводятся параметры задачи Csc.
| Параметр | Описание |
|---|---|
AdditionalLibPaths |
Необязательный параметр String[].Задает дополнительные каталоги для поиска ссылок. Дополнительные сведения см. в разделе -lib (параметры компилятора C#). |
AddModules |
Необязательный параметр String.Задает один или несколько модулей, которые должны быть частью сборки. Дополнительные сведения см. в разделе -addmodule (параметры компилятора C#). |
AllowUnsafeBlocks |
Необязательный параметр Boolean.Если этот параметр равен true, то компилируется код, в котором используется ключевое слово unsafe. Дополнительные сведения см. в разделе -unsafe (параметры компилятора C#). |
ApplicationConfiguration |
Необязательный параметр String.Задает файл конфигурации приложения, содержащий параметры привязки сборки. |
BaseAddress |
Необязательный параметр String.Указывает предпочтительный базовый адрес для загрузки DLL. Базовый адрес по умолчанию для библиотеки DLL задается в среде CLR платформы .NET Framework. Дополнительные сведения см. в разделе -baseaddress (параметры компилятора C#). |
CheckForOverflowUnderflow |
Необязательный параметр Boolean.Указывает, должны ли целочисленные арифметические операции, вызывающие переполнение типа данных, вызывать исключение во время выполнения. Дополнительные сведения см. в разделе -checked (параметры компилятора C#). |
ChecksumAlgorithm |
Необязательный параметр String.Задает алгоритм вычисления исходного файла проверка sum, хранящегося в PDB-файле. Алгоритм должен быть SHA1 (по умолчанию) или SHA256. См. раздел "Контрольная сумма". |
CodeAnalysisRuleset |
Необязательный параметр String. Указывает файл набора правил, который отключает определенные диагностики. См. раздел CodeAnalysisRuleset. |
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#). |
Deterministic |
Необязательный параметр Boolean.Если задано значение true, компилятор будет выдавать сборку, чье двоичное содержимое идентично в разных компиляциях, если входные данные идентичны.Дополнительные сведения см. в разделе -deterministic (параметры компилятора C#). |
DisabledWarnings |
Необязательный параметр String.Задает список предупреждений, которые следует отключить. Дополнительные сведения см. в разделе -nowarn (параметры компилятора C#). |
DocumentationFile |
Необязательный параметр String.Обрабатывает комментарии к документации в XML-файл. Дополнительные сведения см. в разделе -doc (параметры компилятора C#). |
EmbedAllSources |
Необязательный параметр Boolean.Внедрение всех исходных файлов в PDB-файл. Дополнительные сведения см. в разделе -embed (параметры компилятора C#). |
EmitDebugInformation |
Необязательный параметр Boolean.Если этот параметр равен true, задача генерирует отладочную информацию и помещает ее в файл базы данных программы (PDB-файл). Если задано значение false, задача не генерирует отладочную информацию. По умолчанию — false. Дополнительные сведения см. в разделе -debug (параметры компилятора C#). |
ErrorLog |
Необязательный параметр String.Указывает файл для записи всех компиляторов и анализаторов диагностика. См . журнал ошибок. |
ErrorReport |
Необязательный параметр String.Предоставляет удобный способ для сообщения о внутренней ошибке C# в корпорацию Майкрософт. Этот параметр может иметь значение prompt, send или none. Если установлено значение prompt, в случае внутренней ошибки компилятора будет выведено сообщение с предложением отправить электронный отчет об ошибке в корпорацию Майкрософт. Если установлено значение send, сообщение об ошибке отправляется автоматически. Если установлено значение none, отчет об ошибке выводится только в текстовых выходных данных компилятора. По умолчанию — none. Дополнительные сведения см. в разделе -errorreport (параметры компилятора C#). |
FileAlignment |
Необязательный параметр Int32.Задает размер разделов в выходном файле. Дополнительные сведения см. в разделе -filealign (параметры компилятора C#). |
GenerateFullPaths |
Необязательный параметр Boolean.Если этот параметр равен true, то в выходных данных компилятора задается абсолютный путь к файлу. Если установлено значение false, задается имя файла. По умолчанию — false. Дополнительные сведения см. в разделе -fullpaths (параметры компилятора C#). |
HighEntropyVA |
Необязательный параметр Boolean.Включите выборку макета пространства адресов с высокой энтропией (ASLR). См. раздел HighEntropyVA. |
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 (параметры компилятора C#). |
MainEntryPoint |
Необязательный параметр String.Указывает расположение метода Main. Дополнительные сведения см. в разделе -main (параметры компилятора C#). |
ModuleAssemblyName |
Необязательный параметр String.Задает имя сборки, частью которой будет этот модуль. |
NoConfig |
Необязательный параметр Boolean.Значение true предписывает компилятору не использовать файл csc.rsp. Дополнительные сведения см. в разделе -noconfig (параметры компилятора C#). |
NoLogo |
Необязательный параметр Boolean.Если этот параметр равен true, отображение заголовка компилятора отключается. Дополнительные сведения см. в разделе -nologo (параметры компилятора C#). |
NoStandardLib |
Необязательный параметр Boolean.Значение true отключает импорт библиотеки mscorlib.dll, определяющей все пространство имен System. Используйте этот параметр, если вы хотите определить или создать собственное пространство имен System и соответствующие объекты. Дополнительные сведения см. в разделе -nostdlib (параметры компилятора C#). |
NoWin32Manifest |
Необязательный параметр Boolean.Если значение true, манифест Win32 по умолчанию не включается. |
Nullable |
Необязательный параметр String.Указывает контекст, допускающий значение NULL. Аргумент должен иметь одно из следующих значений: enable, disable, warnings или annotations. См. раздел NULL. |
Optimize |
Необязательный параметр Boolean.Значение true включает оптимизации. Значение false отключает оптимизации. Дополнительные сведения см. в разделе -optimize (параметры компилятора C#). |
OutputAssembly |
Необязательный выходной параметр String .Указывает имя выходного файла. Дополнительные сведения см. в разделе -out (параметры компилятора C#). |
OutputRefAssembly |
Необязательный параметр String.Задает имя выходного файла базовой сборки. Дополнительные сведения см. в разделе -refout (параметры компилятора C#). |
PathMap |
Необязательный параметр String.Определяет способ сопоставления физических путей и выходных имен исходных путей компилятором. См . pathMap. |
PdbFile |
Необязательный параметр String.Задает имя файла отладочной информации. По умолчанию используется имя файла выходных данных с расширением .pdb. |
Platform |
Необязательный параметр String.Указывает целевую платформу процессора для выходного файла. Этот параметр может иметь значение x86, x64 или anycpu. По умолчанию — anycpu. Дополнительные сведения см. в разделе -platform (параметры компилятора C#). |
PreferredUILang |
Необязательный параметр String. Указывает язык, в котором компилятор C# отображает выходные данные, такие как сообщения об ошибках. См . раздел PreferredUILang. |
PublicSign |
Необязательный параметр Boolean. Публично подписывая выходную сборку. См. раздел PublicSign. |
References |
Необязательный параметр ITaskItem[].Вызывает импорт задачей информации об открытых типах из заданных элементов в текущий проект. Дополнительные сведения см. в разделе -reference (параметры компилятора C#). Вы можете задать псевдоним ссылки C# в файле MSBuild, добавив метаданные Aliases к исходному элементу "Reference". Например, требуется установить псевдоним LS1 в следующей командной строке CSC.CSC /r:LS1=MyCodeLibrary.dll /r:LS2=MyCodeLibrary2.dll *.csДля этого используется следующий код. <Reference Include="MyCodeLibrary"> <Aliases>LS1</Aliases> </Reference> |
RefOnly |
Необязательный параметр Boolean.Создадим эталонную сборку вместо полной сборки в качестве основного выходных данных. См. раздел ProduceOnlyReferenceAssembly. |
ReportAnalyzer |
Необязательный параметр Boolean.Включение в отчет дополнительных сведений об анализаторе, включая время выполнения. См . отчетAnalyzer. |
Resources |
Необязательный параметр ITaskItem[].Внедряет ресурс .NET Framework в выходной файл. Элементы, передаваемые в этот параметр, могут иметь необязательные метаданные LogicalName и Access. LogicalName соответствует аргументу identifier параметра /resource, а Access соответствует аргументу accessibility-modifier. Дополнительные сведения см. в разделе -resource (параметры компилятора C#). |
ResponseFiles |
Необязательный параметр String.Задает файл ответов, содержащий команды для этой задачи. Дополнительные сведения см. в документации синтаксиса @ (указание файла ответа). |
Sources |
Необязательный параметр ITaskItem[].Указывает один или несколько исходных файлов C#. |
TargetType |
Необязательный параметр String.Задает формат выходного файла. Этот параметр может принимать одно из следующих значений: library (создается библиотека кода), exe (создается консольное приложение), module (создается модуль) или winexe (создается программа Windows). Значение по умолчанию — library. Дополнительные сведения см. в разделе -target (параметры компилятора C#). |
TreatWarningsAsErrors |
Необязательный параметр Boolean.Если этот параметр равен true, все предупреждения обрабатываются как ошибки. Дополнительные сведения см. в разделе -warnaserror (параметры компилятора C#). |
UseHostCompilerIfAvailable |
Необязательный параметр Boolean.Предписывает задаче использовать внутрипроцессный объект компилятора, если он доступен. Используется только в Visual Studio. |
Utf8Output |
Необязательный параметр Boolean.Регистрирует выходные данные компилятора в кодировке UTF-8. Дополнительные сведения см. в разделе -utf8output (параметры компилятора C#). |
WarningLevel |
Необязательный параметр Int32.Задает уровень предупреждений, которые должны отображаться компилятором. Дополнительные сведения см. в разделе -warn (параметры компилятора C#). |
WarningsAsErrors |
Необязательный параметр String.Задает список предупреждений, которые следует обрабатывать как ошибки. Дополнительные сведения см. в разделе -warnaserror (параметры компилятора C#). Этот параметр переопределяет параметр TreatWarningsAsErrors. |
WarningsNotAsErrors |
Необязательный параметр String.Задает список предупреждений, которые не следует обрабатывать как ошибки. Дополнительные сведения см. в разделе -warnaserror (параметры компилятора C#). Этот параметр имеет смысл только в том случае, если для параметра TreatWarningsAsErrors задано значение true. |
Win32Icon |
Необязательный параметр String.Вставляет файл ICO в сборку, которая придает выходному файлу необходимый вид в проводнике. Дополнительные сведения см. в разделе -win32icon (параметры компилятора C#). |
Win32Manifest |
Необязательный параметр String.Задает манифест Win32, который требуется включить. |
Win32Resource |
Необязательный параметр String.Вставляет файл ресурсов Win32 (RES-файл) в выходной файл. Дополнительные сведения см. в разделе -win32res (параметры компилятора C#). |
Параметры ToolTaskExtension
Эта задача наследуется от класса ToolTaskExtension, который наследуется от класса ToolTask, который, в свою очередь, наследуется от класса Task. Эта цепочка наследования добавляет несколько параметров в задачи, которые от них происходят.
В следующей таблице описываются параметры базовых классов:
| Параметр | Описание |
|---|---|
| EchoOff | Необязательный параметр bool.Если задано значение true, то задача передает /Q в командную строку cmd.exe и командная строка не копируется в stdout. |
| EnvironmentVariables | Необязательный параметр массива String.Массив определений переменных среды, разделенных точкой с запятой. Каждое определение должно содержать имя и значение переменной среды, разделенные знаком равенства. Эти переменные частично передаются в порожденный исполняемый файл, дополняя или выборочно переопределяя обычный блок среды. Например, Variable1=Value1;Variable2=Value2. |
| ExitCode | Необязательный выходной параметр Int32, доступный только для чтения.Задает код выхода, предоставляемый выполняемой командой. Если задача зарегистрировала какие-либо ошибки, но процесс имеет код выхода 0 (успешное завершение), этот параметр имеет значение -1. |
| LogStandardErrorAsError | Необязательный параметр bool.Если он имеет значение true, то все сообщения, полученные в стандартном потоке ошибок, регистрируются как ошибки. |
| StandardErrorImportance | Необязательный параметр String.степень важности, с которой текст из стандартного потока ошибок следует регистрировать в журнале. |
| StandardOutputImportance | Необязательный параметр String.Степень важности, с которой текст из стандартного выходного потока следует регистрировать в журнале. |
| Timeout | Необязательный параметр Int32.Задает промежуток времени в миллисекундах, после которого исполняемый файл задачи прекращается. Значение по умолчанию — Int.MaxValue. Оно указывает, что период ожидания отсутствует. Время ожидания в миллисекундах. |
| ToolExe | Необязательный параметр string.Он может реализовываться в проектах для переопределения параметра ToolName. Задачи могут переопределять его для сохранения параметра ToolName. |
| ToolPath | Необязательный параметр string.Указывает расположение, откуда задача загружает базовый исполняемый файл. Если этот параметр не задан, задача использует путь установки пакета SDK, соответствующий версии платформы, на которой выполняется MSBuild. |
| UseCommandProcessor | Необязательный параметр bool.Если задано значение true, эта задача создает пакетный файл для командной строки и выполняет его с помощью командного процессора вместо непосредственного выполнения команды. |
| YieldDuringToolExecution | Необязательный параметр bool.Если задано значение true, эта задача создает узел при выполнении его задачи. |
Пример
В следующем примере задача Csc используется для компиляции исполняемого файла из исходных файлов в коллекции элементов Compile.
<CSC
Sources="@(Compile)"
OutputAssembly="$(AppName).exe"
EmitDebugInformation="true" />