Share via

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, эта задача создает узел при выполнении его задачи.

См. также