MessageFilterTable<TFilterData>.GetMatchingValues 方法

定義

命名空間:

System.ServiceModel.Dispatcher

組件:

System.ServiceModel.dll

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

多載

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

備註

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

GetMatchingValues(Message, ICollection<TFilterData>)

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

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>

參考參數，這個參考參數會將比對動作篩選 FilterData 儲存在泛型 ICollection<T><FilterData>中。

傳回

Boolean

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

實作

GetMatchingValues(Message, ICollection<TFilterData>)

例外狀況

ArgumentNullException

results null。

InvalidBodyAccessException

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

備註

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

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

這個方法會實作 GetMatchingValues。

GetMatchingValues(MessageBuffer, ICollection<TFilterData>)

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

public:
 virtual bool GetMatchingValues(System::ServiceModel::Channels::MessageBuffer ^ buffer, System::Collections::Generic::ICollection<TFilterData> ^ results);

public bool GetMatchingValues (System.ServiceModel.Channels.MessageBuffer buffer, 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 (buffer As MessageBuffer, results As ICollection(Of TFilterData)) As Boolean

參數

buffer

MessageBuffer

要測試的 MessageBuffer。

results

ICollection<TFilterData>

參考參數，這個參考參數會儲存 buffer所滿足之篩選條件的篩選數據。

傳回

Boolean

true 緩衝訊息是否滿足數據表中一個 ActionMessageFilter 的比對準則;如果不符合任何篩選條件，false。

實作

GetMatchingValues(MessageBuffer, ICollection<TFilterData>)

例外狀況

ArgumentNullException

results null。

備註

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

相符 MessageFilter 物件的 FilterData 會儲存在 resultsICollection<T>中。

這個方法會實作 GetMatchingValues。