UsernameToken.Label Property

Gets or sets the label parameter for the key derivation algorithm.

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

Usage

'Usage
Dim usernameToken1 As UsernameToken

Dim returnValue As String
returnValue = usernameToken1.Label

Dim sampleValue As String
usernameToken1.Label = sampleValue

Syntax

'Declaration
Public Property Label() As String

public string Label {get; set;}

public: property String^ Label{
    String^ get();
    Void set(String^);
}

public System.String get_Label();
public void set_Label(System.String);

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

Property Value

The label parameter for the key derivation algorithm. The default is the value of the Microsoft.Web.Services2.Security.Tokens.UsernameTokenManager.Label property.

Exceptions

Remarks

Unlike an X509SecurityToken, a UsernameToken does not have a key associated with. Consequently, the key for a UsernameToken is generated using various properties of the token, including the Label and Nonce properties.

The default value for the Label property of UsernameToken security tokens within an application can be specified by setting the value of the <label> element in the application's configuration file. For more details, see <label> Element .

Both the sender and the receiver of a SOAP message must agree on the same label. Therefore, if you change the Label property of the UsernameToken, you must also change the Label property of the UsernameTokenManager receiving the SOAP message. This can also be accomplished by adding a <label> element with the same value to the configuration files for both the sender and receiver of the SOAP message.

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

UsernameToken Class
Microsoft.Web.Services2.Security.Tokens Namespace

Other Resources

UsernameToken Members