RolePrincipal Class

Definition

Rappresenta le informazioni sulla sicurezza per la richiesta HTTP corrente, inclusa l'appartenenza ai ruoli.Represents security information for the current HTTP request, including role membership. La classe non può essere ereditata.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
type RolePrincipal = class
    interface IPrincipal
    interface ISerializable
type RolePrincipal = class
    inherit ClaimsPrincipal
    interface ISerializable
Public Class RolePrincipal
Implements IPrincipal, ISerializable
Public Class RolePrincipal
Inherits ClaimsPrincipal
Implements ISerializable
Inheritance
RolePrincipal
Inheritance
RolePrincipal
Attributes
Implements

Remarks

L'oggetto RolePrincipal implementa l'interfaccia IPrincipal e rappresenta il contesto di sicurezza corrente per la richiesta HTTP.The RolePrincipal object implements the IPrincipal interface and represents the current security context for the HTTP request.

Quando la gestione dei ruoli è abilitata (vedere Roles), il RoleManagerModule assegna un oggetto RolePrincipal alla proprietà User del CurrentHttpContext.When role management is enabled (see Roles), the RoleManagerModule assigns a RolePrincipal object to the User property of the CurrentHttpContext.

La classe RolePrincipal espone l'identità di sicurezza per la richiesta HTTP corrente ed esegue inoltre controlli per l'appartenenza al ruolo.The RolePrincipal class exposes the security identity for the current HTTP request and additionally performs checks for role membership. Se CacheRolesInCookie è true, l'oggetto RolePrincipal gestisce l'elenco memorizzato nella cache dei ruoli e cerca l'appartenenza ai ruoli per l'utente corrente nell'elenco memorizzato nella cache, quindi il ruolo 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. Se CacheRolesInCookie è false, l'oggetto RolePrincipal cerca sempre l'appartenenza al ruolo utilizzando il provider di ruoli.If CacheRolesInCookie is false, the RolePrincipal object always looks up role membership using the role provider.

L'oggetto RolePrincipal crittografa e decrittografa le informazioni sui ruoli memorizzate nella cache nel cookie identificato dall'CookieName in base al CookieProtectionValue.The RolePrincipal object encrypts and decrypts role information cached in the cookie identified by the CookieName based on the CookieProtectionValue.

Constructors

RolePrincipal(IIdentity)

Crea un'istanza di un oggetto RolePrincipal per il parametro identity specificato.Instantiates a RolePrincipal object for the specified identity.

RolePrincipal(IIdentity, String)

Crea un'istanza di un oggetto RolePrincipal per il parametro identity specificato con informazioni sui ruoli ottenute dal parametro encryptedTicket specificato.Instantiates a RolePrincipal object for the specified identity with role information from the specified encryptedTicket.

RolePrincipal(SerializationInfo, StreamingContext)

Inizializza una nuova istanza della classe RolePrincipal utilizzando informazioni contenute nell'oggetto SerializationInfo e il contesto di flusso specificati.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)

Crea un'istanza di un oggetto RolePrincipal per il parametro identity specificato utilizzando il parametro providerName specificato.Instantiates a RolePrincipal object for the specified identity using the specified providerName.

RolePrincipal(String, IIdentity, String)

Crea un'istanza di un oggetto RolePrincipal per il parametro identity specificato utilizzando il parametro providerName specificato e le informazioni sui ruoli ottenute dal parametro encryptedTicket specificato.Instantiates a RolePrincipal object for the specified identity using the specified providerName and role information from the specified encryptedTicket.

Properties

CachedListChanged

Ottiene un valore che indica se l'elenco di nomi di ruoli memorizzato con l'oggetto RolePrincipal è stato modificato.Gets a value indicating whether the list of role names cached with the RolePrincipal object has been modified.

Claims

Ottiene una raccolta che contiene tutte le attestazioni da tutte le identità di attestazioni associate all'entità delle attestazioni.Gets a collection that contains all of the claims from all of the claims identities associated with this claims principal.

(Inherited from ClaimsPrincipal)
CookiePath

Ottiene il percorso del cookie dei nomi di ruoli memorizzati.Gets the path for the cached role names cookie.

CustomSerializationData

Contiene i dati aggiuntivi forniti da un tipo derivato.Contains any additional data provided by a derived type. Generalmente impostato durante la chiamata a WriteTo(BinaryWriter, Byte[]).Typically set when calling WriteTo(BinaryWriter, Byte[]).

(Inherited from ClaimsPrincipal)
Expired

Ottiene un valore che indica se il cookie dei ruoli è scaduto.Gets a value indicating whether the roles cookie has expired.

ExpireDate

Ottiene la data e l'ora di scadenza del cookie dei ruoli.Gets the date and time when the roles cookie will expire.

Identities

Ottiene una raccolta contenente tutte le identità delle attestazioni associate a questa entità attestazioni.Gets a collection that contains all of the claims identities associated with this claims principal.

