WCF サービスホスト (WcfSvcHost.exe)

[アーティクル]
02/24/2011

Windows Communication Foundation (WCF) サービスホスト (WcfSvcHost.exe) を使用すると、Visual Studio デバッガーを起動して (F5 キーを押します)、実装しているサービスを自動的にホストおよびテストすることができます。その後、WCF のテスト用クライアント (WcfTestClient.exe) または独自のクライアントを使用してサービスをテストし、潜在的なエラーを見つけて修正できます。

WCF サービスホスト

WCF サービスホストは、WCF サービスプロジェクト内のサービスを列挙し、プロジェクトの構成を読み込んで、検出された各サービスのためのホストをインスタンス化します。このツールは、WCF サービステンプレートによって Visual Studio に統合され、プロジェクトのデバッグを開始すると呼び出されます。

WCF サービスホストを使用すると、追加のコードを記述したり、開発時に特定のホストにしばられたりすることなく、WCF サービス (WCF サービスライブラリプロジェクト内の WCF サービス) をホストできます。

注 :
WCF サービスホストは、部分信頼をサポートしません。部分信頼において WCF を使用する場合は、サービスをビルドするために Visual Studio にある WCF サービスライブラリプロジェクトテンプレートを使用しないでください。代わりに、WCF 部分信頼がサポートされている Web サーバーでサービスをホストできる WCF サービス Web サイトテンプレートを選択して、Visual Studio に新しい Web サイトを作成します。

WCF サービスホストは、部分信頼をサポートしません。部分信頼において WCF を使用する場合は、サービスをビルドするために Visual Studio にある WCF サービスライブラリプロジェクトテンプレートを使用しないでください。代わりに、WCF 部分信頼がサポートされている Web サーバーでサービスをホストできる WCF サービス Web サイトテンプレートを選択して、Visual Studio に新しい Web サイトを作成します。

WCF サービスホストでホストされるプロジェクトの種類

WCF サービスホストでホストできる WCF サービスライブラリプロジェクトの種類は、WCF サービスライブラリ、シーケンシャルワークフローサービスライブラリ、ステートマシンワークフローサービスライブラリ、および配信サービスライブラリです。その他に、[項目の追加] 機能を使用してサービスライブラリプロジェクトに追加できるサービスをホストすることもできます。これには、WCF サービス、WF ステートマシンサービス、WF シーケンシャルサービス、XAML WF ステートマシンサービス、および XAML WF シーケンシャルサービスが含まれます。

ただし、このツールでホストを構成することはできません。ホストを構成するには、App.config ファイルを手動で編集する必要があります。また、このツールでユーザー定義の構成ファイルを検証することはできません。

注意 :
WCF サービスホストを使用して運用環境のサービスをホストしないでください。このツールはそのような目的で作られていないため、そうした環境で要求される信頼性、セキュリティ、および管理性をサポートしていません。代わりに IIS を使用してください。IIS は、より高度な信頼性機能や監視機能を備えており、サービスをホストするのに適しています。サービスの開発が完了したら、WCF サービスホストから IIS にサービスを移行してください。

WCF サービスホストを使用して運用環境のサービスをホストしないでください。このツールはそのような目的で作られていないため、そうした環境で要求される信頼性、セキュリティ、および管理性をサポートしていません。代わりに IIS を使用してください。IIS は、より高度な信頼性機能や監視機能を備えており、サービスをホストするのに適しています。サービスの開発が完了したら、WCF サービスホストから IIS にサービスを移行してください。

Visual Studio 内で WCF サービスホストを使用するシナリオ

次の表は、[コマンドライン引数] ダイアログボックスのすべてのパラメーターの一覧です。このダイアログボックスを表示するには、Visual Studio のソリューションエクスプローラーでプロジェクトを右クリックし、[プロパティ] をクリックします。次に、[デバッグ] タブをクリックし、[スタートプロジェクト] をクリックします。これらのパラメーターは、WCF サービスホストを構成する際に役立ちます。

パラメーター	説明
`/client`	サービスのホストが開始された後に実行する実行可能ファイルへのパスを指定するオプションパラメーターです。これにより、ホストが開始された後に WCF のテスト用クライアントが起動します。
`/clientArg`	カスタムクライアントアプリケーションに渡す引数として文字列を指定します。
`/?`	ヘルプテキストを表示します。

WCF のテスト用クライアントの使用

新しい WCF サービスプロジェクトを作成し、F5 キーを押してデバッガーを起動すると、WCF サービスホストが、プロジェクトで検出されたすべてのサービスのホストを開始します。その後、WCF のテスト用クライアントが自動的に開き、構成ファイルに定義されているサービスエンドポイントの一覧が表示されます。メインウィンドウでパラメーターをテストしたり、サービスを呼び出したりできます。

