Condividi tramite


UserManager<TUser> Classe

Definizione

Fornisce le API per la gestione dell'utente in un archivio di persistenza.

generic <typename TUser>
 where TUser : classpublic ref class UserManager : IDisposable
public class UserManager<TUser> : IDisposable where TUser : class
type UserManager<'User (requires 'User : null)> = class
    interface IDisposable
Public Class UserManager(Of TUser)
Implements IDisposable

Parametri di tipo

TUser

Tipo che incapsula un utente.

Ereditarietà
UserManager<TUser>
Derivato
Implementazioni

Costruttori

UserManager<TUser>(IUserStore<TUser>, IOptions<IdentityOptions>, IPasswordHasher<TUser>, IEnumerable<IUserValidator<TUser>>, IEnumerable<IPasswordValidator<TUser>>, ILookupNormalizer, IdentityErrorDescriber, IServiceProvider, ILogger<UserManager<TUser>>)

Costruisce una nuova istanza di UserManager<TUser>.

UserManager<TUser>(IUserStore<TUser>, IOptions<IdentityOptions>, IPasswordHasher<TUser>, IEnumerable<IUserValidator<TUser>>, IEnumerable<IPasswordValidator<TUser>>, ILookupNormalizer, IdentityErrorDescriber, IServiceProvider, ILogger<UserManager<TUser>>)

Costruisce una nuova istanza di UserManager<TUser>.

Campi

ChangePhoneNumberTokenPurpose

Scopo della protezione dei dati usato per i metodi di modifica del numero di telefono.

ConfirmEmailTokenPurpose

Scopo della protezione dei dati usato per i metodi correlati alla conferma tramite posta elettronica.

ResetPasswordTokenPurpose

Scopo della protezione dei dati usato per i metodi correlati alla reimpostazione della password.

Proprietà

CancellationToken

Token di annullamento utilizzato per annullare le operazioni.

ErrorDescriber

Il IdentityErrorDescriber utilizzato per generare messaggi di errore.

KeyNormalizer

Il ILookupNormalizer usato per normalizzare elementi come i nomi utente e ruolo.

Logger

Il ILogger utilizzato per registrare i messaggi dal manager.

Options

Il IdentityOptions usato per configurare l'identità.

PasswordHasher

Il IPasswordHasher<TUser> utilizzato per eseguire l'hash delle password.

PasswordValidators

Il IPasswordValidator<TUser> utilizzato per convalidare le password.

Store

Ottiene o imposta l'archivio di persistenza su cui opera il manager.

SupportsQueryableUsers

Ottiene un flag che indica se l'archivio utenti di backup supporta la restituzione di IQueryable raccolte di informazioni.

SupportsUserAuthenticationTokens

Ottiene un flag che indica se l'archivio utenti di backup supporta i token di autenticazione.

SupportsUserAuthenticatorKey

Ottiene un flag che indica se l'archivio utenti di supporto supporta un autenticatore utente.

SupportsUserClaim

Ottiene un flag che indica se l'archivio utenti di supporto supporta le attestazioni utente.

SupportsUserEmail

Ottiene un flag che indica se l'archivio utenti di supporto supporta i messaggi di posta elettronica degli utenti.

SupportsUserLockout

Ottiene un flag che indica se l'archivio utenti di backup supporta i blocchi utente.

SupportsUserLogin

Ottiene un flag che indica se l'archivio utenti di backup supporta gli account di accesso esterni.

SupportsUserPassword

Ottiene un flag che indica se l'archivio utenti di supporto supporta le password utente.

SupportsUserPhoneNumber

Ottiene un flag che indica se l'archivio utenti di supporto supporta i numeri di telefono utente.

SupportsUserRole

Ottiene un flag che indica se l'archivio utenti di supporto supporta i ruoli utente.

SupportsUserSecurityStamp

Ottiene un flag che indica se l'archivio utenti di supporto supporta indicatori di sicurezza.

SupportsUserTwoFactor

Ottiene un flag che indica se l'archivio utenti di supporto supporta l'autenticazione a due fattori.

SupportsUserTwoFactorRecoveryCodes

Ottiene un flag che indica se l'archivio utenti di backup supporta i codici di ripristino.

Users

Restituisce un oggetto IQueryable di utenti se l'archivio è un oggetto IQueryableUserStore

