Share via

ReferralCache Class

  • Article

Reflects the routing instruction found in the referral cache.

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

Usage

'Usage
Dim referralCache1 As ReferralCache

Syntax

'Declaration
NotInheritable Public Class ReferralCache

public sealed class ReferralCache

public ref class ReferralCache sealed

public final class ReferralCache

public class ReferralCache

Remarks

A ReferralCache is a file containing routing instructions. It is basically a hash table with referral statements as values and URIs as keys.

The WSE supports single-hop routing. This means that typically only a single via element will be added to a message. If no via elements are found for a destination address, the HTTP schema is used to send the message to the destination host. SSL is not used unless the referral cache specifically states that the destination is an HTTPS scheme.

Once an HTTPS endpoint must be routed to, HTTPS is always used to route to that endpoint. So, for example, the WSE does not allow the following entry into the referral cache:

On the other hand, if an HTTP endpoint is specified as a message destination, then either HTTP or HTTPS protocols may be used along the path. The size of a ReferralCache can grow and is restricted in size only by system resources.

Inheritance Hierarchy

System.Object
  Microsoft.Web.Services3.Referral.ReferralCache

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

ReferralCache Members
Microsoft.Web.Services3.Referral Namespace