IOperationBehavior.ApplyClientBehavior 메서드

정의

네임스페이스:

System.ServiceModel.Description

어셈블리:

System.ServiceModel.Primitives.dll

어셈블리:

System.ServiceModel.dll

작업에 대해 클라이언트의 수정이나 확장을 구현합니다.

public:
 void ApplyClientBehavior(System::ServiceModel::Description::OperationDescription ^ operationDescription, System::ServiceModel::Dispatcher::ClientOperation ^ clientOperation);

public void ApplyClientBehavior (System.ServiceModel.Description.OperationDescription operationDescription, System.ServiceModel.Dispatcher.ClientOperation clientOperation);

abstract member ApplyClientBehavior : System.ServiceModel.Description.OperationDescription * System.ServiceModel.Dispatcher.ClientOperation -> unit

Public Sub ApplyClientBehavior (operationDescription As OperationDescription, clientOperation As ClientOperation)

매개 변수

operationDescription

OperationDescription

검사할 작업입니다. 검사 전용이므로 작업 설명이 수정될 경우 결과가 정의되지 않습니다.

clientOperation

ClientOperation

operationDescription에 설명된 작업에 대한 사용자 지정 속성을 노출하는 런타임 개체입니다.

예제

다음 코드 예제에서는 작업에서 System.ServiceModel.Dispatcher.IParameterInspector 검사기를 호출할 때 콘솔에 쓰는 구현을 보여 줍니다. 이 사용자 지정은 해당 사용자 지정에 System.ServiceModel.Dispatcher.DispatchOperation System.ServiceModel.Dispatcher.ClientOperation 만 연결할 수 있으며, 따라서 일반적으로 작업 동작에 의해 삽입됩니다.

#region IParameterInspector Members
public void AfterCall(string operationName, object[] outputs, object returnValue, object correlationState)
{
  Console.WriteLine(
    "IParameterInspector.AfterCall called for {0} with return value {1}.",
    operationName,
    returnValue.ToString()
  );
}

public object BeforeCall(string operationName, object[] inputs)
{
  Console.WriteLine("IParameterInspector.BeforeCall called for {0}.", operationName);
  return null;
}

#Region "IParameterInspector Members"
    Public Sub AfterCall(ByVal operationName As String, ByVal outputs() As Object, ByVal returnValue As Object, _
                         ByVal correlationState As Object) Implements IParameterInspector.AfterCall
        Console.WriteLine("IParameterInspector.AfterCall called for {0} with return value {1}.", _
                          operationName, returnValue.ToString())
    End Sub

    Public Function BeforeCall(ByVal operationName As String, ByVal inputs() As Object) As Object Implements _
    IParameterInspector.BeforeCall
        Console.WriteLine("IParameterInspector.BeforeCall called for {0}.", operationName)
        Return Nothing
    End Function

다음 코드 예제에서는 작업 동작이 매개 변수 검사기를 런타임에 연결하는 방법을 보여줍니다.

#region IOperationBehavior Members
public void AddBindingParameters(
  OperationDescription operationDescription, BindingParameterCollection bindingParameters
)
{ return; }

public void ApplyClientBehavior(OperationDescription operationDescription, ClientOperation clientOperation)
{
  clientOperation.ParameterInspectors.Add(new Inspector());
}

public void ApplyDispatchBehavior(OperationDescription operationDescription, DispatchOperation dispatchOperation)
{
  dispatchOperation.ParameterInspectors.Add(new Inspector());
}

public void Validate(OperationDescription operationDescription){ return; }

#Region "IOperationBehavior Members"
    Public Sub AddBindingParameters(ByVal operationDescription As OperationDescription, _
                                    ByVal bindingParameters As BindingParameterCollection) Implements _
                                    IOperationBehavior.AddBindingParameters
        Return
    End Sub

    Public Sub ApplyClientBehavior(ByVal operationDescription As OperationDescription, ByVal _
                                   clientOperation As ClientOperation) Implements IOperationBehavior.ApplyClientBehavior
        clientOperation.ParameterInspectors.Add(New Inspector())
    End Sub

    Public Sub ApplyDispatchBehavior(ByVal operationDescription As OperationDescription, ByVal dispatchOperation As  _
                                     DispatchOperation) Implements IOperationBehavior.ApplyDispatchBehavior
        dispatchOperation.ParameterInspectors.Add(New Inspector())
    End Sub

Public Sub Validate(ByVal operationDescription As OperationDescription) Implements IOperationBehavior.Validate
    Return
End Sub

설명

ApplyClientBehavior 특정 작업에 사용되는 모든 메시지에서 클라이언트 런타임에 사용자 지정 확장을 보거나 수정하거나 추가하는 메서드를 구현합니다. 클라이언트 런타임 개체로 수행할 수 있는 사용자 지정에 대한 자세한 내용은 다음을 참조 ClientRuntime 하세요 ClientOperation.

동작이 서비스 애플리케이션에서만 사용하도록 지정된 경우 ApplyClientBehavior 메서드가 NotImplementedException을 throw하는 것이 좋습니다.