UserValidators

Il IUserValidator<TUser> utilizzato per convalidare gli utenti.

Metodi

AccessFailedAsync(TUser)

Incrementa il numero di accessi non riusciti per l'utente come operazione asincrona. Se l'account di accesso non riuscito è maggiore o uguale al numero massimo di tentativi configurato, l'utente verrà bloccato per l'intervallo di tempo di blocco configurato.

AddClaimAsync(TUser, Claim)

Aggiunge il claim specificato al user.

AddClaimsAsync(TUser, IEnumerable<Claim>)

Aggiunge il claims specificato al user.

AddLoginAsync(TUser, UserLoginInfo)

Aggiunge un UserLoginInfo esterno al userspecificato.

AddPasswordAsync(TUser, String)

Aggiunge il password all'user specificato solo se l'utente non dispone già di una password.

AddToRoleAsync(TUser, String)

Aggiungere il user specificato al ruolo denominato.

AddToRolesAsync(TUser, IEnumerable<String>)

Aggiungere il user specificato ai ruoli denominati.

ChangeEmailAsync(TUser, String, String)

Aggiorna un messaggio di posta elettronica degli utenti se la modifica di posta elettronica specificata token è valida per l'utente.

ChangePasswordAsync(TUser, String, String)

Modifica la password di un utente dopo aver confermato la currentPassword specificata è corretta, come operazione asincrona.

ChangePhoneNumberAsync(TUser, String, String)

Imposta il numero di telefono per il user specificato se la modifica specificata token è valida.

CheckPasswordAsync(TUser, String)

Restituisce un flag che indica se il password specificato è valido per il userspecificato.

ConfirmEmailAsync(TUser, String)

Verifica che un token di conferma tramite posta elettronica corrisponda al userspecificato.

CountRecoveryCodesAsync(TUser)

Restituisce il numero di codice di ripristino ancora valido per un utente.

CreateAsync(TUser)

Crea il user specificato nell'archivio di backup senza password, come operazione asincrona.

CreateAsync(TUser, String)

Crea il user specificato nell'archivio di backup con la password specificata, come operazione asincrona.

CreateSecurityTokenAsync(TUser)

Crea byte da usare come token di sicurezza dal timbro di sicurezza dell'utente.

CreateTwoFactorRecoveryCode()

Generare un nuovo codice di ripristino.

DeleteAsync(TUser)

Elimina il user specificato dall'archivio di backup.

Dispose()

Rilascia tutte le risorse usate dal gestore utenti.

Dispose(Boolean)

Rilascia le risorse non gestite usate dal gestore dei ruoli e, facoltativamente, rilascia le risorse gestite.

FindByEmailAsync(String)

Ottiene l'utente, se presente, associato al valore normalizzato dell'indirizzo di posta elettronica specificato. Nota: è consigliabile impostare identityOptions.User.RequireUniqueEmail su true quando si usa questo metodo. In caso contrario, l'archivio potrebbe generare un'eccezione se sono presenti utenti con messaggi di posta elettronica duplicati.

FindByIdAsync(String)

Trova e restituisce un utente, se presente, che ha il userIdspecificato.

FindByLoginAsync(String, String)

Recupera l'utente associato al provider di accesso esterno specificato e alla chiave del provider di accesso.

FindByNameAsync(String)

Trova e restituisce un utente, se presente, con il nome utente specificato.

GenerateChangeEmailTokenAsync(TUser, String)

Genera un token di modifica della posta elettronica per l'utente specificato.

GenerateChangePhoneNumberTokenAsync(TUser, String)

Genera un token di modifica del numero di telefono per l'utente specificato.

GenerateConcurrencyStampAsync(TUser)

Genera un valore adatto per l'uso nel rilevamento della concorrenza.

GenerateEmailConfirmationTokenAsync(TUser)

Genera un token di conferma tramite posta elettronica per l'utente specificato.

GenerateNewAuthenticatorKey()

