WCF 測試用戶端 (WcfTestClient.exe)

發行項
09/12/2008

Windows Communication Foundation (WCF) 測試用戶端 (WcfTestClient.exe) 是一種 GUI 工具，可以讓使用者用來輸入測試參數、將該輸入送出至服務，以及檢視服務傳回的回應。與 WCF 服務主機搭配時，可以提供順暢無礙的服務測試經驗。

使用測試用戶端的案例

下列各節將討論一些可使用 WCF 測試用戶端簡化開發程序的最常見案例。

在 Visual Studio 內部

WCF 服務主機啟動具有單一服務的 WCF 測試用戶端

在您建立新的 WCF 服務專案並按下 F5 啟動偵錯工具之後，WCF 服務主機會開始裝載專案中的服務。然後，WCF 測試用戶端便會開啟，並顯示組態檔中定義之服務端點的清單。您可以測試參數並叫用服務，然後重複這個程序以持續測試及驗證服務。

WCF 服務主機啟動具有多個服務的 WCF 測試用戶端

您也可以使用 WCF 測試用戶端協助偵錯包含多個服務的服務專案。當 WCF 測試用戶端開啟時，它會自動在您的專案中逐一查看服務清單，並開啟這些服務以進行測試。

在 Visual Studio 外部

您也可以在 Visual Studio 外部叫用 WCF 測試用戶端 (WcfTestClient.exe)，測試網際網路上的任意服務。若要找出該工具，請移至下列位置：

C:\Program Files\Microsoft Visual Studio 9.0\Common7\IDE\

若要使用該工具，按兩下檔名即可從這個位置開啟，或者是從命令列進行啟動。

WCF 測試用戶端可以採用任意數目的 URI 做為命令列引數。這些引數是可以測試的服務 URI。

wcfTestClient.exe URI1 URI2 …

開啟 [WCF 測試用戶端] 視窗後，按一下 [檔案] -> [新增服務]，並輸入要開啟服務的端點位址。

WCF 測試用戶端使用者介面

您可以搭配單一服務或多個服務使用 WCF 測試用戶端。

服務作業

WCF 測試用戶端主視窗的左窗格會列出所有可用的服務，以及它們各自的端點和作業。

按兩下某項作業時，您可以在右窗格中具有該作業名稱的新索引標籤內，檢視其內容。

左窗格還會列出用戶端組態檔。按兩下任何項目，即可在右窗格中新出現的索引視窗上看見檔案的內容。

輸入測試參數

若要檢視測試參數，請按兩下作業在右窗格中開啟它，然後按一下 [已格式化]。若要檢視訊息的 XML，請按一下 [XML]。當您按一下 [已格式化] 時，可以為參數輸入任意值來測試服務。若要將參數傳送至服務，請按一下 [叫用]。

服務的回應會出現在測試參數下方。

注意：
如果預期的傳回值是字串，則結果會顯示為引號括住的字串，即使提供的輸入並未以引號括住。

如果您在建立服務合約時將特定作業指定為單向，就不會顯示任何服務回應。訊息一旦排入佇列中準備傳遞，快顯對話方塊就會出現，通知您已成功傳送訊息。

工作階段支援

服務作業索引標籤中的 [啟動新 Proxy] 核取方塊，可以讓您切換工作階段支援。依照預設，這個方塊為取消核取狀態。

在針對特定作業 (或是相同服務端點中的其他作業) 輸入測試參數時，並在取消核取該核取方塊的情況下多次按下 [叫用]，則這些作業會共用一個 Proxy，並且會在多個作業間保存服務狀態。

如果有核取 [啟動新 Proxy] 核取方塊，則會針對每個 [叫用] 啟動新的 Proxy，稍早的工作階段會結束並重設服務狀態。

編輯用戶端組態

WCF 測試用戶端主視窗的左窗格會列出用戶端組態檔。按兩下任何項目，即可在右窗格中顯示檔案的內容。

使用服務組態編輯器進行編輯

以滑鼠右鍵按一下左窗格中的 [組態檔]，並選取內容功能表 [使用 SvcConfigEditor 編輯]。服務組態編輯器隨即啟動，並顯示用戶端組態內容。您可以在該工具內編輯組態並進行儲存。

在服務組態編輯器中儲存檔案後，WCF 測試用戶端會顯示警告訊息，通知您檔案已在外部經過修改並詢問您是否要重新載入。

如果選取 [是]，[Client.dll.config] 索引標籤中的組態內容會反映出您在編輯器中進行的變更。

如果選取 [否]，[Client.dll.config] 索引標籤中的組態內容會維持不變，而修改過的內容會自動儲存到原始程式檔中。

還原至預設組態

如果要取消所有變更並還原為預設用戶端組態，以滑鼠右鍵按一下左窗格中的 [組態檔]，並選取內容功能表 [還原至預設組態]。預設組態值隨即載入，並會還原 [Client.dll.config] 索引標籤中的內容。

驗證變更

在 WCF 測試用戶端中載入儲存的變更時，會針對 WCF 結構描述檢查組態是否有效。如果發現錯誤，會顯示對話方塊說明錯誤詳細資料。

在 Proxy 產生、二進位編譯或服務叫用期間，會停用支援編輯 (也就是編輯、還原等等) 的功能表項目。將更新過的組態載入至 WCF 測試用戶端時，也會停用服務叫用。

保存用戶端組態

[工具] -> [選項] -> [用戶端組態] 索引標籤包含預設為啟用的 [啟動服務時永遠重新產生組態] 選項。這個選項表示每當 WCF 測試用戶端載入服務時，會依據最新的服務合約和服務 App.config 檔案，重新產生組態檔。

