RolePrincipal Konstruktoren

Definition

Namespace:: System.Web.Security

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Erstellt eine neue Instanz der RolePrincipal Klasse.

Überlädt

Name	Beschreibung
RolePrincipal(IIdentity)	Instanziiert ein RolePrincipal Objekt für den angegebenen `identity`.
RolePrincipal(SerializationInfo, StreamingContext)	Initialisiert eine neue Instanz der RolePrincipal Klasse mithilfe von Informationen, die im angegebenen SerializationInfo Objekt enthalten sind, und verwendet den angegebenen Streamingkontext.
RolePrincipal(IIdentity, String)	Instanziiert ein RolePrincipal Objekt für das angegebene `identity` Objekt mit Rolleninformationen aus dem angegebenen `encryptedTicket`.
RolePrincipal(String, IIdentity)	Instanziiert ein RolePrincipal Objekt für den angegebenen `identity` Wert.`providerName`
RolePrincipal(String, IIdentity, String)	Instanziiert ein RolePrincipal Objekt für das angegebene Objekt mithilfe der angegebenen `identityproviderName` und Rolleninformationen aus dem angegebenen `encryptedTicket`.

RolePrincipal(IIdentity)

Instanziiert ein RolePrincipal Objekt für den angegebenen 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)

Parameter

identity: IIdentity

Die Benutzeridentität, für die sie RolePrincipal erstellt werden soll.

Ausnahmen

ArgumentNullException

identity ist null.

Beispiele

Im folgenden Codebeispiel wird ein neues RolePrincipal Objekt erstellt. Wenn CacheRolesInCookie ja true, erstellt das Beispiel die RolePrincipal mit Cookie-Informationen aus dem durch die CookieName Eigenschaft identifizierten Cookie.

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

Hinweise

Diese Überladung des RolePrincipal Konstruktors erstellt ein neues RolePrincipal Objekt und initialisiert seine Eigenschaftswerte. Zwischengespeicherte Rolleninformationen werden nicht aus dem von der CookieName Eigenschaft identifizierten Cookie gelesen. Die ProviderName Eigenschaft wird auf den Name Standardrollenanbieter festgelegt.

Informationen zum Aktivieren der Rollenverwaltung finden Sie in der Roles Klasse.

Weitere Informationen

Verwalten der Autorisierung mithilfe von ASP.NET Rollen

Gilt für:

RolePrincipal(SerializationInfo, StreamingContext)

Initialisiert eine neue Instanz der RolePrincipal Klasse mithilfe von Informationen, die im angegebenen SerializationInfo Objekt enthalten sind, und verwendet den angegebenen Streamingkontext.

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)

Parameter

info: SerializationInfo

Das SerializationInfo Objekt, das mit Daten aufgefüllt werden soll.

context: StreamingContext

Das Ziel für diese Serialisierung.

Gilt für:

RolePrincipal(IIdentity, String)

Instanziiert ein RolePrincipal Objekt für das angegebene identity Objekt mit Rolleninformationen aus dem angegebenen 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)

Parameter

identity: IIdentity

Die Benutzeridentität, für die sie RolePrincipal erstellt werden soll.

encryptedTicket: String

Eine Zeichenfolge, die verschlüsselte Rolleninformationen enthält.

Ausnahmen

ArgumentNullException

identity ist null.

- oder -

encryptedTicket ist null.

Beispiele

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

Hinweise

Von Bedeutung

Die Verwendung einer Instanz dieses Typs mit nicht vertrauenswürdigen Daten ist ein Sicherheitsrisiko. Verwenden Sie dieses Objekt nur mit vertrauenswürdigen Daten. Weitere Informationen finden Sie unter Überprüfen aller Eingaben.

Diese Überladung des RolePrincipal Konstruktors erstellt ein neues RolePrincipal Objekt und initialisiert seine Eigenschaftswerte. Rolleninformationen für den aktuellen Benutzer werden aus dem bereitgestellten encryptedTicket und zwischengespeicherten RolePrincipal Objekt gelesen. Die ProviderName Eigenschaft wird auf den Name Standardrollenanbieter festgelegt.

Informationen zum Aktivieren der Rollenverwaltung finden Sie in der Roles Klasse.

Weitere Informationen

Verwalten der Autorisierung mithilfe von ASP.NET Rollen

Gilt für:

RolePrincipal(String, IIdentity)

Instanziiert ein RolePrincipal Objekt für den angegebenen identity Wert.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)

Parameter

providerName: String

Der Name des Rollenanbieters für den Benutzer.

identity: IIdentity

Die Benutzeridentität, für die sie RolePrincipal erstellt werden soll.

Ausnahmen

ArgumentNullException

identity ist null.

ArgumentException

providerName ist null.

- oder -

providerName bezieht sich auf einen Rollenanbieter, der in der Konfiguration für die Anwendung nicht vorhanden ist.

Hinweise

Diese Überladung des RolePrincipal Konstruktors erstellt ein neues RolePrincipal Objekt und initialisiert seine Eigenschaftswerte. Die ProviderName Eigenschaft wird auf den im providerName Parameter angegebenen Wert festgelegt.

Informationen zum Aktivieren der Rollenverwaltung finden Sie in der Roles Klasse.

Weitere Informationen

Verwalten der Autorisierung mithilfe von ASP.NET Rollen

Gilt für:

RolePrincipal(String, IIdentity, String)

Instanziiert ein RolePrincipal Objekt für das angegebene Objekt mithilfe der angegebenen identityproviderName und Rolleninformationen aus dem angegebenen 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)

Parameter

providerName: String

Der Name des Rollenanbieters für den Benutzer.

identity: IIdentity

Die Benutzeridentität, für die sie RolePrincipal erstellt werden soll.

encryptedTicket: String

Eine Zeichenfolge, die verschlüsselte Rolleninformationen enthält.

Ausnahmen

ArgumentNullException

identity ist null.

- oder -

encryptedTicket ist null.

ArgumentException

providerName ist null.

- oder -

providerName bezieht sich auf einen Rollenanbieter, der in der Konfiguration für die Anwendung nicht vorhanden ist.

Hinweise

Von Bedeutung

Informationen zum Aktivieren der Rollenverwaltung finden Sie in der Roles Klasse.

Weitere Informationen

Verwalten der Autorisierung mithilfe von ASP.NET Rollen

Gilt für:

Feedback

War diese Seite hilfreich?

Freigeben über

RolePrincipal Konstruktoren

Definition

Überlädt

RolePrincipal(IIdentity)

Parameter

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

RolePrincipal(SerializationInfo, StreamingContext)

Parameter

Gilt für:

RolePrincipal(IIdentity, String)

Parameter

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

RolePrincipal(String, IIdentity)

Parameter

Ausnahmen

Hinweise

Weitere Informationen

Gilt für:

RolePrincipal(String, IIdentity, String)

Parameter

Ausnahmen

Hinweise

Weitere Informationen

Gilt für:

Feedback