RolePrincipal Konstruktory

Definicja

Przestrzeń nazw:: System.Web.Security

Zestaw:: System.Web.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Tworzy nowe wystąpienie RolePrincipal klasy.

Przeciążenia

Nazwa	Opis
RolePrincipal(IIdentity)	Tworzy wystąpienie RolePrincipal obiektu dla określonego `identity`obiektu .
RolePrincipal(SerializationInfo, StreamingContext)	Inicjuje nowe wystąpienie RolePrincipal klasy przy użyciu informacji zawartych w określonym SerializationInfo obiekcie i przy użyciu określonego kontekstu przesyłania strumieniowego.
RolePrincipal(IIdentity, String)	Tworzy wystąpienie RolePrincipal obiektu dla określonego `identity` obiektu z informacjami o roli z określonego `encryptedTicket`obiektu .
RolePrincipal(String, IIdentity)	Tworzy wystąpienie RolePrincipal obiektu dla określonego `identity` obiektu przy użyciu określonego `providerName`obiektu .
RolePrincipal(String, IIdentity, String)	Tworzy wystąpienie RolePrincipal obiektu dla określonego `identity` obiektu przy użyciu określonych informacji o określonej `providerName` roli i z określonego `encryptedTicket`elementu .

RolePrincipal(IIdentity)

Tworzy wystąpienie RolePrincipal obiektu dla określonego identityobiektu .

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)

Parametry

identity: IIdentity

Tożsamość użytkownika do utworzenia RolePrincipal elementu for.

Wyjątki

ArgumentNullException

Parametr identity ma wartość null.

Przykłady

Poniższy przykład kodu tworzy nowy RolePrincipal obiekt. Jeśli CacheRolesInCookie parametr to true, przykład tworzy RolePrincipal element z informacjami o plikach cookie z pliku cookie zidentyfikowanego CookieName przez właściwość .

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

Uwagi

To przeciążenie konstruktora RolePrincipal tworzy nowy RolePrincipal obiekt i inicjuje jego wartości właściwości. Buforowane informacje o roli nie są odczytywane z pliku cookie zidentyfikowanego CookieName przez właściwość . Właściwość ProviderName jest ustawiona na Name domyślnego dostawcę roli.

Aby uzyskać informacje na temat włączania zarządzania rolami, zobacz klasę Roles .

Zobacz też

Zarządzanie autoryzacją przy użyciu ról ASP.NET

Dotyczy

RolePrincipal(SerializationInfo, StreamingContext)

Inicjuje nowe wystąpienie RolePrincipal klasy przy użyciu informacji zawartych w określonym SerializationInfo obiekcie i przy użyciu określonego kontekstu przesyłania strumieniowego.

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)

Parametry

info: SerializationInfo

Obiekt SerializationInfo do wypełnienia danymi.

context: StreamingContext

Miejsce docelowe tej serializacji.

Dotyczy

RolePrincipal(IIdentity, String)

Tworzy wystąpienie RolePrincipal obiektu dla określonego identity obiektu z informacjami o roli z określonego encryptedTicketobiektu .

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)

Parametry

identity: IIdentity

Tożsamość użytkownika do utworzenia RolePrincipal elementu for.

encryptedTicket: String

Ciąg zawierający zaszyfrowane informacje o roli.

Wyjątki

ArgumentNullException

Parametr identity ma wartość null.

— lub —

Parametr encryptedTicket ma wartość null.

Przykłady

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

Uwagi

Ważna

Użycie wystąpienia tego typu z niezaufanymi danymi jest zagrożeniem bezpieczeństwa. Użyj tego obiektu tylko z zaufanymi danymi. Aby uzyskać więcej informacji, zobacz Validate All Inputs.

To przeciążenie konstruktora RolePrincipal tworzy nowy RolePrincipal obiekt i inicjuje jego wartości właściwości. Informacje o roli bieżącego użytkownika są odczytywane z dostarczonego encryptedTicket i buforowanego obiektu RolePrincipal . Właściwość ProviderName jest ustawiona na Name domyślnego dostawcę roli.

Aby uzyskać informacje na temat włączania zarządzania rolami, zobacz klasę Roles .

Zobacz też

Zarządzanie autoryzacją przy użyciu ról ASP.NET

Dotyczy

RolePrincipal(String, IIdentity)

Tworzy wystąpienie RolePrincipal obiektu dla określonego identity obiektu przy użyciu określonego providerNameobiektu .

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)

Parametry

providerName: String

Nazwa dostawcy roli dla użytkownika.

identity: IIdentity

Tożsamość użytkownika do utworzenia RolePrincipal elementu for.

Wyjątki

ArgumentNullException

Parametr identity ma wartość null.

ArgumentException

Parametr providerName ma wartość null.

— lub —

providerName odwołuje się do dostawcy roli, który nie istnieje w konfiguracji aplikacji.

Uwagi

To przeciążenie konstruktora RolePrincipal tworzy nowy RolePrincipal obiekt i inicjuje jego wartości właściwości. Właściwość jest ustawiona ProviderName na wartość określoną w parametrze providerName .

Aby uzyskać informacje na temat włączania zarządzania rolami, zobacz klasę Roles .

Zobacz też

Zarządzanie autoryzacją przy użyciu ról ASP.NET

Dotyczy

RolePrincipal(String, IIdentity, String)

Tworzy wystąpienie RolePrincipal obiektu dla określonego identity obiektu przy użyciu określonych informacji o określonej providerName roli i z określonego encryptedTicketelementu .

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)

Parametry

providerName: String

Nazwa dostawcy roli dla użytkownika.

identity: IIdentity

Tożsamość użytkownika do utworzenia RolePrincipal elementu for.

encryptedTicket: String

Ciąg zawierający zaszyfrowane informacje o roli.

Wyjątki

ArgumentNullException

Parametr identity ma wartość null.

— lub —

Parametr encryptedTicket ma wartość null.

ArgumentException

Parametr providerName ma wartość null.

— lub —

providerName odwołuje się do dostawcy roli, który nie istnieje w konfiguracji aplikacji.

Uwagi

Ważna

Użycie wystąpienia tego typu z niezaufanymi danymi jest zagrożeniem bezpieczeństwa. Użyj tego obiektu tylko z zaufanymi danymi. Aby uzyskać więcej informacji, zobacz Validate All Inputs.

To przeciążenie konstruktora RolePrincipal tworzy nowy RolePrincipal obiekt i inicjuje jego wartości właściwości. Informacje o roli bieżącego użytkownika są odczytywane z dostarczonego encryptedTicket i buforowanego obiektu RolePrincipal . Właściwość jest ustawiona ProviderName na wartość określoną w parametrze providerName .

Aby uzyskać informacje na temat włączania zarządzania rolami, zobacz klasę Roles .

Zobacz też

Zarządzanie autoryzacją przy użyciu ról ASP.NET

Dotyczy

Opinia

Czy ta strona była pomocna?