XPathMessageFilterTable<TFilterData>.GetMatchingFilter 方法

定義

命名空間:

System.ServiceModel.Dispatcher

組件:

System.ServiceModel.dll

傳回值，這個值表示指定的訊息或是緩衝的訊息是否剛好符合資料表中單一篩選條件的比對準則，並以 out 參數傳回篩選條件。

多載

GetMatchingFilter(Message, MessageFilter)	傳回值，這個值表示指定的訊息是否剛好符合資料表中單一篩選條件的比對準則，並以 out 參數傳回該篩選條件。
GetMatchingFilter(MessageBuffer, MessageFilter)	傳回值，這個值表示指定的訊息或是緩衝的訊息是否剛好符合資料表中單一篩選條件的比對準則，並以 out 參數傳回篩選條件。
GetMatchingFilter(SeekableXPathNavigator, MessageFilter)	傳回值，這個值表示指定的訊息或是緩衝的訊息是否剛好符合資料表中單一 SeekableXPathNavigator 的比對準則，並以 out 參數傳回該篩選條件。
GetMatchingFilter(XPathNavigator, MessageFilter)	傳回值，這個值表示指定的訊息或是緩衝的訊息是否剛好符合資料表中單一 XPathNavigator 的比對準則，並以 out 參數傳回該篩選條件。

備註

測試訊息是否剛好符合篩選資料表中的其中一個篩選條件。

GetMatchingFilter(Message, MessageFilter)

傳回值，這個值表示指定的訊息是否剛好符合資料表中單一篩選條件的比對準則，並以 out 參數傳回該篩選條件。

public:
 virtual bool GetMatchingFilter(System::ServiceModel::Channels::Message ^ message, [Runtime::InteropServices::Out] System::ServiceModel::Dispatcher::MessageFilter ^ % filter);

public bool GetMatchingFilter (System.ServiceModel.Channels.Message message, out System.ServiceModel.Dispatcher.MessageFilter filter);

abstract member GetMatchingFilter : System.ServiceModel.Channels.Message * MessageFilter -> bool
override this.GetMatchingFilter : System.ServiceModel.Channels.Message * MessageFilter -> bool

Public Function GetMatchingFilter (message As Message, ByRef filter As MessageFilter) As Boolean

參數

message

Message

要測試的 Message。

filter

MessageFilter

out 參數，其中儲存 message 所符合的篩選條件。 如果找不到任何篩選條件，此參數會設定為預設值。

傳回

Boolean

訊息符合其查詢準則的 MessageFilter；如果找不到要比對的篩選條件，則為 null。

實作

GetMatchingFilter(Message, MessageFilter)

例外狀況

ArgumentNullException

message 為 null。

MultipleFilterMatchesException

有一個以上的篩選條件符合 message。

InvalidBodyAccessException

篩選條件已嘗試檢查訊息本文的內容。

備註

當預期有單一篩選條件要比對該訊息，而且需要相符的篩選條件時，便可使用這個方法。

這個方法會測試最高優先順序 Bucket 篩選條件中的單一篩選條件比對。 資料表中的篩選條件不可以檢查訊息本文。

如果預期有一個以上的篩選條件要比對訊息，便可使用 GetMatchingFilters。

這個方法會實作 GetMatchingFilter。

GetMatchingFilter(MessageBuffer, MessageFilter)

傳回值，這個值表示指定的訊息或是緩衝的訊息是否剛好符合資料表中單一篩選條件的比對準則，並以 out 參數傳回篩選條件。

public:
 virtual bool GetMatchingFilter(System::ServiceModel::Channels::MessageBuffer ^ messageBuffer, [Runtime::InteropServices::Out] System::ServiceModel::Dispatcher::MessageFilter ^ % filter);

public bool GetMatchingFilter (System.ServiceModel.Channels.MessageBuffer messageBuffer, out System.ServiceModel.Dispatcher.MessageFilter filter);

abstract member GetMatchingFilter : System.ServiceModel.Channels.MessageBuffer * MessageFilter -> bool
override this.GetMatchingFilter : System.ServiceModel.Channels.MessageBuffer * MessageFilter -> bool

Public Function GetMatchingFilter (messageBuffer As MessageBuffer, ByRef filter As MessageFilter) As Boolean

