ClaimsIdentity.RoleClaimType Property

Artigo
10/05/2012

[Starting with the .NET Framework 4.5, Windows Identity Foundation (WIF) has been fully integrated into the .NET Framework. The version of WIF addressed by this topic, WIF 3.5, is deprecated and should only be used when developing against the .NET Framework 3.5 SP1 or the .NET Framework 4. For more information about WIF in the .NET Framework 4.5, also known as WIF 4.5, see the Windows Identity Foundation documentation in the .NET Framework 4.5 Development Guide.]

Gets or sets the claim type used for the IsInRole method.

Namespace: Microsoft.IdentityModel.Claims
Assembly: Microsoft.IdentityModel (in Microsoft.IdentityModel.dll)

Usage

'Usage
Dim instance As ClaimsIdentity
Dim value As String

value = instance.RoleClaimType

instance.RoleClaimType = value

Syntax

'Declaration
Public Property RoleClaimType As String

public string RoleClaimType { get; set; }

public:
virtual property String^ RoleClaimType {
    String^ get () sealed;
    void set (String^ value) sealed;
}

/** @property */
public final String get_RoleClaimType ()

/** @property */
public final void set_RoleClaimType (String value)

public final function get RoleClaimType () : String

public final function set RoleClaimType (value : String)

Property Value

The claim type to be used when evaluating this identity for the IsInRole method. The default is ClaimTypes.Role.

Exceptions

Exception type	Condition

Remarks

The IsInRole method is used to determine whether the current principal is in a specified role. The claims-based model extends this check to use claims presented by the principal. An IClaimsPrincipal object can contain one or more IClaimsIdentity objects and each identity object can contain multiple Claim objects. The RoleClaimType property specifies the claim type of the claim that should be used to provide the value for the role when evaluating this ClaimsIdentity object. The property could be set, for example, to one of the constants specified by ClaimTypes.

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

Target Platforms

Windows 7, Windows Server 2008 R2, Windows Vista SP2, Windows Server 2008 SP2, Windows Server 2003 SP2 (32-bit or 64-bit)

Compartilhar via