共用方式為


MessageFilterTable<TFilterData>.GetMatchingValue 方法

定義

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

多載

GetMatchingValue(Message, TFilterData)

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

GetMatchingValue(MessageBuffer, TFilterData)

傳回值,這個值表示指定的緩衝訊息是否剛好符合資料表中單一篩選的比對準則,並且將相符的篩選資料加入至集合。

備註

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

使用 GetMatchingValue 檢查訊息標頭,並使用 GetMatchingValue 檢查經緩衝處理的訊息,其中可以包括查看訊息本文。

GetMatchingValue(Message, TFilterData)

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

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 參數,其中儲存符合 messageFilterData

傳回

Boolean

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

實作

例外狀況

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

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

備註

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

這個方法會實作 GetMatchingFilter

適用於

GetMatchingValue(MessageBuffer, TFilterData)

傳回值,這個值表示指定的緩衝訊息是否剛好符合資料表中單一篩選的比對準則,並且將相符的篩選資料加入至集合。

public:
 virtual bool GetMatchingValue(System::ServiceModel::Channels::MessageBuffer ^ buffer, [Runtime::InteropServices::Out] TFilterData % data);
public bool GetMatchingValue (System.ServiceModel.Channels.MessageBuffer buffer, out TFilterData data);
abstract member GetMatchingValue : System.ServiceModel.Channels.MessageBuffer * 'FilterData -> bool
override this.GetMatchingValue : System.ServiceModel.Channels.MessageBuffer * 'FilterData -> bool
Public Function GetMatchingValue (buffer As MessageBuffer, ByRef data As TFilterData) As Boolean

參數

buffer
MessageBuffer

要測試的 MessageBuffer

data
TFilterData

out 參數,其中儲存符合 bufferFilterData

傳回

Boolean

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

實作

例外狀況

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

備註

當預期有單一篩選條件要比對經緩衝處理的訊息,而且只需要重新取得相符篩選條件的 FilterData 時,便可使用這個方法。 由於該篩選條件將會與經緩衝處理的訊息進行比對,因此它可能會對訊息本文指定條件。

這個方法會實作 GetMatchingFilter

適用於