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 вставка пользовательского инспектора параметров в каждое ClientOperationClientRuntime.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 — это расположение для изменений во время выполнения клиента и точки вставки для пользовательских расширений, которые ограничены только одной операцией службы. (Чтобы изменить поведение во время выполнения клиента для всех сообщений в контракте, используйте ClientRuntime класс. )

Установите ClientOperation изменения с помощью пользовательского объекта поведения клиента либо типа IContractBehavior (для поиска определенной операции для изменения) или типа IOperationBehavior (который затем можно применить путем создания пользовательского атрибута).

Используйте свойство Operations, чтобы найти объект ClientOperation, представляющий определенную операцию службы.

Дополнительные сведения о клиентах и архитектуре клиента см. в статье Accessing Services Using a WCF Client and WCF Client Architecture. Дополнительные сведения о настройке среды выполнения клиента см. в разделе "Расширение клиентов". Дополнительные сведения об использовании поведения см. в разделе "Настройка и расширение среды выполнения с помощью поведения".

Следующие свойства позволяют вставлять пользовательские объекты или изменять поведение выполнения клиента:

• Используйте свойство Formatter для вставки пользовательской реализации IClientMessageFormatter для операции или изменения текущего форматтера.

• ParameterInspectors Используйте свойство, чтобы вставить пользовательскую IParameterInspector реализацию или изменить текущую.

• SerializeRequest Используйте свойство для управления сериализируемой исходящим сообщением.

• DeserializeReply Используйте свойство для управления десериализацией входящего сообщения.

• Action Используйте свойство для доступа к действию WS-Addressing сообщения запроса и ReplyAction свойству для доступа к действию ответа.

• BeginMethod Используйте и EndMethod укажите, какие клиентские методы связаны с асинхронной операцией.

• FaultContractInfos Используйте свойство, чтобы получить коллекцию указанных типов, которые могут отображаться в ошибках SOAP в качестве типа сведений.

• Используйте свойства IsInitiating и IsTerminating для управления тем, инициируется ли сеанс или отключается, соответственно, при вызове операции.

• IsOneWay Используйте свойство, чтобы контролировать, ожидает ли клиент ответа перед завершением вызова.

• Используйте свойство Parent, чтобы получить содержащий объект ClientRuntime.

• Используйте свойство Name, чтобы получить имя операции.

• SyncMethod Используйте свойство для управления тем, какой метод сопоставляется с операцией.