RolePrincipal Klasse

Definition

Stellt Sicherheitsinformationen für die aktuelle HTTP-Anforderung, einschließlich Rollenmitgliedschaft, dar.Represents security information for the current HTTP request, including role membership. Diese Klasse kann nicht vererbt werden.This class cannot be inherited.

public ref class RolePrincipal : System::Runtime::Serialization::ISerializable, System::Security::Principal::IPrincipal
public ref class RolePrincipal : System::Security::Claims::ClaimsPrincipal, System::Runtime::Serialization::ISerializable
[System.Serializable]
public class RolePrincipal : System.Runtime.Serialization.ISerializable, System.Security.Principal.IPrincipal
[System.Serializable]
public class RolePrincipal : System.Security.Claims.ClaimsPrincipal, System.Runtime.Serialization.ISerializable
[<System.Serializable>]
type RolePrincipal = class
    interface IPrincipal
    interface ISerializable
[<System.Serializable>]
type RolePrincipal = class
    inherit ClaimsPrincipal
    interface ISerializable
Public Class RolePrincipal
Implements IPrincipal, ISerializable
Public Class RolePrincipal
Inherits ClaimsPrincipal
Implements ISerializable
Vererbung
RolePrincipal
Vererbung
RolePrincipal
Attribute
Implementiert

Hinweise

Das RolePrincipal -Objekt implementiert die IPrincipal -Schnittstelle und stellt den aktuellen Sicherheitskontext für die HTTP-Anforderung dar.The RolePrincipal object implements the IPrincipal interface and represents the current security context for the HTTP request.

Wenn die Rollen Verwaltung aktiviert ist (siehe Roles ), weist das der- RoleManagerModule RolePrincipal Eigenschaft des-Objekts ein-Objekt zu User Current HttpContext .When role management is enabled (see Roles), the RoleManagerModule assigns a RolePrincipal object to the User property of the CurrentHttpContext.

Die RolePrincipal -Klasse macht die Sicherheitsidentität für die aktuelle HTTP-Anforderung verfügbar und führt außerdem eine Überprüfung der Rollen Mitgliedschaft durch.The RolePrincipal class exposes the security identity for the current HTTP request and additionally performs checks for role membership. Wenn CacheRolesInCookie true den Wert hat, wird die RolePrincipal zwischengespeicherte Liste der Rollen von dem Objekt verwaltet, und zuerst wird die Rollen Mitgliedschaft für den aktuellen Benutzer in der zwischengespeicherten Liste und dann die Rolle gesucht Provider .If CacheRolesInCookie is true, then the RolePrincipal object manages the cached list of roles and looks up role membership for the current user in the cached list first, then the role Provider. Wenn CacheRolesInCookie false den Wert hat, RolePrincipal sucht das Objekt immer mithilfe des Rollen Anbieters die Rollen Mitgliedschaft.If CacheRolesInCookie is false, the RolePrincipal object always looks up role membership using the role provider.

Das RolePrincipal -Objekt verschlüsselt und entschlüsselt Rollen Informationen, die in dem vom identifizierten Cookie zwischengespeichert werden, CookieName basierend auf dem CookieProtectionValue .The RolePrincipal object encrypts and decrypts role information cached in the cookie identified by the CookieName based on the CookieProtectionValue.

Konstruktoren

RolePrincipal(IIdentity)

Instanziiert ein RolePrincipal-Objekt für die angegebene identity.Instantiates a RolePrincipal object for the specified identity.

RolePrincipal(IIdentity, String)

Instanziiert ein RolePrincipal-Objekt für die angegebene identity mit Rolleninformationen aus dem angegebenen encryptedTicket.Instantiates a RolePrincipal object for the specified identity with role information from the specified 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.Initializes a new instance of the RolePrincipal class using information that is contained in the specified SerializationInfo object and using the specified streaming context.

RolePrincipal(String, IIdentity)

Instanziiert ein RolePrincipal-Objekt für die angegebene identity mit dem angegebenen providerName.Instantiates a RolePrincipal object for the specified identity using the specified 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.Instantiates a RolePrincipal object for the specified identity using the specified providerName and role information from the specified encryptedTicket.

Eigenschaften

CachedListChanged

Ruft einen Wert ab, der angibt, ob die im RolePrincipal-Objekt zwischengespeicherte Liste von Rollennamen geändert wurde.Gets a value indicating whether the list of role names cached with the RolePrincipal object has been modified.

Claims

Ruft eine Auflistung mit allen Ansprüchen aller Anspruchsidentitäten ab, die diesem Anspruchsprinzipal zugeordnet sind.Gets a collection that contains all of the claims from all of the claims identities associated with this claims principal.

(Geerbt von ClaimsPrincipal)
CookiePath

Ruft den Pfad für das Cookie mit den zwischengespeicherten Rollennamen ab.Gets the path for the cached role names cookie.

CustomSerializationData

Enthält alle zusätzlichen Daten, die von einem abgeleiteten Typ bereitgestellt werden.Contains any additional data provided by a derived type. Wird in der Regel beim Aufrufen von WriteTo(BinaryWriter, Byte[]) festgelegt.Typically set when calling WriteTo(BinaryWriter, Byte[]).

