MessageFilter 類別

定義

public ref class MessageFilter abstract

[System.Runtime.Serialization.DataContract]
[System.Runtime.Serialization.KnownType(typeof(System.ServiceModel.Dispatcher.ActionMessageFilter))]
[System.Runtime.Serialization.KnownType(typeof(System.ServiceModel.Dispatcher.XPathMessageFilter))]
[System.Runtime.Serialization.KnownType(typeof(System.ServiceModel.Dispatcher.MatchAllMessageFilter))]
[System.Runtime.Serialization.KnownType(typeof(System.ServiceModel.Dispatcher.MatchNoneMessageFilter))]
public abstract class MessageFilter

[<System.Runtime.Serialization.DataContract>]
[<System.Runtime.Serialization.KnownType(typeof(System.ServiceModel.Dispatcher.ActionMessageFilter))>]
[<System.Runtime.Serialization.KnownType(typeof(System.ServiceModel.Dispatcher.XPathMessageFilter))>]
[<System.Runtime.Serialization.KnownType(typeof(System.ServiceModel.Dispatcher.MatchAllMessageFilter))>]
[<System.Runtime.Serialization.KnownType(typeof(System.ServiceModel.Dispatcher.MatchNoneMessageFilter))>]
type MessageFilter = class

Public MustInherit Class MessageFilter

繼承

Object

MessageFilter

衍生

System.ServiceModel.CorrelationActionMessageFilter

System.ServiceModel.Dispatcher.ActionMessageFilter

System.ServiceModel.Dispatcher.EndpointAddressMessageFilter

System.ServiceModel.Dispatcher.EndpointNameMessageFilter

System.ServiceModel.Dispatcher.MatchAllMessageFilter

更多…

屬性

DataContractAttribute KnownTypeAttribute

備註

MessageFilter 是 abstract 開發者實作的一個類別，用以指定檢查訊息所需的條件。 通常，終端應用程式會使用過濾器，根據對訊息某部分的檢查來決定該如何處理訊息。 例如，佇列進程可以使用 XPath 1.0 查詢來檢查已知標頭的優先順序元素，以判斷是否要將訊息移至佇列前端。

濾波器儲存在一個實 IMessageFilterTable<TFilterData>作 的濾波表中。 表格中的每個過濾器都對應到指定的過濾器資料，可用來指示若訊息符合過濾器，該採取哪些行動。 方法 Match 可用來判斷訊息是否符合篩選條件。

過濾器所使用的準則一旦建構完成後無法更改，因為過濾器表無法偵測變更。 修改篩選條件的唯一方法是建立新的篩選條件並刪除現有篩選條件。

以下類別實作該 abstractMessageFilter 類別：

• XPathMessageFilter 使用 XPath 1.0 表達式來指定匹配條件。

• MatchAllMessageFilter 與所有訊息相符。

• MatchNoneMessageFilter 完全不符合任何訊息。

• ActionMessageFilter 測試訊息的動作是否屬於指定一組動作之一。

• EndpointAddressMessageFilter 測試訊息是否符合指定的端點位址。

ChannelListenerBase<TChannel> 是一個 abstract 可以用來撰寫非排隊監聽器的基底類別。