EndpointReference.Via Property

  • Article

Represents an intermediary through which a SOAP message is sent.

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

Usage

'Usage
Dim endpointReference1 As EndpointReference

Dim returnValue As Via
returnValue = endpointReference1.Via

Dim sampleValue As Via
endpointReference1.Via = sampleValue

Syntax

'Declaration
Public Property Via() As Via

public Via Via {get; set;}

public:
property Via^ Via {
    Via^ get();
    void set(Via^ value);
}

public Via get_Via();
public void set_Via(Via);

public function get Via() : Via;
public function set Via(Via);

Property Value

A Via that represents an intermediary through which a SOAP message is sent.

Remarks

If a SOAP message is sent using SOAP Messaging, the Via property represents a transport address through which the message is sent. The response to the SOAP message is sent according to the following rules:

  1. If the call to the Web service is successful, the response is sent to the ReplyTo address, if present. If a fault is generated by the Web service, then the response is sent to the FaultTo address, if present.

  2. If the ReplyTo and FaultTo addresses are not specified, then the response to the SOAP message is sent to the Via address specified in the From object associated with the call to the Web service, if present.

  3. If the Via address is not set, then the response to the SOAP message is sent to the Address specified in the From object associated with the call to the Web service.

The <via> element is described in detail in WS-Routing (https://msdn.microsoft.com/library/en-us/dnglobspec/html/ws-routing.asp) and WS-Referral (https://msdn.microsoft.com/library/en-us/dnglobspec/html/ws-referral.asp).

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