EndpointReference.Matches Method

Determines whether a specified message contains the same endpoint reference values as the current EndpointReference.

Namespace: Microsoft.Web.Services3.Addressing
Assembly: Microsoft.Web.Services3 (in microsoft.web.services3.dll)

Usage

'Usage
Dim message As SoapEnvelope
Dim returnValue As Boolean
Dim endpointReference1 As EndpointReference
returnValue = endpointReference1.Matches(message)

Syntax

'Declaration
Public Function Matches( _
    ByVal message As SoapEnvelope _
) As Boolean

public bool Matches(
    SoapEnvelope message
);

public:
bool Matches(
    SoapEnvelope^ message
);

public boolean Matches(
    SoapEnvelope message
);

public function Matches(
     message : SoapEnvelope
) : Boolean;

Parameters

• message
  The SoapEnvelope whose endpoint reference values will be checked against the current EndpointReference.

Return Value

true if the message contains the same endpoint reference values as the current EndpointReference; otherwise, false.

Remarks

When the Matches method checks to see if a message is addressed to an EndpointReference, it does the following:

• Compares the To to the Address property.

• Searches the header to see that it contains the ReferenceProperties.

• Ignores PortType, ServiceName, and ****Via.

• Allows additional headers, but ignores them.

• Uses the first match found, if more than one Matches is a possible match.

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Platforms

Development Platforms

Windows XP Home Edition, Windows XP Professional, Windows Server 2003, Windows 2000, Windows 2000 Server, Windows 2000 Advanced Server

Target Platforms

See Also

Reference

EndpointReference Class
EndpointReference Members
Microsoft.Web.Services3.Addressing Namespace