MessageFilterTable<TFilterData>.GetMatchingFilters 方法

定義

命名空間:

System.ServiceModel.Dispatcher

組件:

System.ServiceModel.dll

傳回值，這個值會指出指定的訊息或經緩衝處理的訊息是否符合資料表中 MessageFilter 的比對準則，並且將相符的篩選條件新增至集合。

多載

GetMatchingFilters(Message, ICollection<MessageFilter>)	傳回值，這個值會指出指定的訊息是否符合資料表中 MessageFilter 的比對準則，並且將相符的篩選條件新增至集合。
GetMatchingFilters(MessageBuffer, ICollection<MessageFilter>)	傳回值，這個值表示指定的經緩衝處理訊息是否符合資料表中至少一個篩選條件的比對準則，並且從其中至少找到一個相符條件之一組最高優先權篩選條件，將相符的篩選條件加入至集合。

備註

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

GetMatchingFilters(Message, ICollection<MessageFilter>)

傳回值，這個值會指出指定的訊息是否符合資料表中 MessageFilter 的比對準則，並且將相符的篩選條件新增至集合。

public:
 virtual bool GetMatchingFilters(System::ServiceModel::Channels::Message ^ message, System::Collections::Generic::ICollection<System::ServiceModel::Dispatcher::MessageFilter ^> ^ results);

public bool GetMatchingFilters (System.ServiceModel.Channels.Message message, System.Collections.Generic.ICollection<System.ServiceModel.Dispatcher.MessageFilter> results);

abstract member GetMatchingFilters : System.ServiceModel.Channels.Message * System.Collections.Generic.ICollection<System.ServiceModel.Dispatcher.MessageFilter> -> bool
override this.GetMatchingFilters : System.ServiceModel.Channels.Message * System.Collections.Generic.ICollection<System.ServiceModel.Dispatcher.MessageFilter> -> bool

Public Function GetMatchingFilters (message As Message, results As ICollection(Of MessageFilter)) As Boolean

參數

message

Message

要測試的 Message。

results

ICollection<MessageFilter>

參考參數，其中儲存 ICollection<T><篩選> 中相符的 MessageFilter 物件。

傳回

Boolean

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

實作

GetMatchingFilters(Message, ICollection<MessageFilter>)

例外狀況

ArgumentNullException

results 為 null。

InvalidBodyAccessException

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

備註

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

這個方法會測試至少有一個相符篩選條件之篩選條件最高優先權 Bucket 中的所有相符篩選條件。

資料表中的篩選條件不可以檢查訊息本文。

相符的 MessageFilter 物件會儲存在 results 的 ICollection<T> 參數中。 您之後可以搭配 FilterData 提供的方法使用這些篩選條件做為索引鍵，從篩選資料表中重新取得 IDictionary<TKey,TValue>。

這個方法會實作 GetMatchingFilters。

GetMatchingFilters(MessageBuffer, ICollection<MessageFilter>)

傳回值，這個值表示指定的經緩衝處理訊息是否符合資料表中至少一個篩選條件的比對準則，並且從其中至少找到一個相符條件之一組最高優先權篩選條件，將相符的篩選條件加入至集合。

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

public bool GetMatchingFilters (System.ServiceModel.Channels.MessageBuffer buffer, System.Collections.Generic.ICollection<System.ServiceModel.Dispatcher.MessageFilter> results);

abstract member GetMatchingFilters : System.ServiceModel.Channels.MessageBuffer * System.Collections.Generic.ICollection<System.ServiceModel.Dispatcher.MessageFilter> -> bool
override this.GetMatchingFilters : System.ServiceModel.Channels.MessageBuffer * System.Collections.Generic.ICollection<System.ServiceModel.Dispatcher.MessageFilter> -> bool

Public Function GetMatchingFilters (buffer As MessageBuffer, results As ICollection(Of MessageFilter)) As Boolean

參數

buffer

MessageBuffer

要測試的 MessageBuffer。

results

ICollection<MessageFilter>

參考參數，其中儲存 ICollection<T><篩選> 中相符的 MessageFilter 物件。

傳回

Boolean

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

實作

GetMatchingFilters(MessageBuffer, ICollection<MessageFilter>)

例外狀況

ArgumentNullException

results 為 null。

備註

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

資料表中的篩選條件可以檢查訊息本文。

相符的 MessageFilter 物件會儲存在 results 的 ICollection<T> 參數中。 您之後可以搭配 FilterData 提供的方法使用這些篩選條件做為索引鍵，從篩選資料表中重新取得 IDictionary<TKey,TValue>。

這個方法會實作 GetMatchingFilters。