This documentation is archived and is not being maintained.

RolePrincipal Constructor (IIdentity, String)

Instantiates a RolePrincipal object for the specified identity with role information from the specified encryptedTicket.

Namespace:  System.Web.Security
Assembly:  System.Web (in System.Web.dll)

public:
RolePrincipal(
	IIdentity^ identity, 
	String^ encryptedTicket
)

Parameters

identity
Type: System.Security.Principal::IIdentity

The user identity to create the RolePrincipal for.

encryptedTicket
Type: System::String

A string that contains encrypted role information.

ExceptionCondition
System::ArgumentNullException

identity is nullptr.

-or-

encryptedTicket is nullptr.

This overload of the RolePrincipal constructor creates a new RolePrincipal object and initializes its property values. Role information for the current user is read from the supplied encryptedTicket and cached with the RolePrincipal object. The ProviderName property is set to the Name of the default role provider.

For information on enabling role management, see the Roles class.

The following code example creates a new RolePrincipal object. If CacheRolesInCookie is true, the example creates the RolePrincipal with cookie information from the cookie identified by the CookieName property.

No code example is currently available or this language may not be supported.

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

.NET Framework

Supported in: 3.5, 3.0, 2.0
Show: