RolePrincipal Konstruktoren

Definition

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

identity ist null.

Beispiele

Im folgenden Codebeispiel wird ein neues RolePrincipal Objekt erstellt. Wenn CacheRolesInCookie ist true, erstellt das Beispiel die RolePrincipal mit 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 seine 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

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

identity ist null.

- oder -

encryptedTicket ist null.

Beispiele

Im folgenden Codebeispiel wird ein neues RolePrincipal Objekt erstellt. Wenn CacheRolesInCookie ist true, erstellt das Beispiel die RolePrincipal mit 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

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 seine 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

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

identity ist null.

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 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

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

identity ist null.

- oder -

encryptedTicket ist null.

providerName ist null.

- oder -

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

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 seine 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

Gilt für: