MessageFilterTable<TFilterData>.Add 方法

定義

命名空間:

System.ServiceModel.Dispatcher

組件:

System.ServiceModel.dll

將篩選條件及其相關聯的 FilterData 新增至篩選資料表。

多載

Add(KeyValuePair<MessageFilter,TFilterData>)	將篩選/FilterData (索引鍵/值) 組加入至篩選資料表。
Add(MessageFilter, TFilterData)	將篩選條件及其相關聯的 FilterData 新增至篩選資料表。
Add(MessageFilter, TFilterData, Int32)	使用指定的優先權，將篩選條件及其關聯的 FilterData 新增至動作篩選資料表。

Add(KeyValuePair<MessageFilter,TFilterData>)

將篩選/FilterData (索引鍵/值) 組加入至篩選資料表。

public:
 virtual void Add(System::Collections::Generic::KeyValuePair<System::ServiceModel::Dispatcher::MessageFilter ^, TFilterData> item);

public void Add (System.Collections.Generic.KeyValuePair<System.ServiceModel.Dispatcher.MessageFilter,TFilterData> item);

abstract member Add : System.Collections.Generic.KeyValuePair<System.ServiceModel.Dispatcher.MessageFilter, 'FilterData> -> unit
override this.Add : System.Collections.Generic.KeyValuePair<System.ServiceModel.Dispatcher.MessageFilter, 'FilterData> -> unit

Public Sub Add (item As KeyValuePair(Of MessageFilter, TFilterData))

參數

item

KeyValuePair<MessageFilter,TFilterData>

已新增至資料表的 KeyValuePair<TKey,TValue> <Filter, FilterData>。

實作

Add(T)

例外狀況

ArgumentNullException

item 為 null。

Add(MessageFilter, TFilterData)

將篩選條件及其相關聯的 FilterData 新增至篩選資料表。

public:
 virtual void Add(System::ServiceModel::Dispatcher::MessageFilter ^ filter, TFilterData data);

public void Add (System.ServiceModel.Dispatcher.MessageFilter filter, TFilterData data);

abstract member Add : System.ServiceModel.Dispatcher.MessageFilter * 'FilterData -> unit
override this.Add : System.ServiceModel.Dispatcher.MessageFilter * 'FilterData -> unit

Public Sub Add (filter As MessageFilter, data As TFilterData)

參數

filter

MessageFilter

MessageFilter，用來當做已新增組的索引鍵。

data

TFilterData

與用來當作與新增組值之篩選條件建立關聯的 FilterData。

實作

Add(TKey, TValue)

例外狀況

ArgumentNullException

filter 為 null。

ArgumentException

filter 已經在資料表中。

備註

這樣會將預設優先權指派給篩選條件。 如果要指定優先權，就要使用 Add。

Add(MessageFilter, TFilterData, Int32)

使用指定的優先權，將篩選條件及其關聯的 FilterData 新增至動作篩選資料表。

public:
 void Add(System::ServiceModel::Dispatcher::MessageFilter ^ filter, TFilterData data, int priority);

public void Add (System.ServiceModel.Dispatcher.MessageFilter filter, TFilterData data, int priority);

member this.Add : System.ServiceModel.Dispatcher.MessageFilter * 'FilterData * int -> unit

Public Sub Add (filter As MessageFilter, data As TFilterData, priority As Integer)

參數

filter

MessageFilter

MessageFilter，用來當做已新增組的索引鍵。

data

TFilterData

與用來當作與新增組值之篩選條件建立關聯的 FilterData。

priority

Int32

已新增篩選的優先權。

例外狀況

ArgumentNullException

filter 不可以是 null。

ArgumentException

filter 已經存在於資料表中。

InvalidOperationException

filter 類型與資料表類型不相符。

備註

優先權是一個整數值，這個值可用來將篩選條件分組為優先權 Bucket，並且安排這些 Bucket 的處理順序。 指派給篩選條件類型的整數愈大，處理時它的優先權就愈高。 優先權 Bucket 中的所有篩選資料表都會一併進行評估。 只有當較高的優先權 Bucket 中不提供任何比對時，才會評估較低的優先權 Bucket。 使用 Add，即可新增有預設優先權的篩選條件。 預設優先權可以使用 DefaultPriority 來設定。 預設值初始設定為 0。