生成されたクライアント コードの理解
ServiceModel Metadata Utility Tool (Svcutil.exe) は、クライアント アプリケーションの構築時に使用するクライアント コードとクライアント アプリケーション構成ファイルを生成します。このトピックでは、標準サービス コントラクトのシナリオにおける生成されたコード例について説明します。生成されたコードを使用してクライアント アプリケーションを構築する方法詳細については、 、「WCF クライアントの概要」を参照してください。
概要
プロジェクトで Visual Studio を使用して Windows Communication Foundation (WCF) クライアント型を生成する場合、通常、生成されたクライアント コードを調べる必要はありません。同じサービスを実行する開発環境を使用していない場合は、Svcutil.exe のようなツールを使用してクライアント コードを生成し、そのコードでクライアント アプリケーションを開発します。
Svcutil.exe には、生成された型情報を変更する多くのオプションがあるため、ここですべてのシナリオを説明することはできません。ここでは、生成されたコードの検索に関する標準的な作業の例を紹介します。
- サービス コントラクト インターフェイスの識別
- WCF クライアント クラスの識別
- データ型の識別
- 双方向サービスのコールバック コントラクトの識別
- ヘルパーのサービス コントラクトのチャネル インターフェイスの識別
サービス コントラクト インターフェイスの検索
サービス コントラクトをモデル化するインターフェイスを検索するには、System.ServiceModel.ServiceContractAttribute 属性でマークされたインターフェイスを検索します。多くの場合、属性自体に設定された他の属性や明示的なプロパティが存在するため、この属性をすばやく読み取って見つけることは簡単ではありません。サービス コントラクト インターフェイスとクライアント コントラクト インターフェイスは 2 つの別の種類だという点に注意してください。次のコード例は、元のサービス コントラクトを示しています。
次のコード例は、Svcutil.exe で生成された同じサービス コントラクトを示しています。
生成されたサービス コントラクト インターフェイスと System.ServiceModel.ChannelFactory クラスを使用して、サービス操作の呼び出しに使用する WCF チャネル オブジェクトを作成できます。詳細な情報については、次のページを参照してください。 「方法 : ChannelFactory を使用する」を参照してください。
WCF クライアント クラスの検索
使用するサービス コントラクトを実装する WCF クライアント クラスを検索するには、System.ServiceModel.ClientBase の拡張を検索します。ここで、型パラメータは、以前に検索され、自身を拡張するサービス コントラクト インターフェイスです。次のコード例は、ISampleService 型の ClientBase クラスを示しています。
この WCF クライアント クラスを使用するには、新しいインスタンスを作成し、このクラスに実装されているメソッドを呼び出します。これらのメソッドは、対応しているサービス操作を呼び出し、やり取りを行うように構成されています。詳細な情報については、次のページを参照してください。 「WCF クライアントの概要」を参照してください。
.gif "ms733881.note(ja-jp,VS.90).gif") メモ : |
|---|
| SvcUtil.exe で WCF クライアント クラスが生成されるとき、DebuggerStepThroughAttribute がクライアント クラスに追加されるため、デバッガで WCF クライアント クラスをステップ実行できなくなります。 |
データ型の検索
生成されたコード内でデータ型を検索する最も基本的な方法は、コントラクトに指定された型名を識別し、その型宣言のコードを検索することです。たとえば、次のコントラクトには、SampleMethod が型 microsoft.wcf.documentation.SampleFault の SOAP エラーを返せることが指定されています。
SampleFault を検索すると、次の型宣言が見つかります。
この場合、このデータ型は、クライアントの特定の例外 (FaultException) によりスローされる詳細な型です。詳細な型のパラメータは、microsoft.wcf.documentation.SampleFault です。データ型詳細については、 「サービス コントラクトでのデータ転送の指定」を、クライアントでの例外の処理詳細については、 「エラーの送受信」を参照してください。
双方向サービスのコールバック コントラクトの検索
コントラクト インターフェイスにより System.ServiceModel.ServiceContractAttribute.CallbackContract プロパティの値が指定されているサービス コントラクトを検索すると、そのコントラクトには双方向コントラクトが指定されていることがわかります。双方向コントラクトを使用した場合、クライアント アプリケーションは、コールバック コントラクトを実装するコールバック クラスを作成し、そのクラスのインスタンスを、サービスとの通信に使用する System.ServiceModel.DuplexClientBase または System.ServiceModel.DuplexChannelFactory に渡す必要があります。双方向クライアント詳細については、 、「方法 : 双方向コントラクトを使用してサービスにアクセスする」を参照してください。
次のコントラクトは、型 SampleDuplexHelloCallback のコールバック コントラクトを指定しています。
このコールバック コントラクトを検索すると、クライアント アプリケーションが実装する必要のある次のインターフェイスが見つかります。
サービス コントラクト チャネル インターフェイスの検索
サービス コントラクト インターフェイスで ChannelFactory クラスを使用する場合、明示的にチャネルを開いたり、閉じたり、中止したりするには、System.ServiceModel.IClientChannel インターフェイスにキャストする必要があります。処理を容易にするために、Svcutil.exe ツールでは、サービス コントラクト インターフェイスと IClientChannel の両方を実装するヘルパー インターフェイスも生成されます。これにより、キャストを行わずにクライアント チャネル インフラストラクチャとのやりとりを実現できます。上記のサービス コントラクトを実装するヘルパー クライアント チャネルの定義を、次のコード例に示します。