RolePrincipal Konstruktory

Definice

Vytvoří novou instanci třídy RolePrincipal.

Přetížení

RolePrincipal(IIdentity)

Vytvoří instanci objektu RolePrincipal pro zadaný identityobjekt .

RolePrincipal(SerializationInfo, StreamingContext)

Inicializuje novou instanci RolePrincipal třídy pomocí informací obsažených v zadaném SerializationInfo objektu a pomocí zadaného kontextu streamování.

RolePrincipal(IIdentity, String)

Vytvoří instanci objektu RolePrincipal pro zadaný identity objekt s informacemi o roli ze zadaného encryptedTicketobjektu .

RolePrincipal(String, IIdentity)

Vytvoří instanci objektu RolePrincipal pro zadaný identity objekt pomocí zadaného providerNameobjektu .

RolePrincipal(String, IIdentity, String)

Vytvoří instanci objektu RolePrincipal pro zadaný identity objekt pomocí zadaných providerName informací a informací o roli ze zadaného encryptedTicketobjektu .

RolePrincipal(IIdentity)

Vytvoří instanci objektu RolePrincipal pro zadaný identityobjekt .

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

Identita uživatele, která se má vytvořit pro RolePrincipal .

Výjimky

identity je null.

Příklady

Následující příklad kódu vytvoří nový RolePrincipal objekt. Pokud CacheRolesInCookie je true, příklad vytvoří RolePrincipal soubor s informacemi o souboru cookie z souboru cookie identifikovaného CookieName vlastností.

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

Poznámky

Toto přetížení konstruktoru RolePrincipal vytvoří nový RolePrincipal objekt a inicializuje jeho hodnoty vlastností. Informace o roli v mezipaměti se nečtou z souboru cookie identifikovaného CookieName vlastností. Vlastnost ProviderName je nastavena na Name výchozího zprostředkovatele role.

Informace o povolení správy rolí najdete ve Roles třídě .

Viz také

Platí pro

RolePrincipal(SerializationInfo, StreamingContext)

Inicializuje novou instanci RolePrincipal třídy pomocí informací obsažených v zadaném SerializationInfo objektu a pomocí zadaného kontextu streamování.

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

Objekt SerializationInfo, který bude vyplněn daty.

context
StreamingContext

Cílové umístění serializace.

Platí pro

RolePrincipal(IIdentity, String)

Vytvoří instanci objektu RolePrincipal pro zadaný identity objekt s informacemi o roli ze zadaného encryptedTicketobjektu .

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

Identita uživatele, která se má vytvořit pro RolePrincipal .

encryptedTicket
String

Řetězec, který obsahuje šifrované informace o rolích.

Výjimky

identity je null.

-nebo-

encryptedTicket je null.

Příklady

Následující příklad kódu vytvoří nový RolePrincipal objekt. Pokud CacheRolesInCookie je true, příklad vytvoří RolePrincipal soubor s informacemi o souboru cookie z souboru cookie identifikovaného CookieName vlastností.

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

Poznámky

Důležité

Použití instance tohoto objektu s nedůvěryhodnými daty představuje bezpečnostní riziko. Tento objekt používejte pouze s důvěryhodnými daty. Další informace najdete v tématu Ověření všech vstupů.

Toto přetížení konstruktoru RolePrincipal vytvoří nový RolePrincipal objekt a inicializuje jeho hodnoty vlastností. Informace o rolích pro aktuálního uživatele se načítají ze zadaného encryptedTicket objektu a ukládají se do mezipaměti s objektem RolePrincipal . Vlastnost ProviderName je nastavena na Name výchozího zprostředkovatele role.

Informace o povolení správy rolí najdete ve Roles třídě .

Viz také

Platí pro

RolePrincipal(String, IIdentity)

Vytvoří instanci objektu RolePrincipal pro zadaný identity objekt pomocí zadaného providerNameobjektu .

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

Název zprostředkovatele role pro uživatele.

identity
IIdentity

Identita uživatele, která se má vytvořit pro RolePrincipal .

Výjimky

identity je null.

providerName je null.

-nebo-

providerName odkazuje na zprostředkovatele role, který neexistuje v konfiguraci aplikace.

Poznámky

Toto přetížení konstruktoru RolePrincipal vytvoří nový RolePrincipal objekt a inicializuje jeho hodnoty vlastností. Vlastnost ProviderName je nastavena na hodnotu zadanou v parametru providerName .

Informace o povolení správy rolí najdete ve Roles třídě .

Viz také

Platí pro

RolePrincipal(String, IIdentity, String)

Vytvoří instanci objektu RolePrincipal pro zadaný identity objekt pomocí zadaných providerName informací a informací o roli ze zadaného encryptedTicketobjektu .

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

Název zprostředkovatele role pro uživatele.

identity
IIdentity

Identita uživatele, která se má vytvořit pro RolePrincipal .

encryptedTicket
String

Řetězec, který obsahuje šifrované informace o rolích.

Výjimky

identity je null.

-nebo-

encryptedTicket je null.

providerName je null.

-nebo-

providerName odkazuje na zprostředkovatele role, který neexistuje v konfiguraci aplikace.

Poznámky

Důležité

Použití instance tohoto objektu s nedůvěryhodnými daty představuje bezpečnostní riziko. Tento objekt používejte pouze s důvěryhodnými daty. Další informace najdete v tématu Ověření všech vstupů.

Toto přetížení konstruktoru RolePrincipal vytvoří nový RolePrincipal objekt a inicializuje jeho hodnoty vlastností. Informace o rolích pro aktuálního uživatele se načítají ze zadaného encryptedTicket objektu a ukládají se do mezipaměti s objektem RolePrincipal . Vlastnost ProviderName je nastavena na hodnotu zadanou v parametru providerName .

Informace o povolení správy rolí najdete ve Roles třídě .

Viz také

Platí pro