Share via


EndpointReference Class

Represents an XML type that is a reference to a Web service endpoint.

Namespace: Microsoft.Web.Services2.Addressing
Assembly: Microsoft.Web.Services2 (in microsoft.web.services2.dll)

Usage

'Usage
Dim endpointReference1 As New EndpointReference()

Syntax

'Declaration
Public Class EndpointReference
    Inherits OpenElement
    Implements ICloneable
public class EndpointReference : OpenElement, ICloneable
public ref class EndpointReference : public OpenElement, ICloneable
public class EndpointReference extends OpenElement implements ICloneable
public class EndpointReference extends OpenElement implements ICloneable

Remarks

Two EndpointReference objects must match exactly for them to be considered equal. For example, if a Web service that is based on SOAP Messaging registers with an EndpointReference that refers to a fully qualified DNS name, including host name and domain name, and a request comes in to the Web service with an EndpointReference that does not contain the domain name, WSE throws an exception. To avoid this, create a new instance of an EndpointReference using the constructor that takes a URI for the destination and a Via with the host name.

Note

If you build a cross-domain Web service, you must register the SoapReceiver using the full domain name of the EndpointReference. Otherwise, the Web service will not be accessible outside the domain that the Web service was created in.

The EndpointReference class corresponds to the EndpointReference XML type described in the WS-Addressing specification (https://msdn.microsoft.com/library/en-us/dnglobspec/html/ws-addressing.asp).

Inheritance Hierarchy

System.Object
   Microsoft.Web.Services2.Xml.OpenElementElement
     Microsoft.Web.Services2.Xml.OpenElement
      Microsoft.Web.Services2.Addressing.EndpointReference
         Microsoft.Web.Services2.Addressing.FaultTo
         Microsoft.Web.Services2.Addressing.From
         Microsoft.Web.Services2.Addressing.ReplyTo

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

See Also

Reference

Microsoft.Web.Services2.Addressing Namespace

Other Resources

EndpointReference Members