IDispatchMessageInspector Interfejs

Definicja

Przestrzeń nazw:

System.ServiceModel.Dispatcher

Zestaw:

System.ServiceModel.Primitives.dll

Pakiet:

System.ServiceModel.Primitives v8.0.0

Źródło:

IDispatchMessageInspector.cs

Definiuje metody umożliwiające niestandardową inspekcję lub modyfikację przychodzących i wychodzących komunikatów aplikacji w aplikacjach usług.

public interface class IDispatchMessageInspector

public interface IDispatchMessageInspector

type IDispatchMessageInspector = interface

Public Interface IDispatchMessageInspector

Przykłady

Poniższy przykład kodu przedstawia podstawowy IDispatchMessageInspector, który zapisuje ciąg w konsoli po wywołaniu.

#region IDispatchMessageInspector Members
public object AfterReceiveRequest(ref System.ServiceModel.Channels.Message request, IClientChannel channel, InstanceContext instanceContext)
{
  Console.WriteLine("IDispatchMessageInspector.AfterReceiveRequest called.");
  return null;
}

public void BeforeSendReply(ref System.ServiceModel.Channels.Message reply, object correlationState)
{
  Console.WriteLine("IDispatchMessageInspector.BeforeSendReply called.");
}
#endregion

#Region "IDispatchMessageInspector Members"
    Public Function AfterReceiveRequest(ByRef request As System.ServiceModel.Channels.Message, _
                       ByVal channel As IClientChannel, ByVal instanceContext As InstanceContext) _
                       As Object Implements IDispatchMessageInspector.AfterReceiveRequest
        Console.WriteLine("IDispatchMessageInspector.AfterReceiveRequest called.")
        Return Nothing
    End Function

    Public Sub BeforeSendReply(ByRef reply As System.ServiceModel.Channels.Message, ByVal correlationState As Object) _
    Implements IDispatchMessageInspector.BeforeSendReply
        Console.WriteLine("IDispatchMessageInspector.BeforeSendReply called.")
    End Sub
#End Region

Poniższy przykład kodu przedstawia implementację IServiceBehavior, która dodaje InspectorIDispatchMessageInspector do kolekcji DispatchRuntime.MessageInspectors.

#region IServiceBehavior Members
public void AddBindingParameters(
  ServiceDescription serviceDescription,
  ServiceHostBase serviceHostBase,
  System.Collections.ObjectModel.Collection<ServiceEndpoint> endpoints,
  BindingParameterCollection bindingParameters
)
{ return; }

public void ApplyDispatchBehavior(ServiceDescription serviceDescription, ServiceHostBase serviceHostBase)
{
  foreach (ChannelDispatcher chDisp in serviceHostBase.ChannelDispatchers)
  {
    foreach (EndpointDispatcher epDisp in chDisp.Endpoints)
    {
      epDisp.DispatchRuntime.MessageInspectors.Add(new Inspector());
      foreach (DispatchOperation op in epDisp.DispatchRuntime.Operations)
        op.ParameterInspectors.Add(new Inspector());
    }
  }
}

#Region "IServiceBehavior Members"
    Public Sub AddBindingParameters(ByVal serviceDescription As ServiceDescription, _
                   ByVal serviceHostBase As ServiceHostBase, ByVal endpoints As  _
                   System.Collections.ObjectModel.Collection(Of ServiceEndpoint), _
                   ByVal bindingParameters As BindingParameterCollection) Implements IServiceBehavior.AddBindingParameters
        Return
    End Sub

    Public Sub ApplyDispatchBehavior(ByVal serviceDescription As ServiceDescription, _
                                     ByVal serviceHostBase As ServiceHostBase) Implements _
                                     IServiceBehavior.ApplyDispatchBehavior
        For Each chDisp As ChannelDispatcher In serviceHostBase.ChannelDispatchers
            For Each epDisp As EndpointDispatcher In chDisp.Endpoints
                epDisp.DispatchRuntime.MessageInspectors.Add(New Inspector())
                For Each op As DispatchOperation In epDisp.DispatchRuntime.Operations
                    op.ParameterInspectors.Add(New Inspector())
                Next op
            Next epDisp
        Next chDisp
    End Sub

Poniższy przykład kodu przedstawia użycie pliku konfiguracji aplikacji do załadowania zachowania usługi, które wstawia InspectorIDispatchMessageInspector.

<configuration>
  <system.serviceModel>
    <services>
      <service 
        name="Microsoft.WCF.Documentation.SampleService"
        behaviorConfiguration="metadataSupport">
        <host>
          <baseAddresses>
            <add baseAddress="http://localhost:8080/SampleService" />
          </baseAddresses>
        </host>
        <endpoint
          address=""
          binding="wsHttpBinding"
          contract="Microsoft.WCF.Documentation.ISampleService"
        />
        <endpoint
           address="mex"
           binding="mexHttpBinding"
           contract="IMetadataExchange"
        />
      </service>
    </services>
    <behaviors>
      <serviceBehaviors>
        <behavior name="metadataSupport">
          <serviceMetadata httpGetEnabled="true" httpGetUrl=""/>
          <serviceInterceptors />
        </behavior>
      </serviceBehaviors>
    </behaviors>
    <extensions>
      <behaviorExtensions>
        <add 
          name="serviceInterceptors" 
          type="Microsoft.WCF.Documentation.InspectorInserter, HostApplication, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null"
        />
      </behaviorExtensions>
    </extensions>
  </system.serviceModel>
</configuration>

Uwagi

Zaimplementuj IDispatchMessageInspector, aby sprawdzić lub zmodyfikować komunikaty aplikacji dla ruchu przychodzącego lub wychodzącego przed wysłaniem komunikatu żądania do operacji lub przed zwróceniem komunikatu odpowiedzi do wywołującego. Istnieje wiele scenariuszy, które wymagają przechwycenia komunikatów przed wywołaniem operacji, dla której jest przeznaczona. Można na przykład rejestrować przychodzące komunikaty aplikacji lub wykonywać niektóre funkcje na podstawie nagłówka komunikatu.

Zazwyczaj inspektorzy komunikatów są wstawiane przez zachowanie usługi (System.ServiceModel.Description.IServiceBehavior), zachowanie punktu końcowego (System.ServiceModel.Description.IEndpointBehavior) lub zachowanie kontraktu (System.ServiceModel.Description.IContractBehavior). Następnie zachowanie dodaje inspektora komunikatów do kolekcji DispatchRuntime.MessageInspectors. Aby uzyskać więcej informacji na temat rozszerzania środowiska uruchomieniowego przy użyciu zachowań, zobacz Extending ServiceHost and the Service Model Layer.

• Metoda AfterReceiveRequest umożliwia zachowanie niestandardowe po otrzymaniu komunikatu, ale przed wysłaniem go do zamierzonej operacji.

• Metoda BeforeSendReply umożliwia zachowanie niestandardowe po powrocie operacji, ale przed wysłaniem odpowiedzi.

Nuta

IDispatchMessageInspector obiekty są zawsze wywoływane w tym samym punkcie podczas wysyłania komunikatów niezależnie od tego, czy operacja jest jednokierunkowa, czy żądana odpowiedź.

Metody

AfterReceiveRequest(Message, IClientChannel, InstanceContext)	Wywołana po odebraniu komunikatu przychodzącego, ale przed wysłaniem komunikatu do zamierzonej operacji.
BeforeSendReply(Message, Object)	Wywołana po zwróconej operacji, ale przed wysłaniem wiadomości odpowiedzi.