(Geerbt von ClaimsPrincipal)
Expired

Ruft einen Wert ab, der angibt, ob die Gültigkeit des Rollencookies abgelaufen ist.Gets a value indicating whether the roles cookie has expired.

ExpireDate

Ruft Datum und Uhrzeit für den Ablauf der Gültigkeit des Rollencookies ab.Gets the date and time when the roles cookie will expire.

Identities

Ruft eine Auflistung mit allen Anspruchsidentitäten ab, die diesem Anspruchsprinzipal zugeordnet sind.Gets a collection that contains all of the claims identities associated with this claims principal.

(Geerbt von ClaimsPrincipal)
Identity

Ruft die Sicherheitsidentität für die aktuelle HTTP-Anforderung ab.Gets the security identity for the current HTTP request.

IsRoleListCached

Ruft einen Wert ab, der angibt, ob die Liste der Rollen für den Benutzer in einem Cookie zwischengespeichert wird.Gets a value indicating whether the list of roles for the user has been cached in a cookie.

IssueDate

Ruft Datum und Uhrzeit der Ausgabe des Rollencookies ab.Gets the date and time that the roles cookie was issued.

ProviderName

Ruft den Namen des Rollenanbieters ab, der Rolleninformationen für den Benutzer speichert und abruft.Gets the name of the role provider that stores and retrieves role information for the user.

Version

Ruft die Versionsnummer des Rollencookies ab.Gets the version number of the roles cookie.

Methoden

AddIdentities(IEnumerable<ClaimsIdentity>)

Fügt die angegebenen Anspruchsidentitäten diesem Anspruchsprinzipal hinzu.Adds the specified claims identities to this claims principal.

(Geerbt von ClaimsPrincipal)
AddIdentity(ClaimsIdentity)

Fügt die angegebene Anspruchsidentität diesem Anspruchsprinzipal hinzu.Adds the specified claims identity to this claims principal.

(Geerbt von ClaimsPrincipal)
Clone()

Gibt eine Kopie dieser Instanz zurück.Returns a copy of this instance.

(Geerbt von ClaimsPrincipal)
CreateClaimsIdentity(BinaryReader)

Erstellt eine neue Anspruchsidentität.Creates a new claims identity.

(Geerbt von ClaimsPrincipal)
Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.Determines whether the specified object is equal to the current object.

(Geerbt von Object)
FindAll(Predicate<Claim>)

Ruft alle Ansprüche ab, die dem angegebenen Prädikat entsprechen.Retrieves all of the claims that are matched by the specified predicate.

(Geerbt von ClaimsPrincipal)
FindAll(String)

Ruft alle Ansprüche ab oder diejenigen, die den angegebenen Anspruchstyp aufweisen.Retrieves all or the claims that have the specified claim type.

(Geerbt von ClaimsPrincipal)
FindFirst(Predicate<Claim>)

Ruft den ersten Anspruch ab, der dem angegebenen Prädikat entspricht.Retrieves the first claim that is matched by the specified predicate.

(Geerbt von ClaimsPrincipal)
FindFirst(String)

Ruft den ersten Anspruch mit dem angegebenen Anspruchstyp ab.Retrieves the first claim with the specified claim type.

(Geerbt von ClaimsPrincipal)
GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(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.Populates a SerializationInfo object with the data that is required in order to serialize the target object using the specified streaming context.

GetRoles()

Ruft eine Liste der Rollen ab, denen RolePrincipal als Member angehört.Gets a list of roles that the RolePrincipal is a member of.

GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(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.Determines whether any of the claims identities associated with this claims principal contains a claim that is matched by the specified predicate.

(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.Determines whether any of the claims identities associated with this claims principal contains a claim with the specified claim type and value.

(Geerbt von ClaimsPrincipal)
IsInRole(String)

Ruft einen Wert ab, der angibt, ob der durch RolePrincipal dargestellte Benutzer die angegebene Rolle innehat.Gets a value indicating whether the user represented by the RolePrincipal is in the specified role.

MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
SetDirty()

Kennzeichnet die zwischengespeicherte Rollenliste als geändert.Marks the cached role list as having been changed.

ToEncryptedTicket()

Gibt die im RolePrincipal-Objekt zwischengespeicherten Rolleninformationen zurück, die auf der Grundlage von CookieProtectionValue verschlüsselt wurden.Returns the role information cached with the RolePrincipal object encrypted based on the CookieProtectionValue.

ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Geerbt von Object)
WriteTo(BinaryWriter)

Serialisiert mithilfe von BinaryWriter.Serializes using a BinaryWriter.

(Geerbt von ClaimsPrincipal)
WriteTo(BinaryWriter, Byte[])

Serialisiert mithilfe von BinaryWriter.Serializes using a BinaryWriter.

(Geerbt von ClaimsPrincipal)

Explizite Schnittstellenimplementierungen

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Eine Beschreibung dieses Elements finden Sie unter GetObjectData(Object, SerializationInfo, StreamingContext).For a description of this member, see GetObjectData(Object, SerializationInfo, StreamingContext).

Gilt für: