WCF 服務主機 (WcfSvcHost.exe)

Windows Communication Foundation (WCF) 服務主機 (WcfSvcHost.exe) 可讓您啟動 Visual Studio 偵錯工具 (F5) 來自動裝載並測試您已實作的服務。 然後,您可以使用 WCF 測試用戶端 (WcfTestClient.exe) 或自己的用戶端來測試服務,以尋找並修正任何可能的錯誤。

WCF 服務主機

WCF 服務主機會列舉 WCF 服務專案中的服務、載入專案的組態,以及為它找到的每一個服務產生主機的實體。 這項工具已透過 WCF 服務範本整合在 Visual Studio 中,而且當您開始對專案進行偵錯時就會自動叫用它。

藉由使用 WCF 服務主機,您就可以在開發期間裝載 WCF 服務 (在 WCF 服務程式庫專案中),而不需要撰寫額外的程式碼或認可特定主機。

注意

WCF 服務主機不支援部分信任。 如果您想要在部分信任情況下使用 WCF 服務,請勿使用 Visual Studio 中的 WCF 服務程式庫專案範本來建置服務。 反之,請選擇 WCF 服務網站範本在 Visual Studio 中建立新的網站,如此可在支援 WCF 部分信任的 Web 伺服器裝載服務。

WCF 服務主機裝載的專案類型

WCF 服務主機可以裝載下列 WCF 服務程式庫專案類型:WCF 服務程式庫、循序工作流程服務程式庫、狀態機器工作流程服務程式庫和新聞訂閱服務程式庫。 WCF 服務主機也能裝載那些可以使用新增項目功能新增至服務程式庫專案的服務。 這包括 WCF 服務、WF 狀態機器服務、WF 循序服務、XAML WF 狀態機器服務和 XAML WF 循序服務。

但是,您應該注意到,此工具無法協助您設定主機。 對於這項工作,您必須手動編輯 App.config 檔案。 此工具也不會驗證使用者定義的組態檔。

警告

您不可以在實際執行環境中使用 WCF 服務主機來裝載服務,因為它不是為了這個用途而設計的。 WCF 服務主機不支援這類環境的可靠性、安全性和管理便利性需求。 請改用 IIS,因為它提供比較好的可靠性和監視功能,而且是一般慣用於裝載服務的解決方案。 服務一旦開發完成,您就應該將它從 WCF 服務主機移轉至 IIS。

在 Visual Studio 內使用 WCF 服務主機的案例

下表列出 [命令列引數] 對話方塊中的所有參數;在 Visual Studio 的 [方案總管] 中,以滑鼠右鍵按一下您的專案,選取 [屬性],然後選取 [偵錯] 索引標籤,再按一下 [起始專案],就可以看到這個對話方塊。 這些參數在設定 WCF 服務主機時十分有用。

參數 意義
/client 選擇性參數,會指定要在裝載服務後執行之可執行檔的路徑。 這會在裝載之後啟動 WCF 測試用戶端。
/clientArg 會指定字串做為傳遞給自訂用戶端應用程式的引數。
/? 顯示說明文字。

使用 WCF 測試用戶端

在您建立新的 WCF 服務專案並按下 F5 啟動偵錯工具之後,WCF 服務主機會開始裝載它在專案中找到的所有服務。 WCF 測試用戶端會自動開啟,並顯示組態檔中定義之服務端點的清單。 您可以從主視窗中測試參數並叫用服務。

為了確認會使用 WCF 測試用戶端,請在 Visual Studio 中的 [方案總管] 內以滑鼠右鍵按一下您的專案,依序選取 [屬性] 和 [偵錯] 索引標籤。按一下 [起始專案],並確認以下項目有出現在 [命令列引數] 對話方塊中。

/client:WcfTestClient.exe

使用自訂用戶端

若要使用自訂用戶端,請在 的 [方案總管] 中,以滑鼠右鍵按一下您的專案,然後選取 [屬性],再選取 [偵錯] 索引標籤。按一下 [起始專案],再編輯 [命令列的引數] 對話方塊中的 /client 參數,以指向您的自訂用戶端,如下列範例所示。

/client:"path/CustomClient.exe"

