Soapsuds 工具 (Soapsuds.exe)
本主題專門說明舊有技術。 應該使用下列建立 XML Web Service 及 XML Web Service 用戶端： Windows Communication Foundation.
Soapsuds 工具可以協助您編譯會使用遠端處理技術與 XML Web 服務進行通訊的用戶端應用程式。Soapsuds.exe 可執行下列功能：
建立描述 Common Language Runtime 組件中所公開之服務的 XML 結構描述。
建立執行階段組件，以存取 XML 結構描述所描述的服務。結構描述定義可以是本機檔案，也可以動態地從網際網路下載。
.gif "xd176a6c.note(zh-tw,VS.100).gif") 注意： |
|---|
| 從 .NET Framework version 3.5開始，這個工具已過時。請改為在用戶端專案中設定遠端物件 DLL 的參考。如此一來，編譯器就可以擷取中繼資料。 |
soapsuds {-url:schemaUrl | -types:type1,assemblyname[,serviceEndpoint]
[;type2,assemblyname][...]] | -is:schemafile | -ia:assemblyfile} [options]
選項
| 選項 | 說明 |
|---|---|
-domain:domain 或 -d:domain |
指定在連接到要求網域名稱進行驗證的伺服器時，所要使用的網域名稱。 |
-generatecode 或 -gc |
產生程式碼。這個選項相當於使用 -od:.，這裡附加的句號是指示程式碼應該置於目前的目錄中。 |
-httpproxyname:name 或 -hpn:name |
指定在透過 HTTP Proxy 伺服器連接到某個伺服器時，所要使用的 HTTP Proxy 名稱。 |
-httpproxyport:number 或 -hpp:number |
指定在透過 HTTP Proxy 伺服器連接到某個伺服器時，所要使用的 HTTP Proxy 連接埠號碼。 |
-inputassemblyfile:assemblyfile 或 -ia:assemblyfile |
指定輸入組件檔。這個工具會從組件匯入所有型別。當您指定輸入組件時，請勿包含 .exe 或 .dll 副檔名。 |
-inputdirectory:directory 或 -id:directory |
指定輸入動態連結程式庫 (DLL) 檔案的目錄位置。 |
-inputschemafile:schemafile 或 -is:schemafile |
指定輸入 XML 結構描述檔。 |
-nowrappedproxy 或 -nowp |
不要建立包裝的 Proxy。如果您不指定這個選項，這個工具會根據預設建立包裝的 Proxy。 |
-outputassemblyfile:assemblyfile 或 -oa:assemblyfile |
將輸出儲存到指定的組件檔。Soapsuds.exe 在產生組件時必定會產生原始程式碼。 |
-outputdirectory:outputdirectory 或 -od:outputdirectory |
將輸出儲存到指定的輸出目錄。 |
-outputschemafile:schemafile 或 -os:schemafile |
將輸出儲存到指定的 XML 結構描述檔。 |
-password:password 或 -p:password |
指定在連接至要求驗證的伺服器時，所要使用的密碼。 |
-proxynamespace:namespace 或 -pn:namespace |
指定在所產生之 Proxy 中程式碼的命名空間。只對互通性命名空間使用這個選項。 |
-sdl |
產生服務描述語言 (Service Description Language，SDL) 結構描述。如果您不指定這個選項，工具將會產生 Web 服務描述語言 (WSDL) 結構描述。如需 SDL 的詳細資訊，請參閱 Web 服務描述。 |
-serviceendpoint:URL 或 -se:URL |
指定要放置在 WSDL 檔案中之服務端點的 URL 或 URL 路徑。 |
-strongnamefile:filename 或 -sn:filename |
以 filename 中找到的金鑰組 (Key Pair) 簽署產生的組件。您可以使用強式名稱工具 (Sn.exe) 產生這個檔案。 |
-types: type1,assemblyname[,serviceEndpoint] [;type2,assemblyname[,serviceEndpoint]] [...] |
指定輸入型別清單。 |
-urltoschema:schemaURL 或 -url:schemaURL |
指定要從中擷取 XML 結構描述的 URL。 |
-username:username 或 -u:username |
指定在連接到要求驗證的伺服器時，所要使用的使用者名稱。 |
-wrappedproxy 或 -wp |
建立包裝的 Proxy。這是預設值。 |
-wsdl |
產生 WSDL 結構描述。這是預設值。如需詳細資訊，請參閱 Web 服務說明. |
備註
請依下列步驟從您的用戶端應用程式存取 XML Web Service：
下載 XML Web Service 的 XML 結構描述 (這項工具的 -urltoschema 選項可讓您藉由 URL 直接參考這個結構描述)。在發行 XML Web Service 時，XML Web Service 會自動產生這些結構描述檔案。
使用 Soapsuds.exe 將 XML 結構描述轉換為執行階段組件。這個工具在產生組件時永遠都會產生原始程式碼。
當您編譯應用程式時，在您的用戶端應用程式中參考這個組件。您也必須設定遠端處理，讓您的應用程式認識這些組件中的型別是 XML Web Service 的 Proxy。如需詳細資訊，請參閱 .NET 遠端處理概觀.
範例
以下命令會從 URL 下載結構描述，並將它儲存到 XML 檔案。
soapsuds -url:https://localhost/Service/MyService.soap?wsdl
-os:MyService.xml
以下命令會從 URL 下載結構描述，並且產生程式碼。
soapsuds -url:https://localhost/Service/MyService.soap?wsdl -gc
以下命令會從 URL 下載結構描述、將它儲存到檔案，並且產生程式碼。
soapsuds -url:https://localhost/Service/MyService.soap?wsdl
-os:StockQuote.xml -gc
以下命令會從 URL 下載結構描述、產生程式碼、進行編譯，並且產生組件。
soapsuds -url:https://localhost/Service/MyService.soap?wsdl
-oa:StockQuote.dll
以下命令會將型別轉換為結構描述，並將它儲存到檔案。
soapsuds -types:MyClass.MyMethod,Service -os:StockQuote.xml
以下命令會將型別轉換為結構描述，並且產生程式碼。
soapsuds -types:MyClass.MyMethod,Service -gc
以下命令會將型別轉換為結構描述、儲存到檔案，並且產生程式碼。
soapsuds -types:MyClass.MyMethod,Service -os:MyService.xml -gc
另請參閱
參考
Web 服務描述語言工具 (Wsdl.exe)
Web 服務探索工具 (Disco.exe)
概念
其他資源
.NET Framework Tools
.NET Remoting Overview
Strong Name Tool (Sn.exe)
SDK Command Prompt