SGen - задача
Создает сборку сериализации XML для типов в указанной сборке. Эта задача служит оболочкой для инструмента создания XML-сериализатора (Sgen.exe). Дополнительные сведения см. в статье Инструмент создания XML-сериализатора (Sgen.exe).
Параметры
В следующей таблице приводятся параметры задачи SGen.
| Параметр | Описание |
|---|---|
BuildAssemblyName |
Обязательный параметр String .Сборка, для которой создается код сериализации. |
BuildAssemblyPath |
Обязательный параметр String .Путь к сборке, для которой создается код сериализации. |
DelaySign |
Необязательный параметр Boolean.Значение true предписывает лишь поместить в сборку открытый ключ. Значение false предписывает создание полностью подписанной сборки.Этот параметр не оказывает никакого эффекта, если не используется вместе с параметром KeyFile или KeyContainer. |
KeyContainer |
Необязательный параметр String.Задает контейнер, хранящий пару ключей. При этом сборка будет подписана путем вставки открытого ключа в манифест сборки. Затем задача подпишет окончательную сборку с помощью закрытого ключа. |
KeyFile |
Необязательный параметр String.Указывает пару ключей или открытый ключ для подписи сборки. Компилятор вставляет открытый ключ в манифест сборки, а затем подписывает окончательную сборку закрытым ключом. |
Platform |
Необязательный параметр String.Возвращает или задает платформу компилятора, используемую для создания выходной сборки. Этот параметр может иметь значение x86, x64 или anycpu. По умолчанию — anycpu. |
References |
Необязательный параметр String[].Задает сборки, на которые ссылаются типы, требующие XML-сериализации. |
SdkToolsPath |
Необязательный параметр String.Указывает путь к средствам пакета SDK, например resgen.exe. |
SerializationAssembly |
Необязательный выходной параметр ITaskItem[] .Содержит созданную сборку сериализации. |
SerializationAssemblyName |
Необязательный параметр String.Указывает имя созданной сборки сериализации. |
ShouldGenerateSerializer |
Обязательный параметр Boolean .Если он имеет значение true, задача SGen должна создать сборку сериализации. |
Timeout |
Необязательный параметр Int32.Задает промежуток времени в миллисекундах, после которого исполняемый файл задачи прекращается. Значение по умолчанию — Int.MaxValue. Оно указывает, что период ожидания отсутствует. |
ToolPath |
Необязательный параметр String.Указывает расположение, из которого задача загружает базовый исполняемый (sgen.exe). Если этот параметр не задан, задача использует путь установки пакета SDK, соответствующий версии платформы, на которой выполняется MSBuild. |
Types |
Необязательный параметр String[].Возвращает или задает список определенных типов, для которых создается код сериализации. SGen создает код сериализации только для указанных типов. |
UseProxyTypes |
Обязательный параметр Boolean .Если он имеет значение true, задача SGen создает код сериализации только для типов прокси веб-службы XML. |
Параметры 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, эта задача создает узел при выполнении его задачи. |