This documentation is archived and is not being maintained.

MessageFilterTable<TFilterData>.Add Method (MessageFilter, TFilterData, Int32)

Adds a filter and its associated FilterData to the action filter table with a specified priority.

Namespace:  System.ServiceModel.Dispatcher
Assembly:  System.ServiceModel (in System.ServiceModel.dll)

public void Add(
	MessageFilter filter,
	TFilterData data,
	int priority


Type: System.ServiceModel.Dispatcher.MessageFilter
The MessageFilter used as the key of the pair added.
Type: TFilterData
The FilterData associated with the filter used as the value of the pair added.
Type: System.Int32
The priority of the filter added.


filter cannot be null.


filter already exists in the table.


filter type does not match table type.

The priority is an integer value used to group filters into priority buckets and order their processing. The larger the integer assigned to a filter type, the higher its priority for processing. All the filter tables in a priority bucket are evaluated together. Lower priority buckets are only evaluated if higher priority buckets do not provide any matches. Use Add to add a filter with the default priority. The default priority can be set using DefaultPriority. The default is initially set to 0.

.NET Framework

Supported in: 4, 3.5, 3.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.