MessageFilterTable<TFilterData>.Add Methode

  • Referenz

Definition

Namespace:
System.ServiceModel.Dispatcher
Assembly:
System.ServiceModel.dll

Fügt der Filtertabelle einen Filter und die zugehörigen FilterData hinzu.

Überlädt

Add(KeyValuePair<MessageFilter,TFilterData>)

Fügt der Filtertabelle ein Filter/FilterData-Paar (Schlüssel/Wert-Paar) hinzu.
Add(MessageFilter, TFilterData)

Fügt der Filtertabelle einen Filter und die zugehörigen FilterData hinzu.
Add(MessageFilter, TFilterData, Int32)

Fügt der Aktionsfiltertabelle einen Filter und die zugehörigen FilterData mit einer angegebenen Priorität hinzu.

Add(KeyValuePair<MessageFilter,TFilterData>)

Fügt der Filtertabelle ein Filter/FilterData-Paar (Schlüssel/Wert-Paar) hinzu.

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))

Parameter

item
KeyValuePair<MessageFilter,TFilterData>

Das Schlüssel-Wert-Paar KeyValuePair<TKey,TValue> <Filter, FilterData>, das der Tabelle hinzugefügt wurden.

Implementiert

Add(T)

Ausnahmen

ArgumentNullException

item ist null.

Gilt für

Add(MessageFilter, TFilterData)

Fügt der Filtertabelle einen Filter und die zugehörigen FilterData hinzu.

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)

Parameter

filter
MessageFilter

Der als Schlüssel des hinzugefügten Paares verwendete MessageFilter.

data
TFilterData

Die dem Filter zugewiesenen FilterData, die als Wert des hinzugefügte Paares verwendet werden.

Implementiert

Add(TKey, TValue)

Ausnahmen

ArgumentNullException

filter ist null.

ArgumentException

filter ist bereits in der Tabelle vorhanden.

Hinweise

Weist dem Filter eine Standardpriorität zu. Verwenden Sie zur Angabe der Priorität Add.

Gilt für

Add(MessageFilter, TFilterData, Int32)

Fügt der Aktionsfiltertabelle einen Filter und die zugehörigen FilterData mit einer angegebenen Priorität hinzu.

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)

Parameter

filter
MessageFilter

Der als Schlüssel des hinzugefügten Paares verwendete MessageFilter.

data
TFilterData

Die dem Filter zugewiesenen FilterData, die als Wert des hinzugefügte Paares verwendet werden.

priority
Int32

Die Priorität des hinzugefügten Filters.

Ausnahmen

ArgumentNullException

filter darf nicht null sein.

ArgumentException

filter ist bereits in der Tabelle vorhanden.

InvalidOperationException

Der filter-Typ stimmt nicht mit dem Tabellentyp überein.

Hinweise

Als Priorität wird ein Ganzzahlwert verwendet, um Filter in Prioritäts-Buckets zu gruppieren und so die Reihenfolge ihrer Verarbeitung festzulegen. Hierbei gilt: Je größer die einem Filtertyp zugewiesene Ganzzahl, desto höher die Verarbeitungspriorität. Alle Filtertabellen in einem Prioritäts-Bucket werden zusammen ausgewertet. Buckets mit niedrigerer Priorität werden nur ausgewertet, wenn Buckets mit höherer Priorität keine Übereinstimmungen ergeben. Verwenden Sie Add, um einen Filter mit der Standardpriorität hinzuzufügen. Die Standardpriorität kann mit DefaultPriority angegeben werden. Der anfängliche Standardwert ist 0.

Gilt für