Rediger

Del via


EndpointAddressMessageFilter.Match Method

Definition

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

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

Exceptions

message is null.

Remarks

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

Applies to

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

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

Exceptions

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.

Applies to