XPathMessageFilterTable<TFilterData>.GetMatchingFilters 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
傳回值，這個值表示指定的 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> -> boolPublic Function GetMatchingFilters (navigator As SeekableXPathNavigator, results As ICollection(Of MessageFilter)) As Boolean參數
- navigator
- SeekableXPathNavigator
要測試的 SeekableXPathNavigator。
- results
- ICollection<MessageFilter>
參考參數，其中儲存 ICollection<T><篩選> 中相符的 MessageFilter 物件。
傳回
如果 true 符合資料表中至少一個篩選條件的比對準則，則為 messageBuffer，如果沒有符合任何篩選條件，則為 false。
例外狀況
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> -> boolPublic Function GetMatchingFilters (navigator As XPathNavigator, results As ICollection(Of MessageFilter)) As Boolean參數
- navigator
- XPathNavigator
要測試的 XPathNavigator。
- results
- ICollection<MessageFilter>
參考參數，其中儲存 ICollection<T><篩選> 中相符的 MessageFilter 物件。
傳回
如果 true 符合資料表中至少一個篩選條件的比對準則，則為 messageBuffer，如果沒有符合任何篩選條件，則為 false。
例外狀況
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> -> boolPublic Function GetMatchingFilters (message As Message, results As ICollection(Of MessageFilter)) As Boolean參數
- results
- ICollection<MessageFilter>
參考參數，其中儲存 ICollection<T><篩選> 中相符的 MessageFilter 物件。
傳回
如果 true 符合資料表中至少一個篩選條件的比對準則，則為 message，如果沒有符合任何篩選條件，則為 false。
實作
例外狀況
message 或 results 為 null。
篩選條件已嘗試檢查訊息本文的內容。
備註
當預期有一個以上的篩選條件要比對該訊息，而且需要取得相符的篩選條件時，便可使用這個方法。
資料表中的篩選條件不可以檢查訊息本文。
相符的 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> -> boolPublic Function GetMatchingFilters (messageBuffer As MessageBuffer, results As ICollection(Of MessageFilter)) As Boolean參數
- messageBuffer
- MessageBuffer
要測試的 MessageBuffer。
- results
- ICollection<MessageFilter>
參考參數，其中儲存 ICollection<T><篩選> 中相符的 MessageFilter 物件。
傳回
如果 true 符合資料表中至少一個篩選條件的比對準則，則為 messageBuffer，如果沒有符合任何篩選條件，則為 false。
實作
例外狀況
messageBuffer 或 results 為 null。
備註
當預期有一個以上的篩選條件要比對經緩衝處理的訊息，而且需要取得相符的篩選條件時，便可使用這個方法。
資料表中的篩選條件可以檢查訊息本文。
相符的 MessageFilter 物件會儲存在 results 的 ICollection<T> 參數中。 您之後可以搭配 FilterData 提供的方法使用這些篩選條件做為索引鍵，從篩選資料表中重新取得 IDictionary<TKey,TValue>。
這個方法會實作 GetMatchingFilters。
