SGen 任务
为指定程序集中的类型创建一个 XML 序列化程序集。 此任务包装 XML 序列化程序生成器工具 (Sgen.exe)。 有关更多信息,请参见 XML Serializer Generator Tool (Sgen.exe)。
参数
下表描述了 SGen 任务的参数。
Parameter |
说明 |
---|---|
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)。 如果未指定此参数,任务将使用与运行 MSBuild 的 Framework 版本对应的 SDK 安装路径。 |
Types |
可选 String[] 参数。 获取或设置要为其生成序列化代码的特定类型的列表。 SGen 将只为这些类型生成序列化代码。 |
UseProxyTypes |
必选 Boolean 参数。 如果为 true,则 SGen 任务只针对 XML Web 服务代理类型生成序列化代码。 |
备注
除了上面列出的参数,此任务还将从 ToolTaskExtension 类继承参数,此类本身从 ToolTask 类继承。 有关这些附加参数及其说明的列表,请参见 ToolTaskExtension 基类。