RolePrincipal Construtores

Definição

Namespace:

System.Web.Security

Assembly:

System.Web.dll

Cria uma nova instância da classe RolePrincipal.

Sobrecargas

RolePrincipal(IIdentity)	Instancia um objeto RolePrincipal para o identity especificado.
RolePrincipal(SerializationInfo, StreamingContext)	Inicializa uma nova instância da classe RolePrincipal usando as informações contidas no objeto SerializationInfo especificado e usando o contexto de fluxo especificado.
RolePrincipal(IIdentity, String)	Instancia um objeto RolePrincipal para o identity especificado com informações de função do encryptedTicket especificado.
RolePrincipal(String, IIdentity)	Instancia um objeto RolePrincipal para o identity especificado usando o providerName especificado.
RolePrincipal(String, IIdentity, String)	Instancia um objeto RolePrincipal para o identity especificado usando o providerName especificado e informações de função do encryptedTicket especificado.

RolePrincipal(IIdentity)

Instancia um objeto RolePrincipal para o identity especificado.

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

A identidade do usuário para a qual criar o RolePrincipal.

Exceções

ArgumentNullException

identity é null.

Exemplos

O exemplo de código a seguir cria um novo RolePrincipal objeto. Se CacheRolesInCookie for true, o exemplo cria o RolePrincipal com informações de cookie do cookie identificado pela CookieName propriedade .

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

Comentários

Essa sobrecarga do RolePrincipal construtor cria um novo RolePrincipal objeto e inicializa seus valores de propriedade. As informações de função armazenadas em cache não são lidas do cookie identificado pela CookieName propriedade . A ProviderName propriedade é definida como o Name do provedor de função padrão.

Para obter informações sobre como habilitar o gerenciamento de função, consulte a Roles classe .

Confira também

• Gerenciando autorização usando funções ASP.NET

RolePrincipal(SerializationInfo, StreamingContext)

Inicializa uma nova instância da classe RolePrincipal usando as informações contidas no objeto SerializationInfo especificado e usando o contexto de fluxo 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

O objeto SerializationInfo a ser populado com os dados.

context

StreamingContext

O destino dessa serialização.

RolePrincipal(IIdentity, String)

Instancia um objeto RolePrincipal para o identity especificado com informações de função do 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

A identidade do usuário para a qual criar o RolePrincipal.

encryptedTicket

String

Uma cadeia de caracteres que contém informações de função criptografadas.

Exceções

ArgumentNullException

identity é null.

- ou -

encryptedTicket é null.

Exemplos

O exemplo de código a seguir cria um novo RolePrincipal objeto. Se CacheRolesInCookie for true, o exemplo cria o RolePrincipal com informações de cookie do cookie identificado pela CookieName propriedade .

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

Comentários

Importante

Usar uma instância deste objeto quando você tiver dados não confiáveis é um risco à segurança. Use esse objeto somente quando você tiver dados confiáveis. Para obter mais informações, consulte Validar todas as entradas.

Essa sobrecarga do RolePrincipal construtor cria um novo RolePrincipal objeto e inicializa seus valores de propriedade. As informações de função para o usuário atual são lidas do fornecido encryptedTicket e armazenado em cache com o RolePrincipal objeto . A ProviderName propriedade é definida como o Name do provedor de função padrão.

Para obter informações sobre como habilitar o gerenciamento de função, consulte a Roles classe .

Confira também

• Gerenciando autorização usando funções ASP.NET

RolePrincipal(String, IIdentity)

Instancia um objeto RolePrincipal para o identity especificado usando o 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

O nome do provedor de função do usuário.

identity

IIdentity

A identidade do usuário para a qual criar o RolePrincipal.

Exceções

ArgumentNullException

identity é null.

ArgumentException

providerName é null.

- ou -

providerName refere-se a um provedor de função que não existe na configuração do aplicativo.

Comentários

Essa sobrecarga do RolePrincipal construtor cria um novo RolePrincipal objeto e inicializa seus valores de propriedade. A ProviderName propriedade é definida como o valor especificado no providerName parâmetro .

Para obter informações sobre como habilitar o gerenciamento de função, consulte a Roles classe .

Confira também

• Gerenciando autorização usando funções ASP.NET

RolePrincipal(String, IIdentity, String)

Instancia um objeto RolePrincipal para o identity especificado usando o providerName especificado e informações de função do 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

O nome do provedor de função do usuário.

identity

IIdentity

A identidade do usuário para a qual criar o RolePrincipal.

encryptedTicket

String

Uma cadeia de caracteres que contém informações de função criptografadas.

Exceções

ArgumentNullException

identity é null.

- ou -

encryptedTicket é null.

ArgumentException

providerName é null.

- ou -

providerName refere-se a um provedor de função que não existe na configuração do aplicativo.

Comentários

Importante

Usar uma instância deste objeto quando você tiver dados não confiáveis é um risco à segurança. Use esse objeto somente quando você tiver dados confiáveis. Para obter mais informações, consulte Validar todas as entradas.

Essa sobrecarga do RolePrincipal construtor cria um novo RolePrincipal objeto e inicializa seus valores de propriedade. As informações de função para o usuário atual são lidas do fornecido encryptedTicket e armazenado em cache com o RolePrincipal objeto . A ProviderName propriedade é definida como o valor especificado no providerName parâmetro .

Para obter informações sobre como habilitar o gerenciamento de função, consulte a Roles classe .

Confira também

• Gerenciando autorização usando funções ASP.NET