共用方式為


Soapsuds 工具 (Soapsuds.exe)

本主題專門說明舊有技術。 應該使用下列建立 XML Web Service 及 XML Web Service 用戶端: Windows Communication Foundation.

Soapsuds 工具可以協助您編譯會使用遠端處理技術與 XML Web 服務進行通訊的用戶端應用程式。Soapsuds.exe 可執行下列功能:

  • 建立描述 Common Language Runtime 組件中所公開之服務的 XML 結構描述。

  • 建立執行階段組件,以存取 XML 結構描述所描述的服務。結構描述定義可以是本機檔案,也可以動態地從網際網路下載。

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:

  1. 下載 XML Web Service 的 XML 結構描述 (這項工具的 -urltoschema 選項可讓您藉由 URL 直接參考這個結構描述)。在發行 XML Web Service 時,XML Web Service 會自動產生這些結構描述檔案。

  2. 使用 Soapsuds.exe 將 XML 結構描述轉換為執行階段組件。這個工具在產生組件時永遠都會產生原始程式碼。

  3. 當您編譯應用程式時,在您的用戶端應用程式中參考這個組件。您也必須設定遠端處理,讓您的應用程式認識這些組件中的型別是 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)

概念

XML Web Service 概觀

其他資源

.NET Framework Tools
.NET Remoting Overview
Strong Name Tool (Sn.exe)
SDK Command Prompt