RolePrincipal Constructores

Definición

Espacio de nombres:

System.Web.Security

Ensamblado:

System.Web.dll

Crea una nueva instancia de la clase RolePrincipal.

Sobrecargas

RolePrincipal(IIdentity)	Crea una instancia de un objeto RolePrincipal correspondiente a la identity especificada.
RolePrincipal(SerializationInfo, StreamingContext)	Inicializa una nueva instancia de la clase RolePrincipal, usando la información contenido en el objeto SerializationInfo especificado y el contexto de transmisión por secuencias especificado.
RolePrincipal(IIdentity, String)	Crea una instancia de un objeto RolePrincipal para la identity especificada con información de roles del encryptedTicket especificado.
RolePrincipal(String, IIdentity)	Crea una instancia de un objeto RolePrincipal para la identity especificada utilizando el providerName especificado.
RolePrincipal(String, IIdentity, String)	Crea una instancia de un objeto RolePrincipal para la identity especificada utilizando el providerName especificado e información de roles del encryptedTicket especificado.

RolePrincipal(IIdentity)

Crea una instancia de un objeto RolePrincipal correspondiente a la identity especificada.

public:
 RolePrincipal(System::Security::Principal::IIdentity ^ identity);

public RolePrincipal (System.Security.Principal.IIdentity identity);

new System.Web.Security.RolePrincipal : System.Security.Principal.IIdentity -> System.Web.Security.RolePrincipal

Public Sub New (identity As IIdentity)

Parámetros

identity

IIdentity

La identidad de usuario para la que se va a crear la clase RolePrincipal.

Excepciones

ArgumentNullException

identity es null.

Ejemplos

En el ejemplo de código siguiente se crea un nuevo RolePrincipal objeto . Si CacheRolesInCookie es true, el ejemplo crea con RolePrincipal información de cookie a partir de la cookie identificada por la CookieName propiedad .

RolePrincipal r;

if (Roles.CacheRolesInCookie)
{
  string roleCookie = "";

  HttpCookie cookie = HttpContext.Current.Request.Cookies[Roles.CookieName];
  if (cookie != null) { roleCookie = cookie.Value; }

  r = new RolePrincipal(User.Identity, roleCookie);
}
else
{
  r = new RolePrincipal(User.Identity);
}

Dim r As RolePrincipal

If Roles.CacheRolesInCookie Then
  Dim roleCookie As String = ""

  Dim cookie As HttpCookie = HttpContext.Current.Request.Cookies(Roles.CookieName)
  If Not cookie Is Nothing Then roleCookie = cookie.Value

  r = New RolePrincipal(User.Identity, roleCookie)
Else
  r = new RolePrincipal(User.Identity)
End If

Comentarios

Esta sobrecarga del RolePrincipal constructor crea un nuevo RolePrincipal objeto e inicializa sus valores de propiedad. La información de rol almacenada en caché no se lee de la cookie identificada por la CookieName propiedad . La ProviderName propiedad se establece en del Name proveedor de roles predeterminado.

Para obtener información sobre cómo habilitar la administración de roles, consulte la Roles clase .

Consulte también

• Administración de la autorización mediante roles de ASP.NET

RolePrincipal(SerializationInfo, StreamingContext)

Inicializa una nueva instancia de la clase RolePrincipal, usando la información contenido en el objeto SerializationInfo especificado y el contexto de transmisión por secuencias especificado.

protected:
 RolePrincipal(System::Runtime::Serialization::SerializationInfo ^ info, System::Runtime::Serialization::StreamingContext context);

protected RolePrincipal (System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);

new System.Web.Security.RolePrincipal : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> System.Web.Security.RolePrincipal

Protected Sub New (info As SerializationInfo, context As StreamingContext)

Parámetros

info

SerializationInfo

Objeto SerializationInfo que se va a rellenar con datos.

context

StreamingContext

Destino de esta serialización.

RolePrincipal(IIdentity, String)

Crea una instancia de un objeto RolePrincipal para la identity especificada con información de roles del encryptedTicket especificado.

public:
 RolePrincipal(System::Security::Principal::IIdentity ^ identity, System::String ^ encryptedTicket);

public RolePrincipal (System.Security.Principal.IIdentity identity, string encryptedTicket);

new System.Web.Security.RolePrincipal : System.Security.Principal.IIdentity * string -> System.Web.Security.RolePrincipal

Public Sub New (identity As IIdentity, encryptedTicket As String)

Parámetros

identity

IIdentity

La identidad de usuario para la que se va a crear la clase RolePrincipal.

encryptedTicket

String

Una cadena que contiene la información de roles cifrada.

Excepciones

ArgumentNullException

identity es null.

O bien encryptedTicket es null.

Ejemplos