WCF のテスト用クライアントが使用されていることを確認するには、Visual Studio のソリューションエクスプローラーでプロジェクトを右クリックし、[プロパティ] をクリックして、[デバッグ] タブをクリックします。[スタートプロジェクト] をクリックして、[コマンドライン引数] ダイアログボックスに次のように表示されていることを確認します。

/client:WcfTestClient.exe

カスタムクライアントの使用

カスタムクライアントを使用するには、Visual Studio のソリューションエクスプローラーでプロジェクトを右クリックし、[プロパティ] をクリックして、[デバッグ] タブをクリックします。[スタートプロジェクト] をクリックし、[コマンドライン引数] ダイアログボックスで /client パラメーターを編集して、使用するカスタムクライアントを指定します。以下に例を示します。

/client:"path/CustomClient.exe"

F5 キーを押して再びサービスを開始し、デバッガーを起動すると、指定したカスタムクライアントが自動的に起動します。

/clientArg: パラメーターを使用して、カスタムクライアントアプリケーションに渡す引数として文字列を指定することもできます。以下に例を示します。

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

たとえば、配信サービスライブラリテンプレートを使用している場合は、次のコマンドライン引数を使用できます。

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

クライアントを指定しない場合

WCF サービスホストがサービスのホストを開始した後にクライアントを使用しないように指定するには、Visual Studio のソリューションエクスプローラーでプロジェクトを右クリックし、[プロパティ] をクリックして、[デバッグ] タブをクリックします。[スタートプロジェクト] をクリックし、[コマンドライン引数] ダイアログボックスを空白のままにします。

カスタムホストの使用

カスタムホストを使用するには、Visual Studio のソリューションエクスプローラーでプロジェクトを右クリックし、[プロパティ] をクリックして、[デバッグ] タブをクリックします。[外部プログラムの開始] をクリックし、カスタムホストへの完全パスを入力します。[コマンドライン引数] ダイアログボックスを使用して、そのホストに渡す引数を指定することもできます。

WCF サービスホストのユーザーインターフェイス

最初に (Visual Studio 内で F5 キーを押して) WCF サービスホストを呼び出したときには、[WCF サービスホスト] ウィンドウが自動的に開きます。WCF サービスホストが実行されている場合は、通知領域にプログラムのアイコンが表示されます。このアイコンをダブルクリックすると、[WCF サービスホスト] ウィンドウが開きます。

サービスのホスト中にエラーが発生すると、[WCF サービスホスト] ダイアログボックスが開いて関連情報が表示されます。

メインの [WCF サービスホスト] ウィンドウには、次の 2 つのメニューがあります。

[ファイル]: [閉じる] コマンドと [終了] コマンドが含まれています。[閉じる] をクリックすると、[WCF サービスホスト] ダイアログボックスが閉じますが、サービスは引き続きホストされます。[終了] をクリックすると、WCF サービスホストがシャットダウンして、ホストされているサービスもすべて停止します。
[ヘルプ]: バージョン情報を表示する [バージョン情報] コマンドと、ヘルプファイルを開く [ヘルプ] コマンドが含まれています。

メインの [WCF サービスホスト] ウィンドウには、次の 2 つの領域があります。

1 つ目の領域は、[サービス] です。この領域には、すべてのサービスの基本情報が一覧表示されます。具体的には、次の情報が含まれています。
- [サービス]: すべてのサービスが表示されます。
- [状態]: サービスの状態が表示されます。有効な値は "開始"、"停止"、および "エラー" です。
- [メタデータアドレス]: サービスのメタデータアドレスが表示されます。
2 つ目の領域は、[追加情報] です。[サービス] 領域で特定のサービスの行を選択すると、ここにサービスの状態の詳細な説明が表示されます。状態が "エラー" の場合は、完全なエラーメッセージを画面上で確認できます。

WCF サービスホストの停止

WCF サービスホストは、次の 4 つの方法でシャットダウンできます。

Visual Studio のデバッグセッションを停止します。
[WCF サービスホスト] ウィンドウで、[ファイル] メニューの [終了] をクリックします。
通知領域の WCF サービスホストのトレイアイコンを右クリックし、[終了] をクリックします。
WCF のテスト用クライアントを使用している場合は、それを終了します。

管理者特権を必要としないサービスホストの使用

管理者特権のないユーザーが WCF サービスを開発できるようにするために、Visual Studio のインストール時には、名前空間 "http://+:8731/Design_Time_Addresses" に対してアクセス制御リスト (ACL: Access Control List) が作成されます。この 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 ツールとコマンドラインスイッチの使用方法」を参照してください。

参照

概念

WCF のテスト用クライアント (WcfTestClient.exe)

次の方法で共有

WCF サービスホスト (WcfSvcHost.exe)