如果您已經編輯過 WCF 服務的用戶端組態，並想要永遠使用這個更新檔來偵錯服務，您可以取消核取這個重新產生選項。如此一來，即使在您更新服務並重新開啟 WCF 測試用戶端時，Client.dll.config 檔案仍然是您先前更新過的檔案，而非依據更新服務所重新產生的檔案。

但是，您可能需要編輯組態檔，讓其跟重新產生的 Proxy 一致。如果重新產生的 Proxy 和組態檔因更新服務而不相符，則在叫用服務時將發生錯誤。

注意：
如果您修改過用戶端組態檔並選擇供往後重複使用，則可以在下列位置找到該檔案： \Documents and Settings\[User Account]\My Documents\Test Client Projects 任何儲存在用戶端組態檔中經過更新的認證資訊，皆受到這個資料夾的存取控制清單 (ACL) 所保護。

如果您修改過用戶端組態檔並選擇供往後重複使用，則可以在下列位置找到該檔案：

\Documents and Settings\[User Account]\My Documents\Test Client Projects

任何儲存在用戶端組態檔中經過更新的認證資訊，皆受到這個資料夾的存取控制清單 (ACL) 所保護。

新增、移除和重新整理服務

新增服務

按一下 [檔案] -> [新增服務]，將服務新增至 WCF 測試用戶端。接著會要求您輸入要新增之服務的 URI (端點位址)。服務位址可以是 Mex 位址或 WSDL 位址。

您也可以在 [最近使用的服務] 子功能表中，找到 10 個最近新增的服務端點清單。如果選取其中一個服務，該指定服務就會加入到 WCF 測試用戶端中。

您也可以滑鼠右鍵按一下服務樹狀目錄 [我的服務專案] 的根，並選取 [新增服務]，以達成相同結果。

在 Proxy 產生、二進位編譯或服務叫用期間，會停用支援新增服務的功能表項目。同時也會停用服務叫用。

移除服務

以滑鼠右鍵按一下要移除之服務的服務根，並選取 [移除服務]，即可從 WCF 測試用戶端移除服務。

在 Proxy 產生、二進位編譯或服務叫用期間，會停用支援移除服務的功能表項目。同時也會停用服務叫用。

重新整理服務

如果在 WCF 測試用戶端執行當中變更過服務，而您想要確認該服務的 WCF 測試用戶端實作是最新的，請以滑鼠右鍵按一下服務的服務根，並選取 [重新整理服務]。請注意，重新整理後會重設服務狀態。

在 Proxy 產生、二進位編譯或服務叫用期間，會停用支援重新整理服務的功能表項目。同時也會停用服務叫用。

測試用戶端產生的檔案位置

根據預設，WCF 測試用戶端會將產生的用戶端程式碼和組態檔儲存在 "%appdata%\Local\temp\Test Client Projects" 資料夾。在 WCF 測試用戶端結束後，便會刪除這個資料夾。如果在 WCF 測試用戶端中修改組態檔，並且是在停用 [啟動服務時永遠重新產生組態] 選項的情況下，修改過的檔案會複製到 "My Documents\Test Client Projects Documents\Test Client Projects" 下的 "Cached Config" 資料夾，並會有對應的 (metadata-address-to-file-name) XML 檔案做為索引。

您也可以在命令列啟動 WCF 測試用戶端，使用 /ProjectPath 參數指定用於儲存產生檔案的新目標路徑，或是使用 /RestoreProjectPath 參數還原預設位置。語法如下：

wcfTestClient.exe /ProjectPath [desired location]

執行這個命令並不會開啟 WCF 測試用戶端，只是會變更資料夾位置。不論 WCF 測試用戶端是否正在執行，都可以執行這個命令。新的位置會在重新啟動 WCF 測試用戶端時套用。有關位置的資訊可以儲存在登錄中，或者是 "%appdata%\Local\temp\Test Client Projects" 資料夾的 "WcfTestClient.exe.option" 檔案中。

WCF 測試用戶端支援的功能

下列為 WCF 測試用戶端支援的功能清單：

服務叫用：要求/回應和單向訊息。
繫結：Svcutil.exe 支援的所有繫結。
控制工作階段。
訊息合約。
XML 序列化。

下列為 WCF 測試用戶端不支援的功能清單：

型別：實作 IXmlSerializable 介面和相關 XmlSchemaProviderAttribute 屬性的型別 (Stream、Message、XmlElement、XmlAttribute、XmlNode)、XDocument 和 XElement 型別、ADO.NET DataTable 型別和 DataSet 型別 (以及其具型別的衍生類別)。
雙工合約。
交易。
安全性：CardSpace、憑證和使用者名稱/密碼。
繫結：WSFederationbinding、任何 Context 繫結和 Https 繫結、WebHttpbinding (Json 回應訊息支援)。

關閉 WCF 測試用戶端

您可以透過下列方式關閉 WCF 測試用戶端：

在 [檔案] 功能表上按一下 [結束]。或者，在 WCF 測試用戶端主視窗中按一下 [關閉]。如果 WCF 測試用戶端是由 Visual Studio 啟動的，這兩個動作也會關閉 WCF 服務自動主機並停止 Visual Studio 偵錯程序。
以滑鼠右鍵按一下通知區域中的 [WCF 服務主機] 圖示，然後按一下 [結束]。這會同時關閉 WCF 服務自動主機和 WCF 測試用戶端，並且停止 Visual Studio 偵錯程序。

請參閱

概念

WCF 服務主機 (WcfSvcHost.exe)

Share via