RolePrincipal Constructores

Definición

Espacio de nombres:

System.Web.Security

Ensamblado:

System.Web.dll

Crea una nueva instancia de la RolePrincipal clase .

Sobrecargas

Nombre	Description
RolePrincipal(IIdentity)	Crea una instancia de un RolePrincipal objeto para el especificado identity.
RolePrincipal(SerializationInfo, StreamingContext)	Inicializa una nueva instancia de la RolePrincipal clase utilizando información contenida en el objeto especificado SerializationInfo y utilizando el contexto de streaming especificado.
RolePrincipal(IIdentity, String)	Crea una instancia de un RolePrincipal objeto para el especificado identity con información de rol del especificado encryptedTicket.
RolePrincipal(String, IIdentity)	Crea una instancia de un RolePrincipal objeto para el especificado identity mediante el especificado providerName.
RolePrincipal(String, IIdentity, String)	Crea una instancia de un RolePrincipal objeto para el especificado identity mediante la información de rol y especificada providerName del especificado encryptedTicket.

RolePrincipal(IIdentity)

Crea una instancia de un RolePrincipal objeto para el especificado identity.

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

Identidad de usuario para la RolePrincipal que se va a crear.

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 RolePrincipal clase utilizando información contenida en el objeto especificado SerializationInfo y utilizando el contexto de streaming 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 RolePrincipal objeto para el especificado identity con información de rol del especificado encryptedTicket.

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

Identidad de usuario para la RolePrincipal que se va a crear.

encryptedTicket

String

Cadena que contiene información de rol 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

El uso de una instancia de este tipo con datos que no son de confianza es un riesgo de seguridad. Use 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 del usuario actual se lee de la clase proporcionada encryptedTicket y almacenada 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 RolePrincipal objeto para el especificado identity mediante el especificado providerName.

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

Nombre del proveedor de roles para el usuario.

identity

IIdentity

Identidad de usuario para la RolePrincipal que se va a crear.

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 RolePrincipal objeto para el especificado identity mediante la información de rol y especificada providerName del especificado encryptedTicket.

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

Nombre del proveedor de roles para el usuario.

identity

IIdentity

Identidad de usuario para la RolePrincipal que se va a crear.

encryptedTicket

String

Cadena que contiene información de rol 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

El uso de una instancia de este tipo con datos que no son de confianza es un riesgo de seguridad. Use 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 del usuario actual se lee de la clase proporcionada encryptedTicket y almacenada 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