IDispatchMessageInspector Arabirim
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
Hizmet uygulamalarında gelen ve giden uygulama iletilerinin özel incelemesini veya değiştirilmesini sağlayan yöntemleri tanımlar.
public interface class IDispatchMessageInspector
public interface IDispatchMessageInspector
type IDispatchMessageInspector = interface
Public Interface IDispatchMessageInspector
Örnekler
Aşağıdaki kod örneği, çağrıldığında konsola bir dize yazan temel IDispatchMessageInspector bilgileri gösterir.
#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
Aşağıdaki kod örneği, koleksiyonuna öğesini ekleyen Inspector
IDispatchMessageInspector DispatchRuntime.MessageInspectors bir IServiceBehavior uygulamasını gösterir.
#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
Aşağıdaki kod örneği, öğesini ekleyen hizmet davranışını yüklemek için bir uygulama yapılandırma dosyasının Inspector
IDispatchMessageInspectorkullanımını gösterir.
<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>
Açıklamalar
bir işleme istek iletisi göndermeden önce veya bir yanıt iletisini çağırana döndürmeden önce gelen veya giden uygulama iletilerini incelemek veya değiştirmek için uygulayın IDispatchMessageInspector . Hedeflendiği işlemi çağırmadan önce iletilerin kesilmesini gerektiren çok sayıda senaryo vardır. Örneğin, gelen uygulama iletilerini günlüğe kaydedebilir veya ileti üst bilgisini temel alan bazı özellikler gerçekleştirebilirsiniz.
Genellikle, ileti denetçileri bir hizmet davranışı (System.ServiceModel.Description.IServiceBehavior), uç nokta davranışı ()System.ServiceModel.Description.IEndpointBehavior veya sözleşme davranışı (System.ServiceModel.Description.IContractBehavior tarafından eklenir. Daha sonra davranış, ileti denetçisini koleksiyona DispatchRuntime.MessageInspectors ekler. Çalışma zamanını davranışları kullanarak genişletme hakkında daha fazla bilgi için bkz. ServiceHost'u ve Hizmet Modeli Katmanını Genişletme.
yöntemi, AfterReceiveRequest iletiyi aldıktan sonra ancak istenen işleme göndermeden önce özel davranışı etkinleştirir.
yöntemi, BeforeSendReply işlem geri döndükten sonra ancak yanıt gönderilmeden önce özel davranışı etkinleştirir.
Not
IDispatchMessageInspector nesneler, bir işlemin tek yönlü mü yoksa istek yanıtı mı olduğuna bakılmaksızın ileti gönderimi sırasında her zaman aynı noktada çağrılır.
Yöntemler
AfterReceiveRequest(Message, IClientChannel, InstanceContext) |
Gelen ileti alındıktan sonra ancak ileti istenen işleme gönderilmeden önce çağrılır. |
BeforeSendReply(Message, Object) |
İşlem döndürüldükten sonra ancak yanıt iletisi gönderilmeden önce çağrılır. |