XPathMessageFilterTable<TFilterData>.GetMatchingValues 方法

定義

命名空間:

System.ServiceModel.Dispatcher

組件:

System.ServiceModel.dll

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

多載

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

備註

當預期有多個篩選條件符合訊息或緩衝訊息，且只需要 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

如果符合數據表中至少一個篩選條件的比對準則，messagetrue;如果不符合任何篩選條件，false。

實作

GetMatchingValues(Message, ICollection<TFilterData>)

例外狀況

ArgumentNullException

message 或 resultsnull。

InvalidBodyAccessException

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

備註

當預期有多個篩選條件符合訊息時，請使用這個方法，只需要篩選數據，而且不會檢查訊息本文。

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

這個方法會實作 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

如果數據表中至少有一個篩選條件符合比對準則，truemessage;如果不符合任何篩選條件，false。

實作

GetMatchingValues(MessageBuffer, ICollection<TFilterData>)

例外狀況

ArgumentNullException

messageBuffer 或 resultsnull。

備註

當預期有多個篩選條件符合緩衝訊息，而且只需要篩選數據時，請使用這個方法。

相符 XPathMessageFilter 物件的篩選數據會儲存在 resultsICollection<T>中。

這個方法會實作 GetMatchingValues。

GetMatchingValues(SeekableXPathNavigator, ICollection<TFilterData>)

傳回值，這個值表示 navigator 是否符合數據表中至少一個 SeekableXPathNavigator 的比對準則，並將相符篩選條件的篩選數據新增至集合。

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

如果數據表中至少有一個篩選條件的比對準則由 navigator滿足，true;如果不符合任何篩選條件，false。

例外狀況

ArgumentNullException

navigator 或 resultsnull。

備註

當預期有多個篩選條件符合衍生自優化 XPath 導覽器之 XML 檔的查詢準則時，請使用這個方法 SeekableXPathNavigator，而且只需要篩選數據。

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

GetMatchingValues(XPathNavigator, ICollection<TFilterData>)

傳回值，這個值表示 navigator 是否符合數據表中至少一個 XPathNavigator 的比對準則，並將相符篩選條件的篩選數據新增至集合。

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

如果數據表中至少有一個篩選條件的比對準則由 navigator滿足，true;如果不符合任何篩選條件，false。

例外狀況

ArgumentNullException

navigator 或 resultsnull。

備註

當預期有多個篩選條件符合衍生自優化 XPath 導覽器之 XML 檔的查詢準則時，請使用這個方法 SeekableXPathNavigator，而且只需要篩選數據。

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