XPathMessageFilterTable<TFilterData>.GetMatchingValues 方法

定義

命名空間:

System.ServiceModel.Dispatcher

組件:

System.ServiceModel.dll

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

多載

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

備註

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

GetMatchingValues(Message, ICollection<TFilterData>)

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

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

public bool GetMatchingValues (System.ServiceModel.Channels.Message message, System.Collections.Generic.ICollection<TFilterData> results);

abstract member GetMatchingValues : System.ServiceModel.Channels.Message * System.Collections.Generic.ICollection<'FilterData> -> bool
override this.GetMatchingValues : System.ServiceModel.Channels.Message * System.Collections.Generic.ICollection<'FilterData> -> bool

Public Function GetMatchingValues (message As Message, results As ICollection(Of TFilterData)) As Boolean

參數

message

Message

要測試的 Message。

results

ICollection<TFilterData>

參考參數，將相符篩選條件的篩選資料儲存在泛型的 ICollection<T><FilterData> 中。

傳回

Boolean

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

實作

GetMatchingValues(Message, ICollection<TFilterData>)

例外狀況

ArgumentNullException

message 或 results 為 null。

InvalidBodyAccessException

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

備註

當預期有一個以上的篩選條件要比對該訊息、並且只需要取得篩選資料，而且不檢查訊息本文時，便可使用這個方法。

相符 MessageFilter 物件的篩選資料會儲存在 results 的 ICollection<T> 參數中。

這個方法會實作 GetMatchingValues。

GetMatchingValues(MessageBuffer, ICollection<TFilterData>)

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

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

public bool GetMatchingValues (System.ServiceModel.Channels.MessageBuffer messageBuffer, System.Collections.Generic.ICollection<TFilterData> results);

abstract member GetMatchingValues : System.ServiceModel.Channels.MessageBuffer * System.Collections.Generic.ICollection<'FilterData> -> bool
override this.GetMatchingValues : System.ServiceModel.Channels.MessageBuffer * System.Collections.Generic.ICollection<'FilterData> -> bool

Public Function GetMatchingValues (messageBuffer As MessageBuffer, results As ICollection(Of TFilterData)) As Boolean

參數

messageBuffer

MessageBuffer

要測試的 MessageBuffer。

results

ICollection<TFilterData>

參考參數，將相符篩選條件的篩選資料儲存在泛型的 ICollection<T><FilterData> 中。

傳回

Boolean

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

實作

GetMatchingValues(MessageBuffer, ICollection<TFilterData>)

例外狀況

ArgumentNullException

messageBuffer 或 results 為 null。

備註

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

相符 XPathMessageFilter 物件的篩選資料會儲存在 中 results ICollection<T> 。

這個方法會實作 GetMatchingValues。

GetMatchingValues(SeekableXPathNavigator, ICollection<TFilterData>)

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

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

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

member this.GetMatchingValues : System.ServiceModel.Dispatcher.SeekableXPathNavigator * System.Collections.Generic.ICollection<'FilterData> -> bool

Public Function GetMatchingValues (navigator As SeekableXPathNavigator, results As ICollection(Of TFilterData)) As Boolean

參數

navigator

SeekableXPathNavigator

要測試的 SeekableXPathNavigator。

results

ICollection<TFilterData>

參考參數，將相符篩選條件的篩選資料儲存在泛型的 ICollection<T><FilterData> 中。

傳回

Boolean

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

例外狀況

ArgumentNullException

navigator 或 results 為 null。

備註

當預期有一個以上的篩選條件要比對衍生自最佳化 XPath 導覽 SeekableXPathNavigator 之 XML 文件的查詢準則，而且只需要取得篩選資料時，便可使用這個方法。

相符 XPathMessageFilter 物件的篩選資料會儲存在 results 的 ICollection<T> 參數中。

GetMatchingValues(XPathNavigator, ICollection<TFilterData>)

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

public:
 bool GetMatchingValues(System::Xml::XPath::XPathNavigator ^ navigator, System::Collections::Generic::ICollection<TFilterData> ^ results);

public bool GetMatchingValues (System.Xml.XPath.XPathNavigator navigator, System.Collections.Generic.ICollection<TFilterData> results);

member this.GetMatchingValues : System.Xml.XPath.XPathNavigator * System.Collections.Generic.ICollection<'FilterData> -> bool

Public Function GetMatchingValues (navigator As XPathNavigator, results As ICollection(Of TFilterData)) As Boolean

參數

navigator

XPathNavigator

要測試的 XPathNavigator。

results

ICollection<TFilterData>

參考參數，將相符篩選條件的篩選資料儲存在泛型的 ICollection<T><FilterData> 中。

傳回

Boolean

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

例外狀況

ArgumentNullException

navigator 或 results 為 null。

備註

當預期有一個以上的篩選條件要比對衍生自最佳化 XPath 導覽 SeekableXPathNavigator 之 XML 文件的查詢準則，而且只需要取得篩選資料時，便可使用這個方法。

相符 XPathMessageFilter 物件的篩選資料會儲存在 results 的 ICollection<T> 參數中。