MessageFilterTable<TFilterData>.Add Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Добавляет фильтр и сопоставленные FilterData
в таблицу фильтров.
Перегрузки
Add(KeyValuePair<MessageFilter,TFilterData>) |
Добавляет пару «фильтр/ |
Add(MessageFilter, TFilterData) |
Добавляет фильтр и сопоставленные |
Add(MessageFilter, TFilterData, Int32) |
Добавляет фильтр и сопоставленные ему |
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
>, добавленная в таблицу.
Реализации
Исключения
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
, связанный с фильтром, используемым в качестве значения в добавляемой паре.
Реализации
Исключения
filter
имеет значение null
.
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
Приоритет добавляемого фильтра.
Исключения
Параметр filter
не может иметь значение null
.
Параметр filter
уже присутствует в таблице.
Тип параметра filter
не соответствует типу таблицы.
Комментарии
Приоритетом является целое число, используемое для группировки фильтров в блок приоритетов и упорядочения их обработки. Чем больше значение целого числа, присвоенного типу фильтра, тем выше его приоритет при обработке. Все таблицы фильтров в сегменте приоритетов вычисляются вместе. Сегменты с низким приоритетом вычисляются только в случае, если для сегментов высокого приоритета не обнаружено совпадений. Используйте метод Add для добавления фильтра с приоритетом по умолчанию. Приоритет по умолчанию можно задать с помощью DefaultPriority. Исходное значение по умолчанию равно 0.