RolePrincipal Klasse

Definition

Namespace:

System.Web.Security

Assembly:

System.Web.dll

Stellt Sicherheitsinformationen für die aktuelle HTTP-Anforderung, einschließlich Rollenmitgliedschaft, dar. Diese Klasse kann nicht vererbt werden.

public ref class RolePrincipal : System::Security::Claims::ClaimsPrincipal, System::Runtime::Serialization::ISerializable

[System.Serializable]
public class RolePrincipal : System.Security.Claims.ClaimsPrincipal, System.Runtime.Serialization.ISerializable

[<System.Serializable>]
type RolePrincipal = class
    inherit ClaimsPrincipal
    interface ISerializable

Public Class RolePrincipal
Inherits ClaimsPrincipal
Implements ISerializable

Vererbung

Object

ClaimsPrincipal

RolePrincipal

Attribute

SerializableAttribute

Implementiert

ISerializable

Hinweise

Das RolePrincipal -Objekt implementiert die IPrincipal -Schnittstelle und stellt den aktuellen Sicherheitskontext für die HTTP-Anforderung dar.

Wenn die Rollenverwaltung aktiviert ist (siehe Roles), weist der RoleManagerModule -Eigenschaft von UserCurrentHttpContextein RolePrincipal -Objekt zu.

Die RolePrincipal -Klasse macht die Sicherheitsidentität für die aktuelle HTTP-Anforderung verfügbar und führt zusätzlich Überprüfungen auf Rollenmitgliedschaft durch. Wenn CacheRolesInCookie ist, verwaltet das RolePrincipal -Objekt zuerst die zwischengespeicherte Liste der Rollen und sucht die Rollenmitgliedschaft für den aktuellen Benutzer in der zwischengespeicherten Liste, dann die Rolle Provider.true Wenn CacheRolesInCookie ist false, sucht das RolePrincipal Objekt immer mithilfe des Rollenanbieters nach der Rollenmitgliedschaft.

Das RolePrincipal -Objekt verschlüsselt und entschlüsselt Rolleninformationen, die in dem Cookie zwischengespeichert werden, das CookieName von anhand von CookieProtectionValueidentifiziert wird.

Konstruktoren

RolePrincipal(IIdentity)	Instanziiert ein RolePrincipal-Objekt für die angegebene identity.
RolePrincipal(IIdentity, String)	Instanziiert ein RolePrincipal-Objekt für die angegebene identity mit Rolleninformationen aus dem angegebenen encryptedTicket.
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(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.

Eigenschaften

CachedListChanged	Ruft einen Wert ab, der angibt, ob die im RolePrincipal-Objekt zwischengespeicherte Liste von Rollennamen geändert wurde.
Claims	Ruft eine Auflistung mit allen Ansprüchen aller Anspruchsidentitäten ab, die diesem Anspruchsprinzipal zugeordnet sind. (Geerbt von ClaimsPrincipal)
CookiePath	Ruft den Pfad für das Cookie mit den zwischengespeicherten Rollennamen ab.
CustomSerializationData	Enthält alle zusätzlichen Daten, die von einem abgeleiteten Typ bereitgestellt werden. Wird in der Regel beim Aufrufen von WriteTo(BinaryWriter, Byte[]) festgelegt. (Geerbt von ClaimsPrincipal)
Expired	Ruft einen Wert ab, der angibt, ob die Gültigkeit des Rollencookies abgelaufen ist.
ExpireDate	Ruft Datum und Uhrzeit für den Ablauf der Gültigkeit des Rollencookies ab.
Identities	Ruft eine Auflistung mit allen Anspruchsidentitäten ab, die diesem Anspruchsprinzipal zugeordnet sind. (Geerbt von ClaimsPrincipal)
Identity	Ruft die Sicherheitsidentität für die aktuelle HTTP-Anforderung ab.
IsRoleListCached	Ruft einen Wert ab, der angibt, ob die Liste der Rollen für den Benutzer in einem Cookie zwischengespeichert wird.
IssueDate	Ruft Datum und Uhrzeit der Ausgabe des Rollencookies ab.
ProviderName	Ruft den Namen des Rollenanbieters ab, der Rolleninformationen für den Benutzer speichert und abruft.
Version	Ruft die Versionsnummer des Rollencookies ab.

Methoden

AddIdentities(IEnumerable<ClaimsIdentity>)	Fügt die angegebenen Anspruchsidentitäten diesem Anspruchsprinzipal hinzu. (Geerbt von ClaimsPrincipal)
AddIdentity(ClaimsIdentity)	Fügt die angegebene Anspruchsidentität diesem Anspruchsprinzipal hinzu. (Geerbt von ClaimsPrincipal)
Clone()	Gibt eine Kopie dieser Instanz zurück. (Geerbt von ClaimsPrincipal)
CreateClaimsIdentity(BinaryReader)	Erstellt eine neue Anspruchsidentität. (Geerbt von ClaimsPrincipal)
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
FindAll(Predicate<Claim>)	Ruft alle Ansprüche ab, die dem angegebenen Prädikat entsprechen. (Geerbt von ClaimsPrincipal)
FindAll(String)	Ruft alle Ansprüche ab oder diejenigen, die den angegebenen Anspruchstyp aufweisen. (Geerbt von ClaimsPrincipal)
FindFirst(Predicate<Claim>)	Ruft den ersten Anspruch ab, der dem angegebenen Prädikat entspricht. (Geerbt von ClaimsPrincipal)
FindFirst(String)	Ruft den ersten Anspruch mit dem angegebenen Anspruchstyp ab. (Geerbt von ClaimsPrincipal)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetObjectData(SerializationInfo, StreamingContext)	Füllt ein SerializationInfo-Objekt mit den Daten aus, die zur Serialisierung des Zielobjekts mithilfe des angegebenen Streamingkontexts erforderlich sind.
GetRoles()	Ruft eine Liste der Rollen ab, denen RolePrincipal als Member angehört.
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
HasClaim(Predicate<Claim>)	Ermittelt, ob eine der Anspruchsidentitäten, die diesem Anspruchsprinzipal zugeordnet sind, einen Anspruch enthält, der mit dem angegebenen Prädikat verglichen wird. (Geerbt von ClaimsPrincipal)
HasClaim(String, String)	Ermittelt, ob eine der Anspruchsidentitäten, die diesem Anspruchsprinzipal zugeordnet sind, einen Anspruch mit dem angegebenen Anspruchstyp und -wert enthält. (Geerbt von ClaimsPrincipal)
IsInRole(String)	Ruft einen Wert ab, der angibt, ob der durch RolePrincipal dargestellte Benutzer die angegebene Rolle innehat.
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
SetDirty()	Kennzeichnet die zwischengespeicherte Rollenliste als geändert.
ToEncryptedTicket()	Gibt die im RolePrincipal-Objekt zwischengespeicherten Rolleninformationen zurück, die auf der Grundlage von CookieProtectionValue verschlüsselt wurden.
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)
WriteTo(BinaryWriter)	Serialisiert mithilfe von BinaryWriter. (Geerbt von ClaimsPrincipal)
WriteTo(BinaryWriter, Byte[])	Serialisiert mithilfe von BinaryWriter. (Geerbt von ClaimsPrincipal)

Explizite Schnittstellenimplementierungen

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Eine Beschreibung dieses Elements finden Sie unter GetObjectData(Object, SerializationInfo, StreamingContext).

Weitere Informationen

• Verwalten der Autorisierung mit ASP.NET Rollen