RolePrincipal Construtores

Definição

Espaço de Nomes:: System.Web.Security

Assemblagem:: System.Web.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Cria uma nova instância da RolePrincipal classe.

Sobrecargas

Name	Description
RolePrincipal(IIdentity)	Instancia um RolePrincipal objeto para o especificado `identity`.
RolePrincipal(SerializationInfo, StreamingContext)	Inicializa uma nova instância da RolePrincipal classe usando informação contida no objeto especificado SerializationInfo e utilizando o contexto de fluxo especificado.
RolePrincipal(IIdentity, String)	Instancia um RolePrincipal objeto para o especificado `identity` com informação de função a partir do especificado `encryptedTicket`.
RolePrincipal(String, IIdentity)	Instancia um RolePrincipal objeto para o especificado `identity` usando o especificado `providerName`.
RolePrincipal(String, IIdentity, String)	Instancia um RolePrincipal objeto para o especificado `identity` usando a informação especificada `providerName` e de papel a partir do especificado `encryptedTicket`.

RolePrincipal(IIdentity)

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

A identidade do utilizador para criar o RolePrincipal for.

Exceções

ArgumentNullException

identity é null.

Exemplos

O exemplo de código seguinte cria um novo RolePrincipal objeto. Se CacheRolesInCookie for true, o exemplo cria o RolePrincipal com informação de cookie a partir 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

Observações

Esta sobrecarga do RolePrincipal construtor cria um novo RolePrincipal objeto e inicializa os seus valores de propriedades. A informação de papel em cache não é lida do cookie identificado pela CookieName propriedade. A ProviderName propriedade é definida como o Name do fornecedor de papel padrão.

Para informações sobre como habilitar a gestão de funções, consulte a Roles aula.

Ver também

Gestão da Autorização Usando Papéis ASP.NET

Aplica-se a

RolePrincipal(SerializationInfo, StreamingContext)

Inicializa uma nova instância da RolePrincipal classe usando informação contida no objeto especificado SerializationInfo e utilizando 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 SerializationInfo objeto para preencher com dados.

context: StreamingContext

O destino desta serialização.

Aplica-se a

RolePrincipal(IIdentity, String)

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

A identidade do utilizador para criar o RolePrincipal for.

encryptedTicket: String

Uma cadeia que contém informação de papel encriptada.

Exceções

ArgumentNullException

identity é null.

-ou-

encryptedTicket é null.

Exemplos

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

Observações

Importante

Utilizar uma instância deste tipo com dados não confiáveis é um risco de segurança. Use este objeto apenas com dados confiáveis. Para obter mais informações, consulte Validar todas as informações inseridas.

Esta sobrecarga do RolePrincipal construtor cria um novo RolePrincipal objeto e inicializa os seus valores de propriedades. A informação do papel do utilizador atual é lida do fornecido encryptedTicket e armazenada em cache com o RolePrincipal objeto. A ProviderName propriedade é definida como o Name do fornecedor de papel padrão.

Para informações sobre como habilitar a gestão de funções, consulte a Roles aula.

Ver também

Gestão da Autorização Usando Papéis ASP.NET

Aplica-se a

RolePrincipal(String, IIdentity)

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

O nome do fornecedor de funções para o utilizador.

identity: IIdentity

A identidade do utilizador para criar o RolePrincipal for.

Exceções

ArgumentNullException

identity é null.

ArgumentException

providerName é null.

-ou-

providerName refere-se a um fornecedor de funções que não existe na configuração da aplicação.

Observações

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

Para informações sobre como habilitar a gestão de funções, consulte a Roles aula.

Ver também

Gestão da Autorização Usando Papéis ASP.NET

Aplica-se a

RolePrincipal(String, IIdentity, String)

Instancia um RolePrincipal objeto para o especificado identity usando a informação especificada providerName e de papel a partir do 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

O nome do fornecedor de funções para o utilizador.

identity: IIdentity

A identidade do utilizador para criar o RolePrincipal for.

encryptedTicket: String

Uma cadeia que contém informação de papel encriptada.

Exceções

ArgumentNullException

identity é null.

-ou-

encryptedTicket é null.

ArgumentException

providerName é null.

-ou-

providerName refere-se a um fornecedor de funções que não existe na configuração da aplicação.

Observações

Importante

Para informações sobre como habilitar a gestão de funções, consulte a Roles aula.

Ver também

Gestão da Autorização Usando Papéis ASP.NET

Aplica-se a

Comentários

Esta página foi útil?