MessageFilterTable<TFilterData>.GetMatchingValue 方法

定義

命名空間:

System.ServiceModel.Dispatcher

組件:

System.ServiceModel.dll

傳回值，這個值表示指定的訊息或經緩衝處理的訊息是否剛好符合資料表中單一 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 參數，其中儲存符合 message 的 FilterData。

傳回

Boolean

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

實作

GetMatchingValue(Message, TFilterData)

例外狀況

MultipleFilterMatchesException

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

InvalidBodyAccessException

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

備註

當預期有單一篩選條件要比對該訊息，而且只需要重新取得相符篩選條件的 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 參數，其中儲存符合 buffer 的 FilterData。

傳回

Boolean

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

實作

GetMatchingValue(MessageBuffer, TFilterData)

例外狀況

MultipleFilterMatchesException

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

備註

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

這個方法會實作 GetMatchingFilter。