En el ejemplo de código siguiente se crea un nuevo RolePrincipal objeto . Si CacheRolesInCookie es true, el ejemplo crea con RolePrincipal información de cookie a partir de la cookie identificada por la CookieName propiedad .

RolePrincipal r;

if (Roles.CacheRolesInCookie)
{
  string roleCookie = "";

  HttpCookie cookie = HttpContext.Current.Request.Cookies[Roles.CookieName];
  if (cookie != null) { roleCookie = cookie.Value; }

  r = new RolePrincipal(User.Identity, roleCookie);
}
else
{
  r = new RolePrincipal(User.Identity);
}

Dim r As RolePrincipal

If Roles.CacheRolesInCookie Then
  Dim roleCookie As String = ""

  Dim cookie As HttpCookie = HttpContext.Current.Request.Cookies(Roles.CookieName)
  If Not cookie Is Nothing Then roleCookie = cookie.Value

  r = New RolePrincipal(User.Identity, roleCookie)
Else
  r = new RolePrincipal(User.Identity)
End If

Comentarios

Importante

Usar una instancia de este objeto con datos que no son de confianza supone un riesgo de seguridad. Utilice este objeto solo con datos de confianza. Para obtener más información, vea Validar todas las entradas.

Esta sobrecarga del RolePrincipal constructor crea un nuevo RolePrincipal objeto e inicializa sus valores de propiedad. La información de rol para el usuario actual se lee desde el proporcionado encryptedTicket y almacenado en caché con el RolePrincipal objeto . La ProviderName propiedad se establece en del Name proveedor de roles predeterminado.

Para obtener información sobre cómo habilitar la administración de roles, consulte la Roles clase .

Consulte también

• Administración de la autorización mediante roles de ASP.NET

RolePrincipal(String, IIdentity)

Crea una instancia de un objeto RolePrincipal para la identity especificada utilizando el providerName especificado.

public:
 RolePrincipal(System::String ^ providerName, System::Security::Principal::IIdentity ^ identity);

public RolePrincipal (string providerName, System.Security.Principal.IIdentity identity);

new System.Web.Security.RolePrincipal : string * System.Security.Principal.IIdentity -> System.Web.Security.RolePrincipal

Public Sub New (providerName As String, identity As IIdentity)

Parámetros

providerName

String

El nombre del proveedor de roles para el usuario.

identity

IIdentity

La identidad de usuario para la que se va a crear la clase RolePrincipal.

Excepciones

ArgumentNullException

identity es null.

ArgumentException

providerName es null.

o bien providerName hace referencia a un proveedor de roles que no existe en la configuración de la aplicación.

Comentarios

Esta sobrecarga del RolePrincipal constructor crea un nuevo RolePrincipal objeto e inicializa sus valores de propiedad. La ProviderName propiedad se establece en el valor especificado en el providerName parámetro .

Para obtener información sobre cómo habilitar la administración de roles, consulte la Roles clase .

Consulte también

• Administración de la autorización mediante roles de ASP.NET

RolePrincipal(String, IIdentity, String)

Crea una instancia de un objeto RolePrincipal para la identity especificada utilizando el providerName especificado e información de roles del encryptedTicket especificado.

public:
 RolePrincipal(System::String ^ providerName, System::Security::Principal::IIdentity ^ identity, System::String ^ encryptedTicket);

public RolePrincipal (string providerName, System.Security.Principal.IIdentity identity, string encryptedTicket);

new System.Web.Security.RolePrincipal : string * System.Security.Principal.IIdentity * string -> System.Web.Security.RolePrincipal

Public Sub New (providerName As String, identity As IIdentity, encryptedTicket As String)

Parámetros

providerName

String

El nombre del proveedor de roles para el usuario.

identity

IIdentity

La identidad de usuario para la que se va a crear la clase RolePrincipal.

encryptedTicket

String

Una cadena que contiene la información de roles cifrada.

Excepciones

ArgumentNullException

identity es null.

O bien encryptedTicket es null.

ArgumentException

providerName es null.

o bien providerName hace referencia a un proveedor de roles que no existe en la configuración de la aplicación.

Comentarios

Importante

Usar una instancia de este objeto con datos que no son de confianza supone un riesgo de seguridad. Utilice este objeto solo con datos de confianza. Para obtener más información, vea Validar todas las entradas.

Esta sobrecarga del RolePrincipal constructor crea un nuevo RolePrincipal objeto e inicializa sus valores de propiedad. La información de rol para el usuario actual se lee desde el proporcionado encryptedTicket y almacenado en caché con el RolePrincipal objeto . La ProviderName propiedad se establece en el valor especificado en el providerName parámetro .

Para obtener información sobre cómo habilitar la administración de roles, consulte la Roles clase .

Consulte también

• Administración de la autorización mediante roles de ASP.NET