SGen 任务

为指定程序集中的类型创建一个 XML 序列化程序集。 此任务包装 XML 序列化程序生成器工具 (Sgen.exe)。 有关更多信息,请参见 XML Serializer Generator Tool (Sgen.exe)

参数

下表描述了 SGen 任务的参数。

Parameter

说明

BuildAssemblyName

必选 String 参数。

要为其生成序列化代码的程序集。

BuildAssemblyPath

必选 String 参数。

要生成序列化代码的程序集的路径。

DelaySign

可选 Boolean 参数。

如果为 true,表示您需要完全签名的程序集。 如果为 false,则表示您只希望将公钥放入程序集中。

除非与 KeyFileKeyContainer 参数一起使用,否则此参数无效。

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)。 如果未指定此参数,任务将使用与运行 MSBuild 的 Framework 版本对应的 SDK 安装路径。

Types

可选 String[] 参数。

获取或设置要为其生成序列化代码的特定类型的列表。 SGen 将只为这些类型生成序列化代码。

UseProxyTypes

必选 Boolean 参数。

如果为 true,则 SGen 任务只针对 XML Web 服务代理类型生成序列化代码。

备注

除了上面列出的参数,此任务还将从 ToolTaskExtension 类继承参数,此类本身从 ToolTask 类继承。 有关这些附加参数及其说明的列表,请参见 ToolTaskExtension 基类

请参见

概念

MSBuild 任务

其他资源

MSBuild 任务参考

MSBuild 概念