作法:使用 XmlSerializer 改善 WCF 用戶端應用程式的啟動時間
使用資料型別 (可使用 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 屬性設定為指向已編譯的序列化組件。
將產生的序列化程式碼編譯至應用程式組件,並將 XmlSerializerAssemblyAttribute 加入至可使用 XmlSerializerFormatAttribute 的服務合約。 請勿設定 AssemblyName 或 CodeBase 屬性。 預設的序列化組件會假設為目前的組件。
若要在 Visual Studio 中產生 XmlSerializer 序列化程式碼
在 Visual Studio 中建立 WCF 服務與用戶端專案。 然後,將服務參考新增至用戶端專案。
將 XmlSerializerFormatAttribute 新增至 serviceReference ->reference.svcmap 下用戶端應用程式專案中 reference.cs 檔案的服務合約。 請注意,您必須顯示 [方案總管] 中的所有檔案,才能查看這些檔案。
建置用戶端應用程式。
使用 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