Share via


Via Class

Represents a via element used to specify the route a message should take.

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

Usage

'Usage
Dim value As Uri
Dim via1 As New Via(value)

Syntax

'Declaration
Public Class Via
    Inherits SoapHeader
    Implements ICloneable, IXmlElement
public class Via : SoapHeader, ICloneable, IXmlElement
public ref class Via : public SoapHeader, ICloneable, IXmlElement
public class Via extends SoapHeader implements ICloneable, IXmlElement
public class Via extends SoapHeader implements ICloneable, , IXmlElement

Remarks

The via element is used to identify the routing receivers that a message is to go through.

Any sender is allowed to insert a via element in the message path, but should only do so for sound administrative reasons and must not insert one before another empty via element. Care should also be taken not to introduce infinite routing loops when adding such intermediaries.

The value of a via element can be either empty or explicitely specified by an absolute URI. The empty value indicates that an implicit endpoint is provided by an underlying protocol binding that establishes a bidirectional communication channel.

The list of via elements in the forward message path is ordered and this ordering must be respected during processing. The routing processors of these via elements may reside at the same physical host, but their physical location may not alter the order in which the via elements are processed.

Inheritance Hierarchy

System.Object
  System.Web.Services.Protocols.SoapHeader
    Microsoft.Web.Services2.Referral.Via

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.Referral Namespace

Other Resources

Via Members