按下 F5 再次啟動服務之後,WCF 服務主機就會在您啟動偵錯工具時自動啟動自訂用戶端。

您也可以使用 /clientArg: 參數,指定字串做為傳遞給自訂用戶端應用程式的引數,如下列範例所示。

/client:"path/CustomClient.exe" /clientArg:"arguments that are passed to Client"

例如,如果您使用新聞訂閱服務程式庫範本,就可以使用下列命令列引數:

/client:iexplore.exe /clientArgs:http://localhost:8731/Design_Time_Addresses/Feed1/

不指定任何用戶端

如要指定不會在 WCF 服務裝載之後使用任何用戶端,請在 Visual Studio 中的 [方案總管] 內以滑鼠右鍵按一下您的專案,依序選取 [屬性] 和 [偵錯] 索引標籤。按一下 [起始專案],並將 [命令列引數] 對話方塊留空。

使用自訂主機

若要使用自訂主機,請在 Visual Studio 的 [方案總管] 中,以滑鼠右鍵按一下您的專案,然後選取 [屬性],再選取 [偵錯] 索引標籤。按一下 [起始外部計劃] 並輸入自訂主機的完整路徑。 您也可以使用 [命令列引數] 對話方塊來指定要傳遞至主機的引數。

WCF 服務主機使用者介面

當您初次叫用 WCF 服務主機 (在 Visual Studio 內按下 F5) 時,[WCF 服務主機] 視窗會自動開啟。 當 WCF 服務主機正在執行時,程式的圖示會出現在通知區域中。 您可以按兩下圖示來開啟 [WCF 服務主機] 視窗

如果在服務裝載期間發生錯誤,[WCF 服務主機] 對話方塊將會開啟以顯示相關的資訊。

[WCF 服務主機] 主視窗包含兩個功能表:

  • 檔案:包含 [關閉] 和 [結束] 命令。 當您按一下 [關閉] 時,[WCF 服務主機] 對話方塊雖會關閉,但是服務仍在裝載中。 當您按一下 [結束] 時,也會關閉 WCF 服務主機。 這還會停止所有裝載的服務。

  • 說明:包含附有版本資訊的 [關於] 命令。 它也包含可以開啟說明檔的 Help 命令。

[WCF 服務主機] 主視窗包含兩個區域:

  • 第一個區域是 [服務]。 其中包含一份顯示所有服務基本資訊的清單。 這些資訊包括:

    • 服務:列出所有的服務。

    • 狀態:列出服務的狀態。 有效值為 "Started"、"Stopped" 和 "Error"。

    • 中繼資料位址:顯示服務的中繼資料位址。

  • 第二個區域是 [其他資訊]。 它會在您選取 [服務] 區域中的特定服務行時,顯示服務狀態的詳細說明。 如果狀態為「錯誤」,您就可以在螢幕上檢視完整的錯誤訊息。

停止 WCF 服務主機

您可以透過下列四種方式關閉 WCF 服務主機:

  • 停止 Visual Studio 中的偵錯工作階段。

  • 從 [WCF 服務主機] 視窗中的 [檔案] 功能表選取 [結束]

  • 在系統通知區域中,從 WCF 服務主機匣圖示的操作功能表選取 [結束]

  • 正在使用 WCF 測試用戶端時,將它結束。

在沒有系統管理員權限的情況下使用服務主機

為了讓沒有系統管理員權限的使用者能夠開發 WCF 服務,在安裝 Visual Studio 期間會建立命名空間 "http://+:8731/Design_Time_Addresses" 的 ACL (存取控制清單)。 ACL 會設定為 (UI),其中包含已登入電腦的所有互動使用者。 系統管理員可以在這個 ACL 中新增或移除使用者,或是開啟其他連接埠。這個 ACL 可讓使用者使用 WCF 服務自動主機 (wcfSvcHost.exe),而不需授與系統管理員權限。

您可以在有更高權限的系統管理員帳戶下,使用 Windows Vista 中的 netsh.exe 工具來修改存取權。 下列是使用 netsh.exe 的範例。

netsh http add urlacl url=http://+:8001/MyService user=<domain>\<user>

如需 netsh.exe 的詳細資訊,請參閱如何使用 Netsh.exe 工具和命令列參數

另請參閱