Export (0) Print
Expand All

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
)

Parameters

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

ExceptionCondition
ArgumentNullException

filter cannot be null.

ArgumentException

filter already exists in the table.

InvalidOperationException

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.

Community Additions

ADD
Show:
© 2014 Microsoft