SecurityTokenReference.Reference Property

Gets or sets a reference to a security token elsewhere in the SOAP message.

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.Reference

Dim sampleValue As String
securityTokenReference1.Reference = sampleValue

Syntax

'Declaration
Public Property Reference() As String

public string Reference {get; set;}

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

public System.String get_Reference();
public void set_Reference(System.String);

public function get Reference() : String;
public function set Reference(String);

Property Value

A URI to a security token elsewhere in the SOAP message.

Exceptions

Exception type	Condition
InvalidOperationException	Reference is set when the Token property is not equal to null.

Remarks

When you set the Reference property and then call the GetXml or GetInnerXml method, a <Reference> element is added to the <SecurityTokenReference> element. The URI attribute of the <Reference> element is set to the value of the Reference property prefixed with a number sign (#).

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
AbsoluteReference
Embedded
KeyIdentifier
RelativeReference