共用方式為


XPathMessageFilterTable<TFilterData>.GetMatchingValue 方法

定義

傳回值,這個值表示指定的文件物件是否剛好符合資料表中單一 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> 特定的多載。 如果要篩選透過導覽提供的文件,請使用 GetMatchingValueGetMatchingValue

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

實作

例外狀況

messagenull

有一個以上的篩選條件符合 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

實作

例外狀況

messagenull

有一個以上的篩選條件符合 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

參數

data
TFilterData

out 參數,其中儲存符合 navigatorFilterData

傳回

Boolean

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

例外狀況

navigatornull

有一個以上的篩選條件符合 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 參數,其中儲存符合 navigatorFilterData

傳回

Boolean

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

例外狀況

navigatornull

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

備註

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

適用於