ActionMessageFilter.Match Method

Definition

Namespace:

System.ServiceModel.Dispatcher

Assembly:

System.ServiceModel.dll

Tests whether a message or a buffered message matches one of the actions configured for the filter.

Overloads

Match(Message)	Tests whether a message's action matches one of the actions specified in this ActionMessageFilter.
Match(MessageBuffer)	Tests whether a buffered message's action header matches one of the actions specified in this ActionMessageFilter.

Remarks

The difference between the two overloads is that one takes a Message parameter and cannot examine the message body; the other takes a MessageBuffer parameter and can examine any part of the message. Because an action filter does not examine the body, these methods are equivalent.

If you must check the message against multiple ActionMessageFilter objects, put the filters into an IMessageFilterTable<TFilterData> and then use the matching functionality provided by the table.

Match(Message)

Tests whether a message's action matches one of the actions specified in this ActionMessageFilter.

public:
 override bool Match(System::ServiceModel::Channels::Message ^ message);

public override bool Match (System.ServiceModel.Channels.Message message);

override this.Match : System.ServiceModel.Channels.Message -> bool

Public Overrides Function Match (message As Message) As Boolean

Parameters

message

Message

The Message to test.

Returns

Boolean

true if the Message action header matches one of the specified actions; otherwise, false.

Exceptions

ArgumentNullException

message is null.

Remarks

Use this overload of Match when a message must be tested against the actions in a single filter and the Message is available.

Match(MessageBuffer)

Tests whether a buffered message's action header matches one of the actions specified in this ActionMessageFilter.

public:
 override bool Match(System::ServiceModel::Channels::MessageBuffer ^ messageBuffer);

public override bool Match (System.ServiceModel.Channels.MessageBuffer messageBuffer);

override this.Match : System.ServiceModel.Channels.MessageBuffer -> bool

Public Overrides Function Match (messageBuffer As MessageBuffer) As Boolean

Parameters

messageBuffer

MessageBuffer

The MessageBuffer to test.

Returns

Boolean

true if the MessageBuffer action header matches one of the specified actions; otherwise, false.

Exceptions

ArgumentNullException

messageBuffer is null.

Remarks

Use this overload of the Match method when a message must be tested against the actions in a single filter and the MessageBuffer is available.