UserManager<TUser> Clase

Referencia

Definición

Espacio de nombres:: Microsoft.AspNetCore.Identity

Ensamblado:: Microsoft.AspNetCore.Identity.dll

Ensamblado:: Microsoft.Extensions.Identity.Core.dll

Paquete:: Microsoft.AspNetCore.Identity v1.0.0

Paquete:: Microsoft.AspNetCore.Identity v1.1.0

Paquete:: Microsoft.Extensions.Identity.Core v2.0.0

Paquete:: Microsoft.Extensions.Identity.Core v2.1.0

Paquete:: Microsoft.Extensions.Identity.Core v2.2.0

Paquete:: Microsoft.Extensions.Identity.Core v3.0.3

Paquete:: Microsoft.Extensions.Identity.Core v3.1.18

Paquete:: Microsoft.Extensions.Identity.Core v5.0.9

Paquete:: Microsoft.Extensions.Identity.Core v6.0.6

Paquete:: Microsoft.Extensions.Identity.Core v7.0.0-preview.5.22303.8

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Proporciona las API para administrar el usuario en un almacén de persistencia.

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

Parámetros de tipo

TUser

Tipo que encapsula un usuario.

Herencia: Object
UserManager<TUser>

Derivado: Microsoft.AspNetCore.Identity.AspNetUserManager<TUser>

Implementaciones: IDisposable

Constructores

UserManager<TUser>(IUserStore<TUser>, IOptions<IdentityOptions>, IPasswordHasher<TUser>, IEnumerable<IUserValidator<TUser>>, IEnumerable<IPasswordValidator<TUser>>, ILookupNormalizer, IdentityErrorDescriber, IServiceProvider, ILogger<UserManager<TUser>>)	Crea una nueva instancia de UserManager<TUser>.
UserManager<TUser>(IUserStore<TUser>, IOptions<IdentityOptions>, IPasswordHasher<TUser>, IEnumerable<IUserValidator<TUser>>, IEnumerable<IPasswordValidator<TUser>>, ILookupNormalizer, IdentityErrorDescriber, IServiceProvider, ILogger<UserManager<TUser>>)	Crea una nueva instancia de UserManager<TUser>.

Campos

ChangePhoneNumberTokenPurpose	Propósito de protección de datos utilizado para los métodos de número de teléfono modificados.
ConfirmEmailTokenPurpose	Propósito de protección de datos utilizado para los métodos relacionados con la confirmación por correo electrónico.
ResetPasswordTokenPurpose	Propósito de protección de datos utilizado para los métodos relacionados con la contraseña de restablecimiento.

Propiedades

CancellationToken	Token de cancelación usado para cancelar las operaciones.
ErrorDescriber	utilizado IdentityErrorDescriber para generar mensajes de error.
KeyNormalizer	ILookupNormalizer que se usa para normalizar elementos como los nombres de usuario y rol.
Logger	ILogger utilizado para registrar mensajes del administrador.
Options	IdentityOptions que se usa para configurar Identity.
PasswordHasher	que IPasswordHasher<TUser> se usa para aplicar hash a las contraseñas.
PasswordValidators	utilizado IPasswordValidator<TUser> para validar contraseñas.
Store	Obtiene o establece el almacén de persistencia en el que opera el administrador.
SupportsQueryableUsers	Obtiene una marca que indica si el almacén de usuarios de respaldo admite la devolución IQueryable de colecciones de información.
SupportsUserAuthenticationTokens	Obtiene una marca que indica si el almacén de usuarios de respaldo admite tokens de autenticación.
SupportsUserAuthenticatorKey	Obtiene una marca que indica si el almacén de usuario de respaldo admite un autenticador de usuario.
SupportsUserClaim	Obtiene una marca que indica si el almacén de usuario de respaldo admite notificaciones de usuario.
SupportsUserEmail	Obtiene una marca que indica si el almacén de usuarios de respaldo admite correos electrónicos de usuario.
SupportsUserLockout	Obtiene una marca que indica si el almacén de respaldo del usuario admite bloqueos de usuario.
SupportsUserLogin	Obtiene una marca que indica si el almacén de usuarios de respaldo admite inicios de sesión externos.
SupportsUserPassword	Obtiene una marca que indica si el almacén de usuarios de respaldo admite contraseñas de usuario.
SupportsUserPhoneNumber	Obtiene una marca que indica si el almacén de respaldo del usuario admite números de teléfono de usuario.
SupportsUserRole	Obtiene una marca que indica si el almacén de usuarios de respaldo admite roles de usuario.
SupportsUserSecurityStamp	Obtiene una marca que indica si el almacén de usuario de respaldo admite stamps de seguridad.
SupportsUserTwoFactor	Obtiene una marca que indica si el almacén de usuarios de respaldo admite la autenticación en dos fases.
SupportsUserTwoFactorRecoveryCodes	Obtiene una marca que indica si el almacén de respaldo del usuario admite códigos de recuperación.
Users	Devuelve un valor IQueryable de los usuarios si el almacén es IQueryableUserStore.
UserValidators	utilizado IUserValidator<TUser> para validar usuarios.

