XPathMessageFilterTable<TFilterData>.GetMatchingValue 方法

定義

命名空間:

System.ServiceModel.Dispatcher

組件:

System.ServiceModel.dll

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

多載

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

備註

當預期只有單一篩選條件要比對該文件物件，而且只需要重新取得相符篩選條件的 FilterData 時，便可使用所述四種方法中的一種方法。

前兩種方法是 的實作 GetMatchingValue 。

如果不需要檢查本文內容，便可使用 GetMatchingValue。 如果可能需要檢查訊息本文的內容，便可使用 GetMatchingValue。

其餘兩個方法是 XPathMessageFilterTable<TFilterData> 特定的多載。 如果要篩選透過導覽提供的文件，請使用 GetMatchingValue 或 GetMatchingValue。

GetMatchingValue(Message, TFilterData)

傳回值，這個值表示指定的訊息是否剛好符合資料表中單一 XPathMessageFilter 的比對準則，並且傳回相符的篩選資料。

public:
 virtual bool GetMatchingValue(System::ServiceModel::Channels::Message ^ message, [Runtime::InteropServices::Out] TFilterData % data);

public bool GetMatchingValue (System.ServiceModel.Channels.Message message, out TFilterData data);

abstract member GetMatchingValue : System.ServiceModel.Channels.Message * 'FilterData -> bool
override this.GetMatchingValue : System.ServiceModel.Channels.Message * 'FilterData -> bool

Public Function GetMatchingValue (message As Message, ByRef data As TFilterData) As Boolean

參數

message

Message

要測試的 Message。

data

TFilterData

out 參數，其中儲存符合 message 之篩選條件的 FilterData。

傳回

Boolean

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

實作

GetMatchingValue(Message, TFilterData)

例外狀況

ArgumentNullException

message 為 null。

MultipleFilterMatchesException

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

備註

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

這個方法會實作 GetMatchingValue。

GetMatchingValue(MessageBuffer, TFilterData)

傳回值，這個值表示指定的經緩衝處理訊息是否剛好符合資料表中單一 XPathMessageFilter 的比對準則，並且傳回相符的篩選資料。

public:
 virtual bool GetMatchingValue(System::ServiceModel::Channels::MessageBuffer ^ messageBuffer, [Runtime::InteropServices::Out] TFilterData % data);

public bool GetMatchingValue (System.ServiceModel.Channels.MessageBuffer messageBuffer, out TFilterData data);

abstract member GetMatchingValue : System.ServiceModel.Channels.MessageBuffer * 'FilterData -> bool
override this.GetMatchingValue : System.ServiceModel.Channels.MessageBuffer * 'FilterData -> bool

Public Function GetMatchingValue (messageBuffer As MessageBuffer, ByRef data As TFilterData) As Boolean

參數

messageBuffer

MessageBuffer

要測試的 MessageBuffer。

data

TFilterData

out 參數，其中儲存符合 messageBuffer 之篩選條件的 FilterData。

傳回

Boolean

如果經緩衝處理的訊息符合資料表中一個篩選條件的比對準則，則為 true，如果沒有符合任何篩選條件，則為 false。

實作

GetMatchingValue(MessageBuffer, TFilterData)

例外狀況

ArgumentNullException

message 為 null。

MultipleFilterMatchesException

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

備註

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

這個方法會實作 GetMatchingFilter。

GetMatchingValue(SeekableXPathNavigator, TFilterData)

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

public:
 bool GetMatchingValue(System::ServiceModel::Dispatcher::SeekableXPathNavigator ^ navigator, [Runtime::InteropServices::Out] TFilterData % data);

public bool GetMatchingValue (System.ServiceModel.Dispatcher.SeekableXPathNavigator navigator, out TFilterData data);

member this.GetMatchingValue : System.ServiceModel.Dispatcher.SeekableXPathNavigator * 'FilterData -> bool

Public Function GetMatchingValue (navigator As SeekableXPathNavigator, ByRef data As TFilterData) As Boolean

參數

navigator

SeekableXPathNavigator

要測試的 SeekableXPathNavigator。

data

TFilterData

out 參數，其中儲存符合 navigator 的 FilterData。

傳回

Boolean

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

例外狀況

ArgumentNullException

navigator 為 null。

MultipleFilterMatchesException

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

備註

請使用這個方法指定訊息必須符合的 XPath 條件。

這個方法與 GetMatchingValue 類似，不過它使用的 SeekableXPathNavigator 會延伸 XPathNavigator 的功能以包含允許各種自訂的方法。

GetMatchingValue(XPathNavigator, TFilterData)

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

public:
 bool GetMatchingValue(System::Xml::XPath::XPathNavigator ^ navigator, [Runtime::InteropServices::Out] TFilterData % data);

public bool GetMatchingValue (System.Xml.XPath.XPathNavigator navigator, out TFilterData data);

member this.GetMatchingValue : System.Xml.XPath.XPathNavigator * 'FilterData -> bool

Public Function GetMatchingValue (navigator As XPathNavigator, ByRef data As TFilterData) As Boolean

參數

navigator

XPathNavigator

要測試的 XPathNavigator。

data

TFilterData

out 參數，其中儲存符合 navigator 的 FilterData。

傳回

Boolean

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

例外狀況

ArgumentNullException

navigator 為 null。

MultipleFilterMatchesException

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

備註

請使用這個方法指定訊息必須符合的 XPath 條件。