RolePrincipal Konstruktoren

Referenz

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

RolePrincipal(IIdentity)	Instanziiert ein RolePrincipal-Objekt für die angegebene `identity`.
RolePrincipal(SerializationInfo, StreamingContext)	Initialisiert eine neue Instanz der RolePrincipal-Klasse mithilfe der Informationen, die im angegebenen SerializationInfo-Objekt enthalten sind, und des angegebenen Streamingkontexts.
RolePrincipal(IIdentity, String)	Instanziiert ein RolePrincipal-Objekt für die angegebene `identity` mit Rolleninformationen aus dem angegebenen `encryptedTicket`.
RolePrincipal(String, IIdentity)	Instanziiert ein RolePrincipal-Objekt für die angegebene `identity` mit dem angegebenen `providerName`.
RolePrincipal(String, IIdentity, String)	Instanziiert ein RolePrincipal-Objekt für die angegebene `identity` mit dem angegebenen `providerName` und den Rolleninformationen aus dem angegebenen `encryptedTicket`.

RolePrincipal(IIdentity)

Instanziiert ein RolePrincipal-Objekt für die angegebene 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 RolePrincipal erstellt werden soll.

Ausnahmen

ArgumentNullException

identity ist null.

Beispiele

Im folgenden Codebeispiel wird ein neues RolePrincipal -Objekt erstellt. Wenn CacheRolesInCookie ist true, erstellt das Beispiel mit RolePrincipal Cookieinformationen aus dem cookie, das durch die CookieName -Eigenschaft identifiziert wird.

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 dessen Eigenschaftswerte. Zwischengespeicherte Rolleninformationen werden nicht aus dem von der -Eigenschaft identifizierten CookieName Cookie gelesen. Die ProviderName -Eigenschaft ist auf den Name des Standardrollenanbieters festgelegt.

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

Weitere Informationen

Verwalten der Autorisierung mit ASP.NET Rollen

Gilt für:

RolePrincipal(SerializationInfo, StreamingContext)

Initialisiert eine neue Instanz der RolePrincipal-Klasse mithilfe der Informationen, die im angegebenen SerializationInfo-Objekt enthalten sind, und des angegebenen Streamingkontexts.

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 mit Daten aufzufüllende SerializationInfo-Objekt.

context: StreamingContext

Das Ziel dieser Serialisierung.

Gilt für:

RolePrincipal(IIdentity, String)

Instanziiert ein RolePrincipal-Objekt für die angegebene identity 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 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

Wichtig

Das Verwenden einer Instanz dieses Objekts mit nicht vertrauenswürdigen Daten stellt ein Sicherheitsrisiko dar. 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 dessen Eigenschaftswerte. Rolleninformationen für den aktuellen Benutzer werden aus dem angegebenen encryptedTicket gelesen und mit dem RolePrincipal -Objekt zwischengespeichert. Die ProviderName -Eigenschaft ist auf den Name des Standardrollenanbieters festgelegt.

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

Weitere Informationen

Verwalten der Autorisierung mit ASP.NET Rollen

Gilt für:

RolePrincipal(String, IIdentity)

Instanziiert ein RolePrincipal-Objekt für die angegebene identity mit dem angegebenen 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 RolePrincipal erstellt werden soll.

Ausnahmen

ArgumentNullException

identity ist null.

ArgumentException

providerName ist null.

- oder -

providerName verweist 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 dessen 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 mit ASP.NET Rollen

Gilt für:

RolePrincipal(String, IIdentity, String)

Instanziiert ein RolePrincipal-Objekt für die angegebene identity mit dem angegebenen providerName und den 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 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 verweist auf einen Rollenanbieter, der in der Konfiguration für die Anwendung nicht vorhanden ist.

Hinweise

Wichtig

Diese Überladung des RolePrincipal Konstruktors erstellt ein neues RolePrincipal -Objekt und initialisiert dessen Eigenschaftswerte. Rolleninformationen für den aktuellen Benutzer werden aus dem angegebenen encryptedTicket gelesen und mit dem RolePrincipal -Objekt zwischengespeichert. 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 mit ASP.NET Rollen

Gilt für:

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:

Zusätzliche Ressourcen