IOperationBehavior.ApplyDispatchBehavior 메서드

정의

네임스페이스:

System.ServiceModel.Description

어셈블리:

System.ServiceModel.Primitives.dll

어셈블리:

System.ServiceModel.dll

작업에 대해 서비스의 수정이나 확장을 구현합니다.

public:
 void ApplyDispatchBehavior(System::ServiceModel::Description::OperationDescription ^ operationDescription, System::ServiceModel::Dispatcher::DispatchOperation ^ dispatchOperation);

public void ApplyDispatchBehavior (System.ServiceModel.Description.OperationDescription operationDescription, System.ServiceModel.Dispatcher.DispatchOperation dispatchOperation);

abstract member ApplyDispatchBehavior : System.ServiceModel.Description.OperationDescription * System.ServiceModel.Dispatcher.DispatchOperation -> unit

Public Sub ApplyDispatchBehavior (operationDescription As OperationDescription, dispatchOperation As DispatchOperation)

매개 변수

operationDescription

OperationDescription

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

dispatchOperation

DispatchOperation

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

설명

ApplyDispatchBehavior 모든 메시지 또는 특정 작업에서 서비스 런타임을 보거나 수정하거나 확장하는 메서드를 구현합니다. 서비스 애플리케이션에서 수행할 수 있는 사용자 지정에 대한 자세한 내용은 System.ServiceModel.Dispatcher.DispatchRuntime 및 System.ServiceModel.Dispatcher.DispatchOperation을 참조하십시오.

동작이 클라이언트 애플리케이션에서만 사용되도록 지정된 경우 ApplyDispatchBehavior 메서드가 NotImplementedException 예외를 throw하는 것이 좋습니다.