如果服务和客户端应用程序使用可用 XmlSerializer 进行序列化的数据类型,则会在运行时生成并编译这些数据类型的序列化代码,从而导致启动性能降低。
注意
预生成的序列化代码只能在客户端应用程序中使用,不能在服务中使用。
通过从为应用程序编译的程序集生成必要的序列化代码,ServiceModel 元数据实用工具 (Svcutil.exe) 可提高这些应用程序的启动性能。 Svcutil.exe 会为已编译的应用程序集的服务协定中使用的所有数据生成序列化代码,该代码可使用 XmlSerializer 进行序列化。 使用 XmlSerializer 的服务和操作协定用 XmlSerializerFormatAttribute 进行标记。
生成 XmlSerializer 序列化代码
将服务或客户端代码编译为一个或多个程序集。
打开一个 SDK 命令提示符窗口。
在命令提示符处,使用下面的格式启动 Svcutil.exe 工具。
svcutil.exe /t:xmlSerializer <assemblyPath>*
assemblyPath
参数指定包含服务协定类型的程序集的路径。 Svcutil.exe 会为已编译的应用程序集的服务协定中使用的所有数据生成序列化代码,该代码可使用 XmlSerializer 进行序列化。Svcutil.exe 只能生成 C# 序列化代码。 为每个输入程序集生成一个源代码文件。 不能使用 /language 开关更改所生成代码的语言。
若要指定从属程序集的路径,请使用 /reference 选项。
通过使用下列选项之一使生成的序列化代码可供你的应用程序使用:
将生成的序列化代码编译成名为 [原始程序集].XmlSerializers.dll 的独立程序集(例如 MyApp.XmlSerializers.dll)。 您的应用程序必须能够加载该程序集,而该程序集必须使用与原始程序集相同的密钥进行签名。 如果您要重新编译原始程序集,则必须重新生成序列化程序集。
将生成的序列化代码编译成单独的程序集,并在使用 XmlSerializerAssemblyAttribute 的服务协定上使用 XmlSerializerFormatAttribute。 将 AssemblyName 或 CodeBase 属性设置为指向已编译的序列化程序集。
将生成的序列化代码编译到您的应用程序集内并将 添加到使用 的服务协定中。 不要设置 AssemblyName 或 CodeBase 属性。 默认序列化程序集假定为当前程序集。
在 Visual Studio 中生成 XmlSerializer 序列化代码
在 Visual Studio 中创建 WCF 服务和客户端项目。 然后,在客户端项目中添加服务引用。
在 serviceReference ->reference.svcmap 下客户端应用项目的 reference.cs 文件中向服务协定添加 XmlSerializerFormatAttribute。 请注意,需在解决方案资源管理器中显示所有文件才能查看这些文件。
生成客户端应用。
使用 ServiceModel 元数据实用工具 (Svcutil.exe) 通过以下命令创建预生成的序列化程序 .cs 文件:
svcutil.exe /t:xmlSerializer <assemblyPath>*
assemblyPath 参数指定 WCF 客户端程序集的路径。
如:
svcutil.exe /t:xmlSerializer wcfclient.exe
将生成 WCFClient.XmlSerializers.dll.cs 文件。
编译预生成的序列化程序集。
根据上一步中的示例,编译命令如下:
csc /r:wcfclient.exe /out:WCFClient.XmlSerializers.dll /t:library WCFClient.XmlSerializers.dll.cs
确保生成的 WCFClient.XmlSerializers.dll 与客户端应用(本例中为 WCFClient.exe)位于同一目录。
照常运行该客户端应用。 将使用预生成的序列化程序集。
示例
下面的命令为 XmlSerializer
类型生成程序集中所有服务协定使用的序列化类型。
svcutil /t:xmlserializer myContractLibrary.exe