Genera un nuovo segreto di sicurezza a 160 bit con codifica Base32 (dimensione dell'hash SHA1).

GenerateNewTwoFactorRecoveryCodesAsync(TUser, Int32)

Genera codici di ripristino per l'utente, che invalida tutti i codici di ripristino precedenti per l'utente.

GeneratePasswordResetTokenAsync(TUser)

Genera un token di reimpostazione della password per il userspecificato usando il provider di token di reimpostazione della password configurato.

GenerateTwoFactorTokenAsync(TUser, String)

Ottiene un token di autenticazione a due fattori per l'userspecificato.

GenerateUserTokenAsync(TUser, String, String)

Genera un token per il user specificato e purpose.

GetAccessFailedCountAsync(TUser)

Recupera il numero corrente di accessi non riusciti per il userspecificato.

GetAuthenticationTokenAsync(TUser, String, String)

Restituisce un token di autenticazione per un utente.

GetAuthenticatorKeyAsync(TUser)

Restituisce la chiave dell'autenticatore per l'utente.

GetChangeEmailTokenPurpose(String)

Genera lo scopo del token usato per modificare il messaggio di posta elettronica.

GetClaimsAsync(TUser)

Ottiene un elenco di Claimda appartenere al user specificato come operazione asincrona.

GetEmailAsync(TUser)

Ottiene l'indirizzo di posta elettronica per il userspecificato.

GetLockoutEnabledAsync(TUser)

Recupera un flag che indica se è possibile abilitare il blocco utente per l'utente specificato.

GetLockoutEndDateAsync(TUser)

Ottiene l'ultimo DateTimeOffset l'ultimo blocco di un utente scaduto, se presente. Un valore di ora in passato indica che un utente non è attualmente bloccato.

GetLoginsAsync(TUser)

Recupera gli account di accesso associati per l'oggetto specificato.

GetPhoneNumberAsync(TUser)

Ottiene il numero di telefono, se presente, per il userspecificato.

GetRolesAsync(TUser)

Ottiene un elenco di nomi di ruolo a cui appartiene il user specificato.

GetSecurityStampAsync(TUser)

Ottenere il timbro di sicurezza per il userspecificato.

GetTwoFactorEnabledAsync(TUser)

Restituisce un flag che indica se il user specificato dispone o meno dell'autenticazione a due fattori, come operazione asincrona.

GetUserAsync(ClaimsPrincipal)

Restituisce l'utente corrispondente all'attestazione IdentityOptions.ClaimsIdentity.UserIdClaimType nell'entità o null.

GetUserId(ClaimsPrincipal)

Restituisce il valore dell'attestazione ID utente se presente in caso contrario restituisce Null.

GetUserIdAsync(TUser)

Ottiene l'identificatore utente per il userspecificato.

GetUserName(ClaimsPrincipal)

Restituisce il valore dell'attestazione Name se presente in caso contrario restituisce Null.

GetUserNameAsync(TUser)

Ottiene il nome utente per il userspecificato.

GetUsersForClaimAsync(Claim)

Restituisce un elenco di utenti dall'archivio utenti con il claimspecificato.

GetUsersInRoleAsync(String)

Restituisce un elenco di utenti dall'archivio utenti membri del roleNamespecificato.

GetValidTwoFactorProvidersAsync(TUser)

Ottiene un elenco di provider di token a due fattori validi per l'userspecificato, come operazione asincrona.

HasPasswordAsync(TUser)

Ottiene un flag che indica se il user specificato ha una password.

IsEmailConfirmedAsync(TUser)

Ottiene un flag che indica se l'indirizzo di posta elettronica per il user specificato è stato verificato, true se l'indirizzo di posta elettronica è verificato in caso contrario false.

IsInRoleAsync(TUser, String)

Restituisce un flag che indica se il user specificato è un membro del ruolo denominato specificato.

IsLockedOutAsync(TUser)

Restituisce un flag che indica se il user specificato è bloccato, come operazione asincrona.

IsPhoneNumberConfirmedAsync(TUser)

Ottiene un flag che indica se il numero di telefono del userspecificato è stato confermato.

NormalizeEmail(String)

Normalizzare la posta elettronica per confronti coerenti.

NormalizeKey(String)

Normalizzare una chiave (nome utente, indirizzo di posta elettronica) per confronti coerenti.

NormalizeName(String)

Normalizzare il nome utente o il nome del ruolo per confronti coerenti.

RedeemTwoFactorRecoveryCodeAsync(TUser, String)

Restituisce un valore che indica se un codice di ripristino è valido per un utente. Nota: i codici di ripristino sono validi una sola volta e non saranno validi dopo l'uso.

RegisterTokenProvider(String, IUserTwoFactorTokenProvider<TUser>)

Registra un provider di token.

RemoveAuthenticationTokenAsync(TUser, String, String)

Rimuovere un token di autenticazione per un utente.

RemoveClaimAsync(TUser, Claim)

Rimuove il claim specificato dal userspecificato.

RemoveClaimsAsync(TUser, IEnumerable<Claim>)

Rimuove il claims specificato dal userspecificato.

RemoveFromRoleAsync(TUser, String)

Rimuove il user specificato dal ruolo denominato.

RemoveFromRolesAsync(TUser, IEnumerable<String>)

Rimuove il user specificato dai ruoli denominati.

RemoveLoginAsync(TUser, String, String)

Tenta di rimuovere le informazioni di accesso esterne fornite dal userspecificato. e restituisce un flag che indica se la rimozione ha esito positivo o negativo.

RemovePasswordAsync(TUser)

Rimuove la password di un utente.

RemovePasswordAsync(TUser, CancellationToken)

Rimuove la password di un utente.

ReplaceClaimAsync(TUser, Claim, Claim)

Sostituisce il claim specificato nel user specificato con il newClaim

ResetAccessFailedCountAsync(TUser)

Reimposta il numero di accessi non riusciti per il userspecificato.

ResetAuthenticatorKeyAsync(TUser)

Reimposta la chiave dell'autenticatore per l'utente.

ResetPasswordAsync(TUser, String, String)

Reimposta la password del usersul newPassword specificato dopo aver convalidato la reimpostazione della password specificata token.

SetAuthenticationTokenAsync(TUser, String, String, String)

Imposta un token di autenticazione per un utente.

SetEmailAsync(TUser, String)

Imposta l'indirizzo di email per un user.

SetLockoutEnabledAsync(TUser, Boolean)

Imposta un flag che indica se il user specificato può essere bloccato, come operazione asincrona.

SetLockoutEndDateAsync(TUser, Nullable<DateTimeOffset>)

Blocca un utente fino al superamento della data di fine specificata. L'impostazione di una data di fine nel passato sblocca immediatamente un utente.

SetPhoneNumberAsync(TUser, String)

Imposta il numero di telefono per il userspecificato.

SetTwoFactorEnabledAsync(TUser, Boolean)

Imposta un flag che indica se il user specificato dispone o meno dell'autenticazione a due fattori, come operazione asincrona.

SetUserNameAsync(TUser, String)

Imposta il userName specificato per il userspecificato.

ThrowIfDisposed()

Genera un'eccezione se questa classe è stata eliminata.

UpdateAsync(TUser)

Aggiorna il user specificato nell'archivio di backup.

UpdateNormalizedEmailAsync(TUser)

Aggiorna il messaggio di posta elettronica normalizzato per il userspecificato.

UpdateNormalizedUserNameAsync(TUser)

Aggiorna il nome utente normalizzato per il userspecificato.

UpdatePasswordHash(TUser, String, Boolean)

Aggiorna l'hash delle password di un utente.

UpdateSecurityStampAsync(TUser)

Rigenera il timbro di sicurezza per il userspecificato.

UpdateUserAsync(TUser)

Chiamato per aggiornare l'utente dopo la convalida e l'aggiornamento del nome utente/posta elettronica normalizzato.

ValidatePasswordAsync(TUser, String)

Restituisce Success se la convalida ha esito positivo. Questa operazione viene chiamata prima di aggiornare l'hash della password.

ValidateUserAsync(TUser)

Restituisce Success se la convalida ha esito positivo. Questa operazione viene chiamata prima di salvare l'utente tramite Crea o Aggiorna.

VerifyChangePhoneNumberTokenAsync(TUser, String, String)

Restituisce un flag che indica se il token di verifica della modifica del numero di telefono del userspecificato è valido per il phoneNumberspecificato.

VerifyPasswordAsync(IUserPasswordStore<TUser>, TUser, String)

Restituisce un PasswordVerificationResult che indica il risultato di un confronto di hash delle password.

VerifyTwoFactorTokenAsync(TUser, String, String)

Verifica l'autenticazione a due fattori specificata token rispetto al user.

VerifyUserTokenAsync(TUser, String, String, String)

Restituisce un flag che indica se il token specificato è valido per il user specificato e purpose.

Si applica a