ClientOperation Class

Definition

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

Inheritance

Object

ClientOperation

Inheritance

Object

ClientOperationCompatBase

ClientOperation

Examples

The following code example shows an System.ServiceModel.Description.IEndpointBehavior inserting a custom parameter inspector into each ClientOperation in the ClientRuntime.Operations property.

#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

Remarks

The ClientOperation class is the location for client run-time modifications and insertion point for custom extensions that are scoped to only one service operation. (To modify client run-time behavior for all messages in a contract, use the ClientRuntime class. )

Install ClientOperation modifications using a custom client behavior object, either of type IContractBehavior (to find a particular operation to modify) or of type IOperationBehavior (which can then be applied by creating a custom attribute).

Use the Operations property to locate the ClientOperation object that represents a particular service operation.

For more information about clients and the client architecture, see Accessing Services Using a WCF Client and WCF Client Architecture. For more information about customizing the client runtime, see Extending Clients. For more information about using behaviors, see Configuring and Extending the Runtime with Behaviors.

The following properties enable you to insert custom objects or modify the client execution behavior:

• Use the Formatter property to insert a custom IClientMessageFormatter implementation for an operation or modify the current formatter.

• Use the ParameterInspectors property to insert a custom IParameterInspector implementation or to modify the current one.

• Use the SerializeRequest property to control who serializes an outbound message.

• Use the DeserializeReply property to control who deserializes an inbound message.

• Use the Action property to access the WS-Addressing action of the request message and the ReplyAction property to access the response message action.

• Use the BeginMethod and EndMethod to specify which client methods are associated with an asynchronous operation.

• Use the FaultContractInfos property to get a collection of specified types that can appear in SOAP faults as the detail type.

• Use the IsInitiating and IsTerminating properties to control whether a session is initiated or is torn down, respectively, when the operation is called.

• Use the IsOneWay property to control whether the client waits for a response before completing the invocation.

• Use the Parent property to obtain the containing ClientRuntime object.

• Use the Name property to get the name of the operation.

• Use the SyncMethod property to control which method is mapped to the operation.

Constructors

Properties

Methods

Applies to