大网数据广告活动
.NET 与 C# 开发

XML 序列化程序生成器工具 (Sgen.exe)

· 52CE 我爱测

XML 序列化程序生成器为指定程序集中的类型创建一个 XML 序列化程序集,以改进 在序列化或反序列化指定类型的对象时的启动性能。

XML 序列化程序生成器为指定程序集中的类型创建一个 XML 序列化程序集,以改进 xref:System.Xml.Serialization.XmlSerializer 在序列化或反序列化指定类型的对象时的启动性能。

语法

sgen [options]  

参数

选项 描述
/a[ssembly]:filename 为由 filename 指定的程序集或可执行文件中包含的所有类型生成序列化代码。 只能提供一个文件名。 如果该参数重复,将使用最后一个文件名。
/c[ompiler]:options 指定要传递给 C# 编译器的选项。 支持所有传递到编译器的 csc.exe 选项。 这可用于指定应该对程序集进行签名,以及用于指定密钥文件。
/d[ebug] 生成一个可用于调试器的映像。
/f[orce] 强制覆盖同名的现有程序集。 默认值为 false。
/help 或 /? 显示该工具的命令语法和选项。
/k[eep] 取消在生成的源文件和其他临时文件编译到序列化程序集内之后对它们的删除操作。 这可用于确定工具是否正在为某个特定类型生成序列化代码。
/n[ologo] 取消显示 Microsoft 启动版权标志。
/o[ut]:path 指定要在其中保存生成的程序集的目录。 注意: 生成的程序集的名称由输入程序集的名称加上“xmlSerializers.dll”组成。
/p[roxytypes] 仅生成 XML Web services 代理类型的序列化代码。
/r[eference]:assemblyfiles 指定由需要 XML 序列化的类型引用的程序集。 接受多个程序集文件(由逗号分隔)。
/s[ilent] 取消显示成功消息。
/t[ype]:type 仅生成指定类型的序列化代码。
/v[erbose] 显示详细输出,以进行调试。 列出目标程序集中无法使用 xref:System.Xml.Serialization.XmlSerializer 进行序列化的类型。
/? 显示该工具的命令语法和选项。

备注

不使用 XML 序列化程序生成器时,xref:System.Xml.Serialization.XmlSerializer 在应用程序每次运行时为每个类型生成序列化代码和一个序列化程序集。 若要提高性能的 XML 序列化启动,使用 Sgen.exe 工具预先生成这些程序集。 然后可以使用应用程序部署这些程序集。

XML 序列化程序生成器还可以改进使用 XML Web services 代理与服务器通信的客户端的性能,因为在第一次加载类型时,序列化进程将不会导致性能受损。

这些生成的程序集无法在 Web 服务的服务器端使用。 该工具仅能用于 Web 服务客户端和手动序列化方案。

如果包含要序列化的类型的程序集名为 MyType.dll,则关联的序列化程序集的名称将为 MyType.XmlSerializers.dll。

示例

下面的命令创建一个名为 Data.XmlSerializers.dll 的程序集,用于序列化名为 Data.dll 的程序集中包含的所有类型。

sgen Data.dll   

可以从代码中引用需要序列化和反序列化 Data.dll 中的类型的 Data.XmlSerializers.dll 程序集。

请参阅

历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / .NET 中文文档历史快照
适用范围
历史中文快照 2019-08-18;详见原文产品版本;文档日期 03/30/2017
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。