參數

messageBuffer

MessageBuffer

要測試的 MessageBuffer。

filter

MessageFilter

out 參數，其中儲存 message 所符合的篩選條件。 如果找不到任何篩選條件，此參數會設定為預設值。

傳回

Boolean

經緩衝處理的訊息符合其查詢準則的 MessageFilter；如果找不到要比對的篩選條件，則為 null。

實作

GetMatchingFilter(MessageBuffer, MessageFilter)

例外狀況

ArgumentNullException

messageBuffer 為 null。

MultipleFilterMatchesException

有一個以上的篩選條件符合 messageBuffer。

備註

當預期有單一篩選條件要比對經緩衝處理的訊息，而且需要取得相符的篩選條件時，便可使用這個方法。

資料表中的篩選條件可以檢查訊息本文。

如果預期有一個以上的篩選條件要比對訊息，便可使用 GetMatchingFilters。

這個方法會實作 GetMatchingFilter。

GetMatchingFilter(SeekableXPathNavigator, MessageFilter)

傳回值，這個值表示指定的訊息或是緩衝的訊息是否剛好符合資料表中單一 SeekableXPathNavigator 的比對準則，並以 out 參數傳回該篩選條件。

public:
 bool GetMatchingFilter(System::ServiceModel::Dispatcher::SeekableXPathNavigator ^ navigator, [Runtime::InteropServices::Out] System::ServiceModel::Dispatcher::MessageFilter ^ % filter);

public bool GetMatchingFilter (System.ServiceModel.Dispatcher.SeekableXPathNavigator navigator, out System.ServiceModel.Dispatcher.MessageFilter filter);

member this.GetMatchingFilter : System.ServiceModel.Dispatcher.SeekableXPathNavigator * MessageFilter -> bool

Public Function GetMatchingFilter (navigator As SeekableXPathNavigator, ByRef filter As MessageFilter) As Boolean

參數

navigator

SeekableXPathNavigator

要測試的 SeekableXPathNavigator。

filter

MessageFilter

out 參數，其中儲存 message 所符合的篩選條件。 如果找不到任何篩選條件，此參數會設定為預設值。

傳回

Boolean

導覽符合其查詢準則的 MessageFilter；如果找不到符合的篩選條件，則為 null。

例外狀況

ArgumentNullException

navigator 為 null。

MultipleFilterMatchesException

有一個以上的篩選條件符合 navigator。

備註

當預期有單一篩選條件要比對由 SeekableXPathNavigator 指定的訊息，而且需要取得相符的篩選條件時，便可使用這個方法。

如果預期有一個以上的篩選條件要比對訊息，便可使用 GetMatchingFilters。

GetMatchingFilter(XPathNavigator, MessageFilter)

傳回值，這個值表示指定的訊息或是緩衝的訊息是否剛好符合資料表中單一 XPathNavigator 的比對準則，並以 out 參數傳回該篩選條件。

public:
 bool GetMatchingFilter(System::Xml::XPath::XPathNavigator ^ navigator, [Runtime::InteropServices::Out] System::ServiceModel::Dispatcher::MessageFilter ^ % filter);

public bool GetMatchingFilter (System.Xml.XPath.XPathNavigator navigator, out System.ServiceModel.Dispatcher.MessageFilter filter);

member this.GetMatchingFilter : System.Xml.XPath.XPathNavigator * MessageFilter -> bool

Public Function GetMatchingFilter (navigator As XPathNavigator, ByRef filter As MessageFilter) As Boolean

參數

navigator

XPathNavigator

要測試的 XPathNavigator。

filter

MessageFilter

out 參數，其中儲存 navigator 所符合的篩選條件。 如果找不到任何篩選條件，此參數會設定為預設值。

傳回

Boolean

導覽符合其查詢準則的 MessageFilter；如果找不到符合的篩選條件，則為 null。

例外狀況

ArgumentNullException

navigator 為 null。

MultipleFilterMatchesException

有一個以上的篩選條件符合 navigator。

備註

當預期有單一篩選條件要比對由 XPathNavigator 指定的訊息，而且需要取得相符的篩選條件時，便可使用這個方法。

如果預期有一個以上的篩選條件要比對訊息，便可使用 GetMatchingFilters。