RolePrincipal Konstruktory

  • Reference

Definice

Obor názvů:
System.Web.Security
Sestavení:
System.Web.dll

Vytvoří novou instanci třídy RolePrincipal.

Přetížení

RolePrincipal(IIdentity)

Vytvoří instanci objektu RolePrincipal pro zadaný identityobjekt .
RolePrincipal(SerializationInfo, StreamingContext)

Inicializuje novou instanci třídy pomocí informací obsažených RolePrincipal 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 s použitím informací o zadané providerName roli a 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

ArgumentNullException

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 rolích uložených v mezipaměti se nečtou ze souboru cookie identifikovaného CookieName vlastností . Vlastnost ProviderName je nastavena na Name hodnotu výchozího zprostředkovatele role.

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

Viz také

Platí pro

RolePrincipal(SerializationInfo, StreamingContext)

Inicializuje novou instanci třídy pomocí informací obsažených RolePrincipal 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

ArgumentNullException

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 roli pro aktuálního uživatele se čtou ze zadaného encryptedTicket objektu a ukládají se do mezipaměti s objektem RolePrincipal . Vlastnost ProviderName je nastavena na Name hodnotu výchozího zprostředkovatele role.

Informace o povolení správy rolí najdete v 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 poskytovatele role pro uživatele.

identity
IIdentity

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

Výjimky

ArgumentNullException

identity je null.

ArgumentException

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 nastavená na hodnotu zadanou v parametru providerName .

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

Viz také

Platí pro

RolePrincipal(String, IIdentity, String)

Vytvoří instanci objektu RolePrincipal pro zadaný identity objekt s použitím informací o zadané providerName roli a 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 poskytovatele 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

ArgumentNullException

identity je null.

-nebo-

encryptedTicket je null.

ArgumentException

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 roli pro aktuálního uživatele se čtou ze zadaného encryptedTicket objektu a ukládají se do mezipaměti s objektem RolePrincipal . Vlastnost ProviderName je nastavená na hodnotu zadanou v parametru providerName .

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

Viz také

Platí pro