Windows Communication Foundation サンプルの実行

[アーティクル]
09/17/2008

Windows Communication Foundation (WCF) サンプルは、単一コンピュータ構成または複数コンピュータ構成で実行できます。サンプルは、単一コンピュータでそのまま実行できます。複数コンピュータ構成で実行するには、サンプルの構成ファイルの設定を変更する必要があります。単一コンピュータおよび複数コンピュータの構成でサンプルを実行する手順を、次に示します。インターネットインフォメーションサービス (IIS) でホストされるサービスと自己ホスト型のサービスのサンプルとでは、手順が異なります。ほとんどのサンプルは IIS でホストされます。サンプルのホスト方法を判断するには、サンプルの Readme 情報を参照してください。

Windows Vista では、IIS でホストされていないサンプルには、リスナを Http.sys に登録するためのシステム特権が必要です。Httpcfg.exe を使用して、サービスのリッスンアドレスをサービスが実行されているアカウントに登録するか、管理者権限で実行されているコマンドプロンプトでサービスを起動します。

メモ :
WCF サンプルをビルドまたは実行する前に、「Windows Communication Foundation サンプルの 1 回限りのセットアップの手順」に記述されている手順が完了していることを確認してください。

サンプルを同じコンピュータで実行するには

サービスが IIS でホストされている場合は、ブラウザにアドレス https://localhost/servicemodelsamples/service.svc を入力して、サービスにアクセスできることを確認します。これに対して確認ページが表示されます。確認ページが表示されない場合は、「トラブルシューティングのヒント」を参照してください。
サービスが自己ホスト型の場合は、言語固有のフォルダの下の \service\bin にある Service.exe を実行します。サービスアクティビティがサービスコンソールウィンドウに表示されます。
言語固有のフォルダの下の \client\bin\ にある Client.exe を実行します。クライアントアクティビティがクライアントコンソールウィンドウに表示されます。
クライアントとサービス間で通信できない場合は、「トラブルシューティングのヒント」を参照してください。

サンプルを別のコンピュータで実行するには

サービスが IIS でホストされている場合 :
1. サービスコンピュータで、ServiceModelSamples という仮想ディレクトリを作成します。「Windows Communication Foundation サンプルの 1 回限りのセットアップの手順」に含まれている Setupvroot.bat バッチファイルを使用して、ディスクディレクトリと仮想ディレクトリを作成できます。
2. サービスプログラムファイルを %SystemDrive%\Inetpub\wwwroot\servicemodelsamples からサービスコンピュータの ServiceModelSamples 仮想ディレクトリにコピーします。このファイルが \bin ディレクトリにあることを確認します。
3. ブラウザを使用して、サービスにクライアントコンピュータからアクセスできるかどうかをテストします。
サービスが自己ホスト型の場合、次の手順を実行します。
1. サービスコンピュータで、サービスファイルを保持するディレクトリを作成します。
2. サービスプログラムファイルを、言語固有のフォルダにある \service\bin\ フォルダからサービスコンピュータにコピーします。
3. サービスの構成ファイルで、エンドポイント定義のアドレス値をサービスの新しいアドレスに変更します。アドレスの "localhost" への参照をすべて完全修飾ドメイン名に置き換えます。
4. コマンドプロンプトから Service.exe を起動します。
クライアントのプログラムファイルを、言語固有のフォルダにある \client\bin\ フォルダからクライアントのコンピュータにコピーします。
エンドポイントアドレスを設定します。
1. サービスの実行に使用されているのがドメインアカウントではない場合、クライアント構成ファイルを開き、エンドポイント定義のアドレス値をサービスの新しいアドレスに変更します。アドレスの "localhost" への参照をすべて完全修飾ドメイン名に置き換えます。
2. サービスの実行に使用されているのがドメインアカウントの場合、サービスに対して Svcutil.exe を実行し、クライアントの構成を再生成します。Svcutil.exe の実行の詳細については、「Windows Communication Foundation サンプルのビルド」を参照してください。サンプルの構成ファイルではなく、生成されたファイルを使用します。生成された構成ファイルには、追加の ID 情報があります (また、サービスエンドポイントへの接続に必要なすべての設定が、既定の設定であるにもかかわらず含まれています)。ID の詳細については、「Service Identity and Authentication」および「<identity>」を参照してください。
クライアントコンピュータで、コマンドプロンプトから Client.exe を起動します。

サービスをデバッグするには

(クライアントとサービスの両方で) [Build] メニューを使用するか、または Ctrl キーと Shift キーを押しながら B キーを押して、ソリューションをビルドします。
サービスが IIS でホストされている場合 :
1. サービスをアクティブ化します。ブラウザにアドレス https://localhost/servicemodelsamples/service.svc を入力します。
2. ソリューションで、[Debug] メニューの [Attach to Process] をクリックします。
3. [Show processes from all users] チェックボックスをオンにします。
4. デバッグ対象のホストワーカープロセス W3wp.exe を選択します (Windows XP では ASPNet_wp.exe を選択します)。
これで、サービス内にブレークポイントを設定し、例外に対してブレークポイントを有効にできます。
クライアントのプロジェクト項目を右クリックし、[デバッグ]、[新しいインスタンスを開始] の順にクリックします。

サンプルの実行後にクリーンアップするには

サービスがセキュリティの目的で IIS でホストされている場合、サンプルの使用が終わったら、このセットアップで付与された仮想ディレクトリの定義とアクセス許可を削除してください。

Windows Communication Foundation サンプルの実行

サンプルを同じコンピュータで実行するには

サンプルを別のコンピュータで実行するには

サービスをデバッグするには

サンプルの実行後にクリーンアップするには

関連項目

概念

その他の技術情報

その他のリソース