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, które umożliwiają niestandardową inspekcję lub modyfikowanie 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 kod, 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ę obiektu IServiceBehavior , która dodaje InspectorIDispatchMessageInspector element do DispatchRuntime.MessageInspectors kolekcji.

#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 element 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ć przychodzące lub wychodzące komunikaty aplikacji 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 powoduje dodanie 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 (Rozszerzanie warstwy serviceHost i warstwy modelu usług).

• 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.

Uwaga

IDispatchMessageInspector obiekty są zawsze wywoływane w tym samym momencie 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óceniu operacji, ale przed wysłaniem wiadomości odpowiedzi.