EndpointReference.Matches Method

Article
09/15/2006

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

Namespace: Microsoft.Web.Services2.Addressing
Assembly: Microsoft.Web.Services2 (in microsoft.web.services2.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: Boolean 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.
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 EndpointReference 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 Longhorn, and Windows 2000

Target Platforms

Windows 2000, Windows 2000 Server, Windows 2000 Advanced Server, Windows XP Home Edition, Windows XP Professional, Windows Server 2003, Windows Longhorn, Pocket PC, Windows CE, Smart Phone

Share via