XPathMessageFilterTable<TFilterData>.GetMatchingFilters 方法

定義

命名空間:

System.ServiceModel.Dispatcher

組件:

System.ServiceModel.dll

傳回值，這個值表示指定的 XML 文件是否符合資料表中篩選條件的比對準則，並且將相符的篩選條件加入至集合。

多載

GetMatchingFilters(SeekableXPathNavigator, ICollection<MessageFilter>)	傳回值，這個值表示指定的經緩衝處理訊息是否符合資料表中至少一個 SeekableXPathNavigator 的比對準則，並且將相符的篩選條件加入至集合。
GetMatchingFilters(XPathNavigator, ICollection<MessageFilter>)	傳回值，這個值表示指定的經緩衝處理訊息是否符合資料表中至少一個 XPathNavigator 的比對準則，並且將相符的篩選條件加入至集合。
GetMatchingFilters(Message, ICollection<MessageFilter>)	傳回值，這個值表示指定的訊息是否符合資料表中至少一個 XPathMessageFilter 的比對準則，並且將相符的篩選條件加入至集合。
GetMatchingFilters(MessageBuffer, ICollection<MessageFilter>)	傳回值，這個值表示指定的經緩衝處理訊息是否符合資料表中至少一個 XPathMessageFilter 的比對準則，並且將相符的篩選條件加入至集合。

備註

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

GetMatchingFilters(SeekableXPathNavigator, ICollection<MessageFilter>)

傳回值，這個值表示指定的經緩衝處理訊息是否符合資料表中至少一個 SeekableXPathNavigator 的比對準則，並且將相符的篩選條件加入至集合。

public:
 bool GetMatchingFilters(System::ServiceModel::Dispatcher::SeekableXPathNavigator ^ navigator, System::Collections::Generic::ICollection<System::ServiceModel::Dispatcher::MessageFilter ^> ^ results);

public bool GetMatchingFilters (System.ServiceModel.Dispatcher.SeekableXPathNavigator navigator, System.Collections.Generic.ICollection<System.ServiceModel.Dispatcher.MessageFilter> results);

member this.GetMatchingFilters : System.ServiceModel.Dispatcher.SeekableXPathNavigator * System.Collections.Generic.ICollection<System.ServiceModel.Dispatcher.MessageFilter> -> bool

Public Function GetMatchingFilters (navigator As SeekableXPathNavigator, results As ICollection(Of MessageFilter)) As Boolean

參數

navigator

SeekableXPathNavigator

要測試的 SeekableXPathNavigator。

results

ICollection<MessageFilter>

參考參數，其中儲存 ICollection<T><篩選> 中相符的 MessageFilter 物件。

傳回

Boolean

如果 true 符合資料表中至少一個篩選條件的比對準則，則為 messageBuffer，如果沒有符合任何篩選條件，則為 false。

例外狀況

ArgumentNullException

navigator 或 results 為 null。

備註

當預期有一個以上的篩選條件要比對該導覽，而且需要取得相符的篩選條件時，便可使用這個方法。

如果預期只有一個篩選條件要比對訊息，便可使用 GetMatchingFilter 方法。

GetMatchingFilters(XPathNavigator, ICollection<MessageFilter>)

傳回值，這個值表示指定的經緩衝處理訊息是否符合資料表中至少一個 XPathNavigator 的比對準則，並且將相符的篩選條件加入至集合。

public:
 bool GetMatchingFilters(System::Xml::XPath::XPathNavigator ^ navigator, System::Collections::Generic::ICollection<System::ServiceModel::Dispatcher::MessageFilter ^> ^ results);

public bool GetMatchingFilters (System.Xml.XPath.XPathNavigator navigator, System.Collections.Generic.ICollection<System.ServiceModel.Dispatcher.MessageFilter> results);

member this.GetMatchingFilters : System.Xml.XPath.XPathNavigator * System.Collections.Generic.ICollection<System.ServiceModel.Dispatcher.MessageFilter> -> bool

Public Function GetMatchingFilters (navigator As XPathNavigator, results As ICollection(Of MessageFilter)) As Boolean

參數

navigator

XPathNavigator

要測試的 XPathNavigator。

results

ICollection<MessageFilter>

參考參數，其中儲存 ICollection<T><篩選> 中相符的 MessageFilter 物件。

傳回

Boolean