Métodos

AccessFailedAsync(TUser)	Incrementa el número de errores de acceso para el usuario como una operación asincrónica. Si la cuenta de acceso con errores es mayor o igual que el número máximo configurado de intentos, el usuario se bloqueará para el intervalo de tiempo de bloqueo configurado.
AddClaimAsync(TUser, Claim)	Agrega el objeto `claim` especificado a la colección `user`.
AddClaimsAsync(TUser, IEnumerable<Claim>)	Agrega el objeto `claims` especificado a la colección `user`.
AddLoginAsync(TUser, UserLoginInfo)	Agrega un elemento externo UserLoginInfo al especificado `user`.
AddPasswordAsync(TUser, String)	`password` Agrega al especificado `user` solo si el usuario aún no tiene una contraseña.
AddToRoleAsync(TUser, String)	Agregue el especificado `user` al rol con nombre.
AddToRolesAsync(TUser, IEnumerable<String>)	Agregue el especificado `user` a los roles con nombre.
ChangeEmailAsync(TUser, String, String)	Novedades un correo electrónico de los usuarios si el cambio `token` de correo electrónico especificado es válido para el usuario.
ChangePasswordAsync(TUser, String, String)	Cambia la contraseña de un usuario después de confirmar que el especificado `currentPassword` es correcto, como una operación asincrónica.
ChangePhoneNumberAsync(TUser, String, String)	Establece el número de teléfono para el especificado `user` si el cambio `token` especificado es válido.
CheckPasswordAsync(TUser, String)	Devuelve una marca que indica si el especificado `password` es válido para el especificado `user`.
ConfirmEmailAsync(TUser, String)	Valida que un token de confirmación de correo electrónico coincida con el especificado `user`.
CountRecoveryCodesAsync(TUser)	Devuelve el número de código de recuperación que sigue siendo válido para un usuario.
CreateAsync(TUser)	Crea el objeto especificado `user` en el almacén de respaldo sin contraseña, como una operación asincrónica.
CreateAsync(TUser, String)	Crea el objeto especificado `user` en el almacén de respaldo con una contraseña determinada, como una operación asincrónica.
CreateSecurityTokenAsync(TUser)	Crea bytes para usarlos como token de seguridad a partir de la marca de seguridad del usuario.
CreateTwoFactorRecoveryCode()	Genere un nuevo código de recuperación.
DeleteAsync(TUser)	Elimina el objeto especificado `user` de la memoria auxiliar.
Dispose()	Libera todos los recursos usados por el administrador de usuarios.
Dispose(Boolean)	Libera los recursos no administrados usados por el administrador de roles y, opcionalmente, libera los recursos administrados.
FindByEmailAsync(String)	Obtiene el usuario, si existe, asociado al valor normalizado de la dirección de correo electrónico especificada. Nota: Se recomienda establecer identityOptions.User.RequireUniqueEmail en true cuando se usa este método; de lo contrario, el almacén puede producir si hay usuarios con correos electrónicos duplicados.
FindByIdAsync(String)	Busca y devuelve un usuario, si existe, que tiene el especificado `userId`.
FindByLoginAsync(String, String)	Recupera el usuario asociado con el proveedor de inicio de sesión externo y la clave de proveedor de inicio de sesión especificados.
FindByNameAsync(String)	Busca y devuelve un usuario, si existe, que tiene el nombre de usuario especificado.
GenerateChangeEmailTokenAsync(TUser, String)	Genera un token de cambio de correo electrónico para el usuario especificado.
GenerateChangePhoneNumberTokenAsync(TUser, String)	Genera un token de cambio de número de teléfono para el usuario especificado.
GenerateConcurrencyStampAsync(TUser)	Genera un valor adecuado para su uso en el seguimiento de simultaneidad.
GenerateEmailConfirmationTokenAsync(TUser)	Genera un token de confirmación de correo electrónico para el usuario especificado.
GenerateNewAuthenticatorKey()	Genera un nuevo secreto de seguridad de 160 bits codificado en base32 (tamaño de hash SHA1).
GenerateNewTwoFactorRecoveryCodesAsync(TUser, Int32)	Genera códigos de recuperación para el usuario, lo que invalida los códigos de recuperación anteriores para el usuario.
GeneratePasswordResetTokenAsync(TUser)	Genera un token de restablecimiento de contraseña para el especificado `user`mediante el proveedor de tokens de restablecimiento de contraseña configurado.
GenerateTwoFactorTokenAsync(TUser, String)	Obtiene un token de autenticación en dos fases para el especificado `user`.
GenerateUserTokenAsync(TUser, String, String)	Genera un token para los especificados `user` y `purpose`.
GetAccessFailedCountAsync(TUser)	Recupera el número actual de accesos erróneos para el especificado `user`.
GetAuthenticationTokenAsync(TUser, String, String)	Devuelve un token de autenticación para un usuario.
GetAuthenticatorKeyAsync(TUser)	Devuelve la clave de autenticador para el usuario.
GetChangeEmailTokenPurpose(String)	Genera el propósito del token utilizado para cambiar el correo electrónico.
GetClaimsAsync(TUser)	Obtiene una lista de Claims que se va a pertenecer al objeto especificado `user` como una operación asincrónica.
GetEmailAsync(TUser)	Obtiene la dirección de correo electrónico del especificado `user`.
GetLockoutEnabledAsync(TUser)	Recupera una marca que indica si el bloqueo de usuario se puede habilitar para el usuario especificado.
GetLockoutEndDateAsync(TUser)	Obtiene el último DateTimeOffset bloqueo de un usuario expirado, si existe. Un valor de hora en el pasado indica que un usuario no está bloqueado actualmente.
GetLoginsAsync(TUser)	Recupera los inicios de sesión asociados para el especificado. .
GetPhoneNumberAsync(TUser)	Obtiene el número de teléfono, si existe, para el especificado `user`.
GetRolesAsync(TUser)	Obtiene una lista de nombres de rol a los que pertenece el especificado `user` .
GetSecurityStampAsync(TUser)	Obtenga la marca de seguridad para el especificado `user`.
GetTwoFactorEnabledAsync(TUser)	Devuelve una marca que indica si el especificado `user` tiene habilitada o no la autenticación en dos fases, como una operación asincrónica.
GetUserAsync(ClaimsPrincipal)	Devuelve el usuario correspondiente a la notificación IdentityOptions.ClaimsIdentity.UserIdClaimType en la entidad de seguridad o null.
GetUserId(ClaimsPrincipal)	Devuelve el valor de notificación User ID si existe; de lo contrario, devuelve null.
GetUserIdAsync(TUser)	Obtiene el identificador de usuario para el especificado `user`.
GetUserName(ClaimsPrincipal)	Devuelve el valor de notificación Name si existe; de lo contrario, devuelve null.
GetUserNameAsync(TUser)	Obtiene el nombre de usuario para el especificado `user`.
GetUsersForClaimAsync(Claim)	Devuelve una lista de usuarios del almacén de usuarios que tienen el especificado `claim`.
GetUsersInRoleAsync(String)	Devuelve una lista de usuarios del almacén de usuarios que son miembros del especificado `roleName`.
GetValidTwoFactorProvidersAsync(TUser)	Obtiene una lista de proveedores de tokens de dos factores válidos para el especificado `user`, como una operación asincrónica.
HasPasswordAsync(TUser)	Obtiene una marca que indica si el objeto especificado `user` tiene una contraseña.
IsEmailConfirmedAsync(TUser)	Obtiene una marca que indica si se ha comprobado la dirección de correo electrónico del especificado `user` , true si la dirección de correo electrónico se comprueba de otro modo false.
IsInRoleAsync(TUser, String)	Devuelve una marca que indica si el objeto especificado `user` es miembro del rol con nombre especificado.
IsLockedOutAsync(TUser)	Devuelve una marca que indica si el especificado `user` está bloqueado, como una operación asincrónica.
IsPhoneNumberConfirmedAsync(TUser)	Obtiene una marca que indica si se ha confirmado el número de teléfono especificado `user`.
NormalizeEmail(String)	Normalizar el correo electrónico para comparaciones coherentes.
NormalizeKey(String)	Normalice una clave (nombre de usuario, correo electrónico) para comparaciones coherentes.
NormalizeName(String)	Normalice el nombre de usuario o rol para comparaciones coherentes.
RedeemTwoFactorRecoveryCodeAsync(TUser, String)	Devuelve si un código de recuperación es válido para un usuario. Nota: los códigos de recuperación solo son válidos una vez y no serán válidos después de su uso.
RegisterTokenProvider(String, IUserTwoFactorTokenProvider<TUser>)	Registra un proveedor de tokens.
RemoveAuthenticationTokenAsync(TUser, String, String)	Quite un token de autenticación para un usuario.
RemoveClaimAsync(TUser, Claim)	Quita el objeto especificado `claim` de la clase especificada `user`.
RemoveClaimsAsync(TUser, IEnumerable<Claim>)	Quita el objeto especificado `claims` de la clase especificada `user`.
RemoveFromRoleAsync(TUser, String)	Quita el especificado `user` del rol con nombre.
RemoveFromRolesAsync(TUser, IEnumerable<String>)	Quita el especificado `user` de los roles con nombre.
RemoveLoginAsync(TUser, String, String)	Intenta quitar la información de inicio de sesión externa proporcionada del especificado `user`. y devuelve una marca que indica si la eliminación se realiza correctamente o no.
RemovePasswordAsync(TUser)	Quita la contraseña de un usuario.
RemovePasswordAsync(TUser, CancellationToken)	Quita la contraseña de un usuario.
ReplaceClaimAsync(TUser, Claim, Claim)	Reemplaza el especificado `claim` en el objeto especificado `user` por . `newClaim`
ResetAccessFailedCountAsync(TUser)	Restablece el número de errores de acceso para el especificado `user`.
ResetAuthenticatorKeyAsync(TUser)	Restablece la clave de autenticador para el usuario.
ResetPasswordAsync(TUser, String, String)	Restablece la `user`contraseña del especificado `newPassword` después de validar el restablecimiento `token`de contraseña especificado.
SetAuthenticationTokenAsync(TUser, String, String, String)	Establece un token de autenticación para un usuario.
SetEmailAsync(TUser, String)	Establece la `email` dirección de un `user`objeto .
SetLockoutEnabledAsync(TUser, Boolean)	Establece una marca que indica si el especificado `user` está bloqueado, como una operación asincrónica.
SetLockoutEndDateAsync(TUser, Nullable<DateTimeOffset>)	Bloquea un usuario hasta que se haya superado la fecha de finalización especificada. Establecer una fecha de finalización en el pasado desbloquea inmediatamente a un usuario.
SetPhoneNumberAsync(TUser, String)	Establece el número de teléfono para el especificado `user`.
SetTwoFactorEnabledAsync(TUser, Boolean)	Establece una marca que indica si el especificado `user` tiene habilitada o no la autenticación en dos fases, como una operación asincrónica.
SetUserNameAsync(TUser, String)	Establece el objeto especificado `userName` para el especificado `user`.
ThrowIfDisposed()	Produce si se ha eliminado esta clase.
UpdateAsync(TUser)	Novedades el especificado `user` en la memoria auxiliar.
UpdateNormalizedEmailAsync(TUser)	Novedades el correo electrónico normalizado para el especificado`user`.
UpdateNormalizedUserNameAsync(TUser)	Novedades el nombre de usuario normalizado para el especificado`user`.
UpdatePasswordHash(TUser, String, Boolean)	Novedades hash de contraseña de un usuario.
UpdateSecurityStampAsync(TUser)	Vuelve a generar la marca de seguridad para el especificado `user`.
UpdateUserAsync(TUser)	Se llama para actualizar al usuario después de validar y actualizar el nombre de usuario o correo electrónico normalizado.
ValidatePasswordAsync(TUser, String)	Debe devolver Success si la validación es correcta. Se llama a esto antes de actualizar el hash de contraseña.
ValidateUserAsync(TUser)	Debe devolver Success si la validación es correcta. Se llama a esto antes de guardar el usuario a través de Crear o Actualizar.
VerifyChangePhoneNumberTokenAsync(TUser, String, String)	Devuelve una marca que indica si el token de verificación de cambio de número de teléfono especificado `user`es válido para el especificado `phoneNumber`.
VerifyPasswordAsync(IUserPasswordStore<TUser>, TUser, String)	Devuelve un PasswordVerificationResult valor de tipo que indica el resultado de una comparación de hash de contraseña.
VerifyTwoFactorTokenAsync(TUser, String, String)	Comprueba la autenticación `token` en dos fases especificada en .`user`
VerifyUserTokenAsync(TUser, String, String, String)	Devuelve una marca que indica si el objeto especificado `token` es válido para el especificado `user` y `purpose`.

Se aplica a