SecurityTokenReference.AbsoluteReference Property

Sets a reference to a security token.

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

Usage

'Usage
Dim securityTokenReference1 As SecurityTokenReference

Dim returnValue As String
returnValue = securityTokenReference1.AbsoluteReference

Dim sampleValue As String
securityTokenReference1.AbsoluteReference = sampleValue

Syntax

'Declaration
Public Property AbsoluteReference() As String
public string AbsoluteReference {get; set;}
public:
property String^ AbsoluteReference {
    String^ get();
    void set(String^ value);
}
public System.String get_AbsoluteReference();
public void set_AbsoluteReference(System.String);
public function get AbsoluteReference() : String;
public function set AbsoluteReference(String);

Property Value

A URI to a security token.

Exceptions

Exception type Condition
InvalidOperationException

The Token property is not equal to null.

Remarks

When you set the AbsoluteReference property and then call either the GetXml or GetInnerXml methods, a <Reference> element is added to the <SecurityTokenReference> element. The URI attribute of the <Reference> element is set to the value of the AbsoluteReference property.

WSE does not natively resolve absolute security token references. To add this functionality, create a custom security token manager for the type of security token you want this functionality for, and override the LoadTokenFromKeyInfo method. For details about creating a custom security token manager, see How to: Create a Security Token Manager for a Custom Security Token.

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

SecurityTokenReference Class
SecurityTokenReference Members
Microsoft.Web.Services3.Security Namespace
GetXml
GetInnerXml
KeyIdentifier
Embedded
Reference
RelativeReference