EndpointAddressMessageFilter.Match Method

Definition

Namespace:

System.ServiceModel.Dispatcher

Assembly:

System.ServiceModel.dll

Tests whether a message or buffered message satisfies the criteria of the endpoint filter.

Overloads

Match(Message)	Tests whether a message satisfies the specified endpoint address.
Match(MessageBuffer)	Tests whether a buffered message satisfies the specified endpoint address.

Remarks

The difference between the two overloads of the Match method is that the one that takes the MessageBuffer parameter is permitted to examine the body of a message when testing for a match, while the one that takes the Message parameter is not.

Match does not test the contents of the body of a message, so these two methods are equivalent.

Match(Message)

Tests whether a message satisfies the specified endpoint address.

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 object to test.

Returns

Boolean

true if the Message object satisfies the endpoint address specified in the filter; otherwise, false.

Exceptions

ArgumentNullException

message is null.

Remarks

The two overloads of this method are equivalent because they both examine only message headers.

Match(MessageBuffer)

Tests whether a buffered message satisfies the specified endpoint address.

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 object to test.

Returns

Boolean

true if the MessageBuffer object satisfies the endpoint address; otherwise, false.

Exceptions

ArgumentNullException

messageBuffer is null.

Remarks

The two overloads of this method are equivalent because they both examine only message headers. The only reason to use this overload is if you already had a messageBuffer available and not a message, because this method converts the messageBuffer into a message.