(Inherited from ClaimsPrincipal)
Identity

Ottiene l'identità di sicurezza per la richiesta HTTP corrente.Gets the security identity for the current HTTP request.

IsRoleListCached

Ottiene un valore che indica se l'elenco di ruoli per l'utente è stato memorizzato in un cookie.Gets a value indicating whether the list of roles for the user has been cached in a cookie.

IssueDate

Ottiene la data e l'ora in cui è stato emesso il cookie dei ruoli.Gets the date and time that the roles cookie was issued.

ProviderName

Ottiene il nome del provider di ruoli in cui sono archiviate e da cui vengono recuperate le informazioni sui ruoli relative all'utente.Gets the name of the role provider that stores and retrieves role information for the user.

Version

Ottiene il numero di versione del cookie dei ruoli.Gets the version number of the roles cookie.

Methods

AddIdentities(IEnumerable<ClaimsIdentity>)

Aggiunge le identità delle attestazioni specificate a questa entità delle attestazioni.Adds the specified claims identities to this claims principal.

(Inherited from ClaimsPrincipal)
AddIdentity(ClaimsIdentity)

Aggiunge le identità delle attestazioni specificate a questa entità delle attestazioni.Adds the specified claims identity to this claims principal.

(Inherited from ClaimsPrincipal)
Clone()

Restituisce una copia dell'istanza corrente.Returns a copy of this instance.

(Inherited from ClaimsPrincipal)
CreateClaimsIdentity(BinaryReader)

Crea una nuova identità delle attestazioni.Creates a new claims identity.

(Inherited from ClaimsPrincipal)
Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Inherited from Object)
FindAll(Predicate<Claim>)

Recupera tutte le attestazioni che corrispondono al predicato specificato.Retrieves all of the claims that are matched by the specified predicate.

(Inherited from ClaimsPrincipal)
FindAll(String)

Recupera tutte le attestazioni con il tipo di attestazione specificato.Retrieves all or the claims that have the specified claim type.

(Inherited from ClaimsPrincipal)
FindFirst(Predicate<Claim>)

Recupera la prima attestazione che corrisponde al predicato specificato.Retrieves the first claim that is matched by the specified predicate.

(Inherited from ClaimsPrincipal)
FindFirst(String)

Recupera la prima attestazione con il tipo di attestazione specificato.Retrieves the first claim with the specified claim type.

(Inherited from ClaimsPrincipal)
GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Inherited from Object)
GetObjectData(SerializationInfo, StreamingContext)

Popola un oggetto SerializationInfo con i dati necessari per serializzare l'oggetto di destinazione utilizzando il contesto di flusso specificato.Populates a SerializationInfo object with the data that is required in order to serialize the target object using the specified streaming context.

GetRoles()

Ottiene un elenco di ruoli di cui è membro l'oggetto RolePrincipal.Gets a list of roles that the RolePrincipal is a member of.

GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Inherited from Object)
HasClaim(Predicate<Claim>)

Determina se una qualsiasi delle identità di attestazione associate all'entità delle attestazioni contiene un'attestazione a cui corrisponde il predicato specificato.Determines whether any of the claims identities associated with this claims principal contains a claim that is matched by the specified predicate.

(Inherited from ClaimsPrincipal)
HasClaim(String, String)

Determina se una qualsiasi delle identità di attestazione associate all'entità delle attestazioni contiene un'attestazione con il tipo e il valore specificati.Determines whether any of the claims identities associated with this claims principal contains a claim with the specified claim type and value.

(Inherited from ClaimsPrincipal)
IsInRole(String)

Ottiene un valore che indica se l'utente rappresentato dall'oggetto RolePrincipal appartiene al ruolo specificato.Gets a value indicating whether the user represented by the RolePrincipal is in the specified role.

MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Inherited from Object)
SetDirty()

Contrassegna come modificato l'elenco di ruoli memorizzato.Marks the cached role list as having been changed.

ToEncryptedTicket()

Restituisce le informazioni sui ruoli memorizzate con l'oggetto RolePrincipal crittografato in base alla proprietà CookieProtectionValue.Returns the role information cached with the RolePrincipal object encrypted based on the CookieProtectionValue.

ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Inherited from Object)
WriteTo(BinaryWriter)

Esegue la serializzazione usando BinaryWriter.Serializes using a BinaryWriter.

(Inherited from ClaimsPrincipal)
WriteTo(BinaryWriter, Byte[])

Esegue la serializzazione usando BinaryWriter.Serializes using a BinaryWriter.

(Inherited from ClaimsPrincipal)

Explicit Interface Implementations

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Per una descrizione di questo membro, vedere GetObjectData(Object, SerializationInfo, StreamingContext).For a description of this member, see GetObjectData(Object, SerializationInfo, StreamingContext).

Applies to

See also