EndpointAddressMessageFilter.Match Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
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 -> boolPublic Overrides Function Match (message As Message) As BooleanParameters
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 -> boolPublic Overrides Function Match (messageBuffer As MessageBuffer) As BooleanParameters
- 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.
