RolePrincipal Construtores

Definição

Namespace:: System.Web.Security

Assembly:: System.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Cria uma nova instância da RolePrincipal classe.

Sobrecargas

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

RolePrincipal(IIdentity)

Cria uma instância de 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 usuário para a qual RolePrincipal criar.

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 as RolePrincipal informações com 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 provedor de função padrão.

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

Confira também

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

Aplica-se a

RolePrincipal(SerializationInfo, StreamingContext)

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

O SerializationInfo objeto a ser preenchido com dados.

context: StreamingContext

O destino dessa serialização.

Aplica-se a

RolePrincipal(IIdentity, String)

Cria uma instância de um RolePrincipal objeto para o especificado identity com informações de função 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 usuário para a qual RolePrincipal criar.

encryptedTicket: String

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

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

Comentários

Importante

Usar uma instância desse tipo com dados não confiáveis é um risco à segurança. Use esse objeto somente com 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 do usuário atual são lidas do objeto fornecido encryptedTicket e armazenado em cache.RolePrincipal A ProviderName propriedade é definida como o Name provedor de função padrão.

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

Confira também

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

Aplica-se a

RolePrincipal(String, IIdentity)

Cria uma instância de 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 provedor de função para o usuário.

identity: IIdentity

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

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ções, consulte a Roles classe.

Confira também

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

Aplica-se a

RolePrincipal(String, IIdentity, String)

Cria uma instância de um RolePrincipal objeto para o especificado identity usando as informações especificadas providerName e de função 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 provedor de função para o usuário.

identity: IIdentity

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

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 desse tipo com dados não confiáveis é um risco à segurança. Use esse objeto somente com dados confiáveis. Para obter mais informações, consulte Validar Todas as Entradas.

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

Confira também

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

Aplica-se a

Comentários

Esta página foi útil?

Compartilhar via

RolePrincipal Construtores

Definição

Sobrecargas

RolePrincipal(IIdentity)

Parâmetros

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

RolePrincipal(SerializationInfo, StreamingContext)

Parâmetros

Aplica-se a

RolePrincipal(IIdentity, String)

Parâmetros

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

RolePrincipal(String, IIdentity)

Parâmetros

Exceções

Comentários

Confira também

Aplica-se a

RolePrincipal(String, IIdentity, String)

Parâmetros

Exceções

Comentários

Confira também

Aplica-se a

Comentários