如果 true 符合資料表中至少一個篩選條件的比對準則，則為 messageBuffer，如果沒有符合任何篩選條件，則為 false。

例外狀況

ArgumentNullException

navigator 或 results 為 null。

備註

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

如果預期只有一個篩選條件要比對訊息，便可使用 GetMatchingFilter 方法。

GetMatchingFilters(Message, ICollection<MessageFilter>)

傳回值，這個值表示指定的訊息是否符合資料表中至少一個 XPathMessageFilter 的比對準則，並且將相符的篩選條件加入至集合。

public:
 virtual bool GetMatchingFilters(System::ServiceModel::Channels::Message ^ message, System::Collections::Generic::ICollection<System::ServiceModel::Dispatcher::MessageFilter ^> ^ results);

public bool GetMatchingFilters (System.ServiceModel.Channels.Message message, System.Collections.Generic.ICollection<System.ServiceModel.Dispatcher.MessageFilter> results);

abstract member GetMatchingFilters : System.ServiceModel.Channels.Message * System.Collections.Generic.ICollection<System.ServiceModel.Dispatcher.MessageFilter> -> bool
override this.GetMatchingFilters : System.ServiceModel.Channels.Message * System.Collections.Generic.ICollection<System.ServiceModel.Dispatcher.MessageFilter> -> bool

Public Function GetMatchingFilters (message As Message, results As ICollection(Of MessageFilter)) As Boolean

參數

message

Message

要測試的 Message。

results

ICollection<MessageFilter>

參考參數，其中儲存 ICollection<T><篩選> 中相符的 MessageFilter 物件。

傳回

Boolean

如果 true 符合資料表中至少一個篩選條件的比對準則，則為 message，如果沒有符合任何篩選條件，則為 false。

實作

GetMatchingFilters(Message, ICollection<MessageFilter>)

例外狀況

ArgumentNullException

message 或 results 為 null。

InvalidBodyAccessException

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

備註

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

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

相符的 XPathMessageFilter 物件會儲存在 results 的 ICollection<T> 參數中。 您之後可以搭配 FilterData 提供的方法使用這些篩選條件做為索引鍵，從篩選資料表中重新取得 IDictionary<TKey,TValue>。

這個方法會實作 GetMatchingFilters。

GetMatchingFilters(MessageBuffer, ICollection<MessageFilter>)

傳回值，這個值表示指定的經緩衝處理訊息是否符合資料表中至少一個 XPathMessageFilter 的比對準則，並且將相符的篩選條件加入至集合。

public:
 virtual bool GetMatchingFilters(System::ServiceModel::Channels::MessageBuffer ^ messageBuffer, System::Collections::Generic::ICollection<System::ServiceModel::Dispatcher::MessageFilter ^> ^ results);

public bool GetMatchingFilters (System.ServiceModel.Channels.MessageBuffer messageBuffer, System.Collections.Generic.ICollection<System.ServiceModel.Dispatcher.MessageFilter> results);

abstract member GetMatchingFilters : System.ServiceModel.Channels.MessageBuffer * System.Collections.Generic.ICollection<System.ServiceModel.Dispatcher.MessageFilter> -> bool
override this.GetMatchingFilters : System.ServiceModel.Channels.MessageBuffer * System.Collections.Generic.ICollection<System.ServiceModel.Dispatcher.MessageFilter> -> bool

Public Function GetMatchingFilters (messageBuffer As MessageBuffer, results As ICollection(Of MessageFilter)) As Boolean

參數

messageBuffer

MessageBuffer

要測試的 MessageBuffer。

results

ICollection<MessageFilter>

參考參數，其中儲存 ICollection<T><篩選> 中相符的 MessageFilter 物件。

傳回

Boolean

如果 true 符合資料表中至少一個篩選條件的比對準則，則為 messageBuffer，如果沒有符合任何篩選條件，則為 false。

實作

GetMatchingFilters(MessageBuffer, ICollection<MessageFilter>)

例外狀況

ArgumentNullException

messageBuffer 或 results 為 null。

備註

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

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

相符的 MessageFilter 物件會儲存在 results 的 ICollection<T> 參數中。 您之後可以搭配 FilterData 提供的方法使用這些篩選條件做為索引鍵，從篩選資料表中重新取得 IDictionary<TKey,TValue>。

這個方法會實作 GetMatchingFilters。