ClientOperation クラス

定義

public ref class ClientOperation sealed

public ref class ClientOperation sealed : System::ServiceModel::Dispatcher::ClientOperationCompatBase

public sealed class ClientOperation

public sealed class ClientOperation : System.ServiceModel.Dispatcher.ClientOperationCompatBase

type ClientOperation = class

type ClientOperation = class
    inherit ClientOperationCompatBase

Public NotInheritable Class ClientOperation

Public NotInheritable Class ClientOperation
Inherits ClientOperationCompatBase

継承

Object

ClientOperation

継承

Object

ClientOperationCompatBase

ClientOperation

例

次のコード例では、System.ServiceModel.Description.IEndpointBehavior プロパティの各 ClientOperation にカスタム パラメーター インスペクターを挿入する ClientRuntime.Operations を示します。

#region IEndpointBehavior Members
public void AddBindingParameters(
  ServiceEndpoint endpoint, BindingParameterCollection bindingParameters
) { return; }

public void ApplyClientBehavior(ServiceEndpoint endpoint, ClientRuntime clientRuntime)
{
  clientRuntime.MessageInspectors.Add(new Inspector());
  foreach (ClientOperation op in clientRuntime.Operations)
    op.ParameterInspectors.Add(new Inspector());
}

public void ApplyDispatchBehavior(ServiceEndpoint endpoint, EndpointDispatcher endpointDispatcher)
{
  endpointDispatcher.DispatchRuntime.MessageInspectors.Add(new Inspector());
  foreach (DispatchOperation op in endpointDispatcher.DispatchRuntime.Operations)
    op.ParameterInspectors.Add(new Inspector());
}

public void Validate(ServiceEndpoint endpoint){ return; }

#Region "IEndpointBehavior Members"
    Public Sub AddBindingParameters(ByVal endpoint As ServiceEndpoint, ByVal bindingParameters _
                                    As BindingParameterCollection) Implements IEndpointBehavior.AddBindingParameters
        Return
    End Sub

    Public Sub ApplyClientBehavior(ByVal endpoint As ServiceEndpoint, ByVal clientRuntime As ClientRuntime) _
    Implements IEndpointBehavior.ApplyClientBehavior
        clientRuntime.MessageInspectors.Add(New Inspector())
        For Each op As ClientOperation In clientRuntime.Operations
            op.ParameterInspectors.Add(New Inspector())
        Next op
    End Sub

    Public Sub ApplyDispatchBehavior(ByVal endpoint As ServiceEndpoint, ByVal endpointDispatcher As  _
                                     EndpointDispatcher) Implements IEndpointBehavior.ApplyDispatchBehavior
        endpointDispatcher.DispatchRuntime.MessageInspectors.Add(New Inspector())
        For Each op As DispatchOperation In endpointDispatcher.DispatchRuntime.Operations
            op.ParameterInspectors.Add(New Inspector())
        Next op
    End Sub

Public Sub Validate(ByVal endpoint As ServiceEndpoint) Implements IEndpointBehavior.Validate
    Return
End Sub

注釈

ClientOperation クラスは、1 つのサービス操作のスコープ内だけに適用されるカスタムの拡張を実現するために、クライアント ランタイムに対して変更または挿入を行う場所です。 (コントラクト内のすべてのメッセージのクライアントランタイム動作を変更するには、 クラスを使用します ClientRuntime 。

ClientOperation 型 (変更する特定の操作を検索する場合) または IContractBehavior 型 (カスタム属性を作成することで適用できます) のカスタム クライアント動作オブジェクトを使用して、IOperationBehavior の変更をインストールします。

Operations プロパティを使用して、特定のサービス操作を表す ClientOperation オブジェクトを検索します。

クライアントとクライアント アーキテクチャの詳細については、「WCF クライアントと WCF クライアント アーキテクチャを使用したサービスへのアクセス」を参照してください。 クライアント ランタイムのカスタマイズの詳細については、「クライアントの 拡張」を参照してください。 動作の使用の詳細については、「ビヘイビアー を使用したランタイムの構成と拡張」を参照してください。

次の各プロパティを使用すると、カスタム オブジェクトを挿入したり、クライアントの実行動作を変更したりできます。

• Formatter プロパティは、特定の操作用に IClientMessageFormatter のカスタムの実装を挿入したり、現在のフォーマッタを変更するために使用します。

• ParameterInspectors プロパティは、IParameterInspector のカスタムの実装を挿入したり、現在の実装を変更するために使用します。

• SerializeRequest プロパティは、送信メッセージをシリアル化するクライアントを制御するために使用します。

• DeserializeReply プロパティは、受信メッセージを逆シリアル化するクライアントを制御するために使用します。

• Action プロパティは、要求メッセージの WS-Addressing アクションにアクセスするために使用します。また、ReplyAction プロパティは、応答メッセージのアクションにアクセスするために使用します。

• BeginMethod プロパティと EndMethod プロパティは、非同期操作に関連付けられるクライアント メソッドを指定するために使用します。

• FaultContractInfos プロパティは、SOAP エラーの際に詳細な型として表示できる指定された型のコレクションを取得するために使用します。

• IsInitiating プロパティおよび IsTerminating プロパティは、操作が呼び出されたとき、それぞれセッションを起動するか終了するかを制御するために使用します。

• IsOneWay プロパティは、クライアントが応答を待ってから呼び出しを完了するかどうかを制御するために使用します。

• Parent プロパティは、ClientRuntime の親オブジェクトを取得するために使用します。

• Name プロパティは、操作の名前を取得するために使用します。

• SyncMethod プロパティは、操作にマップされるメソッドを制御するために使用します。

コンストラクター

プロパティ

メソッド

適用対象