SGen 工作
為指定組件中的型別建立 XML 序列化 (Serialization) 組件。 這項工作會包裝 XML 序列化程式產生器工具 (Sgen.exe)。 如需詳細資訊，請參閱 XML 序列化程式產生器工具 (Sgen.exe)。
參數
下表說明 SGen 工作的參數。
參數 |
描述 |
|---|---|
BuildAssemblyName |
必要的 String 參數。 用來產生序列化程式碼的組件。 |
BuildAssemblyPath |
必要的 String 參數。 用來產生序列化程式碼之組件的路徑。 |
DelaySign |
選擇性 Boolean 參數。 如果為 true，則指定您要完整簽章的組件。 如果為 false，則指定您只要將公開金鑰 (Public Key) 放在組件中。 除非搭配 KeyFile 或 KeyContainer 參數使用，否則這個參數不具有任何效果。 |
KeyContainer |
選擇性 String 參數。 指定保留金鑰組的容器。 這樣會將公開金鑰插入組件資訊清單 (Assembly Manifest)，以簽章組件。 然後工作將會使用私密金鑰為最後的組件簽署。 |
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 之架構版本的 SDK 安裝路徑。 |
Types |
選擇性 String[] 參數。 取得或設定要產生其序列化程式碼之特定型別的清單。 SGen 只針對這些型別產生序列化程式碼。 |
UseProxyTypes |
必要的 Boolean 參數。 如果為 true，則 SGen 工作只為 XML Web Service Proxy 型別產生序列化程式碼。 |
備註
除了以上列出的參數之外，此項工作還會繼承 ToolTaskExtension 類別中的參數，而該類別本身又繼承 ToolTask 類別。 如需這些錯誤碼的清單及其說明，請參閱 ToolTaskExtension 基底類別。