UserManager<TUser> Klasse

Definition

Namespace:

Microsoft.AspNetCore.Identity

Assembly:

Microsoft.Extensions.Identity.Core.dll

Paket:

Microsoft.Extensions.Identity.Core v8.0.0

Stellt die APIs zum Verwalten von Benutzern in einem Persistenzspeicher bereit.

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

Typparameter

TUser

Der Typ, der einen Benutzer kapselt.

Vererbung

Object

UserManager<TUser>

Abgeleitet

Microsoft.AspNetCore.Identity.AspNetUserManager<TUser>

Implementiert

IDisposable

Konstruktoren

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

Erstellt eine neue Instanz von UserManager<TUser>.

Felder

ChangePhoneNumberTokenPurpose	Der Datenschutzzweck, der für die Änderung der Telefonnummernmethoden verwendet wird.
ConfirmEmailTokenPurpose	Der für die E-Mail-Bestätigung verwendete Datenschutzzweck.
ResetPasswordTokenPurpose	Der Datenschutzzweck, der für die Methoden zum Zurücksetzen des Kennworts verwendet wird.

Eigenschaften

CancellationToken	Das Abbruchtoken, das zum Abbrechen von Vorgängen verwendet wird.
ErrorDescriber	Die IdentityErrorDescriber , die zum Generieren von Fehlermeldungen verwendet wird.
KeyNormalizer	Die ILookupNormalizer , die verwendet wird, um Dinge wie Benutzer- und Rollennamen zu normalisieren.
Logger	Der ILogger , der zum Protokollieren von Nachrichten vom Manager verwendet wird.
Options	Die IdentityOptions zum Konfigurieren der Identität verwendete.
PasswordHasher	Das IPasswordHasher<TUser> zum Hashen von Kennwörtern verwendete.
PasswordValidators	Die IPasswordValidator<TUser> , die zum Überprüfen von Kennwörtern verwendet wird.
Store	Ruft den Persistenzspeicher ab, den der Manager betreibt, oder legt diese fest.
SupportsQueryableUsers	Ruft ein Flag ab, das angibt, ob der unterstützende Benutzerspeicher das Zurückgeben von Informationssammlungen IQueryable unterstützt.
SupportsUserAuthenticationTokens	Ruft ein Flag ab, das angibt, ob der unterstützende Benutzerspeicher Authentifizierungstoken unterstützt.
SupportsUserAuthenticatorKey	Ruft ein Flag ab, das angibt, ob der unterstützende Benutzerspeicher einen Benutzerauthentifikator unterstützt.
SupportsUserClaim	Ruft ein Flag ab, das angibt, ob der unterstützende Benutzerspeicher Benutzeransprüche unterstützt.
SupportsUserEmail	Ruft ein Flag ab, das angibt, ob der unterstützende Benutzerspeicher Benutzer-E-Mails unterstützt.
SupportsUserLockout	Ruft ein Flag ab, das angibt, ob der unterstützende Benutzerspeicher Benutzersperren unterstützt.
SupportsUserLogin	Ruft ein Flag ab, das angibt, ob der unterstützende Benutzerspeicher externe Anmeldungen unterstützt.
SupportsUserPassword	Ruft ein Flag ab, das angibt, ob der unterstützende Benutzerspeicher Benutzerkennwörter unterstützt.
SupportsUserPhoneNumber	Ruft ein Flag ab, das angibt, ob der unterstützende Benutzerspeicher Benutzertelefonnummern unterstützt.
SupportsUserRole	Ruft ein Flag ab, das angibt, ob der unterstützende Benutzerspeicher Benutzerrollen unterstützt.
SupportsUserSecurityStamp	Ruft ein Flag ab, das angibt, ob der unterstützende Benutzerspeicher Sicherheitsstempel unterstützt.
SupportsUserTwoFactor	Ruft ein Flag ab, das angibt, ob der unterstützende Benutzerspeicher die zweistufige Authentifizierung unterstützt.
SupportsUserTwoFactorRecoveryCodes	Ruft ein Flag ab, das angibt, ob der unterstützende Benutzerspeicher Wiederherstellungscodes unterstützt.
Users	Gibt einen IQueryable-Wert von Benutzern zurück, wenn es sich bei dem Speicher um einen IQueryableUserStore handelt.
UserValidators	Die IUserValidator<TUser> , die zum Überprüfen von Benutzern verwendet wird.

Methoden

AccessFailedAsync(TUser)	Erhöht die Anzahl der Zugriffsfehler für den Benutzer als asynchronen Vorgang. Wenn das Konto für den fehlerhaften Zugriff größer oder gleich der konfigurierten maximalen Anzahl von Versuchen ist, wird der Benutzer für die konfigurierte Sperrzeit gesperrt.
AddClaimAsync(TUser, Claim)	Fügt dem claim die angegebene user hinzu.
AddClaimsAsync(TUser, IEnumerable<Claim>)	Fügt dem claims die angegebene user hinzu.
AddLoginAsync(TUser, UserLoginInfo)	Fügt dem angegebenen usereine externe UserLoginInfo hinzu.
AddPasswordAsync(TUser, String)	Fügt dem password angegebenen user nur hinzu, wenn der Benutzer nicht bereits über ein Kennwort verfügt.
AddToRoleAsync(TUser, String)	Fügen Sie der benannten Rolle das angegebene user hinzu.
AddToRolesAsync(TUser, IEnumerable<String>)	Fügen Sie den benannten Rollen das angegebene user hinzu.
ChangeEmailAsync(TUser, String, String)	Updates ein Benutzer eine E-Mail an, wenn die angegebene E-Mail-Änderung token für den Benutzer gültig ist.
ChangePasswordAsync(TUser, String, String)	Ändert das Kennwort eines Benutzers, nachdem bestätigt wurde, dass das angegebene currentPassword korrekt ist, als asynchroner Vorgang.
ChangePhoneNumberAsync(TUser, String, String)	Legt die Telefonnummer für die angegebene user fest, wenn die angegebene Änderung token gültig ist.
CheckPasswordAsync(TUser, String)	Gibt ein Flag zurück, das angibt, ob das angegebene password für den angegebenen usergültig ist.
ConfirmEmailAsync(TUser, String)	Überprüft, ob ein E-Mail-Bestätigungstoken mit dem angegebenen userübereinstimmt.
CountRecoveryCodesAsync(TUser)	Gibt zurück, wie viele Wiederherstellungscode für einen Benutzer noch gültig sind.
CreateAsync(TUser)	Erstellt die im Sicherungsspeicher angegebene user ohne Kennwort als asynchronen Vorgang.
CreateAsync(TUser, String)	Erstellt die im Sicherungsspeicher angegebene user mit dem angegebenen Kennwort als asynchronen Vorgang.
CreateSecurityTokenAsync(TUser)	Erstellt Bytes, die als Sicherheitstoken aus dem Sicherheitsstempel des Benutzers verwendet werden sollen.
CreateTwoFactorRecoveryCode()	Generieren Sie einen neuen Wiederherstellungscode.
DeleteAsync(TUser)	Löscht die angegebene user aus dem Sicherungsspeicher.
Dispose()	Gibt alle Ressourcen frei, die vom Benutzer-Manager verwendet werden.
Dispose(Boolean)	Gibt die nicht verwalteten Ressourcen frei, die vom Rollen-Manager verwendet werden, und gibt optional die verwalteten Ressourcen frei.
FindByEmailAsync(String)	Ruft den Benutzer ab, falls vorhanden, dem normalisierten Wert der angegebenen E-Mail-Adresse zugeordnet ist. Hinweis: Es wird empfohlen, identityOptions.User.RequireUniqueEmail bei Verwendung dieser Methode auf true festzulegen. Andernfalls kann der Store ausgelöst werden, wenn Benutzer mit doppelten E-Mails vorhanden sind.
FindByIdAsync(String)	Sucht und gibt einen Benutzer zurück, falls vorhanden, der über den angegebenen userIdverfügt.
FindByLoginAsync(String, String)	Ruft den Benutzer ab, der dem angegebenen externen Anmeldeanbieter und dem angegebenen Anmeldeanbieterschlüssel zugeordnet ist.
FindByNameAsync(String)	Sucht und gibt einen Benutzer zurück, falls vorhanden, der über den angegebenen Benutzernamen verfügt.
GenerateChangeEmailTokenAsync(TUser, String)	Generiert ein E-Mail-Änderungstoken für den angegebenen Benutzer.
GenerateChangePhoneNumberTokenAsync(TUser, String)	Generiert ein Telefonnummernänderungstoken für den angegebenen Benutzer.
GenerateConcurrencyStampAsync(TUser)	Generiert einen Wert, der für die Verwendung bei der Parallelitätsnachverfolgung geeignet ist.
GenerateEmailConfirmationTokenAsync(TUser)	Generiert ein E-Mail-Bestätigungstoken für den angegebenen Benutzer.
GenerateNewAuthenticatorKey()	Generiert ein neues base32-codiertes 160-Bit-Sicherheitsgeheimnis (Größe des SHA1-Hashs).
GenerateNewTwoFactorRecoveryCodesAsync(TUser, Int32)	Generiert Wiederherstellungscodes für den Benutzer. Dadurch werden alle vorherigen Wiederherstellungscodes für den Benutzer ungültig.
GeneratePasswordResetTokenAsync(TUser)	Generiert mithilfe des konfigurierten Token für die Kennwortzurücksetzung ein Kennwortzurücksetzungstoken für den angegebenen user.
GenerateTwoFactorTokenAsync(TUser, String)	Ruft ein zweistufiges Authentifizierungstoken für das angegebene userab.
GenerateUserTokenAsync(TUser, String, String)	Generiert ein Token für die angegebene user und purpose.
GetAccessFailedCountAsync(TUser)	Ruft die aktuelle Anzahl fehlerhafter Zugriffe für den angegebenen userab.
GetAuthenticationTokenAsync(TUser, String, String)	Gibt ein Authentifizierungstoken für einen Benutzer zurück.
GetAuthenticatorKeyAsync(TUser)	Gibt den Authentifikatorschlüssel für den Benutzer zurück.
GetChangeEmailTokenPurpose(String)	Generiert den Tokenzweck, der zum Ändern der E-Mail verwendet wird.
GetClaimsAsync(TUser)	Ruft eine Liste von Claims ab, die zu dem als asynchroner Vorgang angegebenen user gehören sollen.
GetEmailAsync(TUser)	Ruft die E-Mail-Adresse für die angegebene userab.
GetLockoutEnabledAsync(TUser)	Ruft ein Flag ab, das angibt, ob die Benutzersperre für den angegebenen Benutzer aktiviert werden kann.
GetLockoutEndDateAsync(TUser)	Ruft die letzte DateTimeOffset Sperrung eines Benutzers ab, falls vorhanden. Ein Früherer Zeitwert gibt an, dass ein Benutzer derzeit nicht gesperrt ist.
GetLoginsAsync(TUser)	Ruft die zugeordneten Anmeldungen für die angegebene ab.
GetPhoneNumberAsync(TUser)	Ruft die Telefonnummer ab, falls vorhanden, für die angegebene user.
GetRolesAsync(TUser)	Ruft eine Liste von Rollennamen ab, zu der der angegebene user gehört.
GetSecurityStampAsync(TUser)	Rufen Sie den Sicherheitsstempel für den angegebenen userab.
GetTwoFactorEnabledAsync(TUser)	Gibt ein Flag zurück, das angibt, ob für die angegebene user zweistufige Authentifizierung als asynchroner Vorgang aktiviert ist oder nicht.
GetUserAsync(ClaimsPrincipal)	Gibt den Benutzer zurück, der dem Anspruch IdentityOptions.ClaimsIdentity.UserIdClaimType im Prinzipal oder NULL entspricht.
GetUserId(ClaimsPrincipal)	Gibt den Benutzer-ID-Anspruchswert zurück, falls vorhanden andernfalls NULL zurückgegeben wird.
GetUserIdAsync(TUser)	Ruft den Benutzerbezeichner für den angegebenen userab.
GetUserName(ClaimsPrincipal)	Gibt den Name-Anspruchswert zurück, falls vorhanden andernfalls NULL zurückgegeben wird.
GetUserNameAsync(TUser)	Ruft den Benutzernamen für den angegebenen userab.
GetUsersForClaimAsync(Claim)	Gibt eine Liste der Benutzer aus dem Benutzerspeicher zurück, die über den angegebenen claimverfügen.
GetUsersInRoleAsync(String)	Gibt eine Liste der Benutzer aus dem Benutzerspeicher zurück, die Mitglieder des angegebenen roleNamesind.
GetValidTwoFactorProvidersAsync(TUser)	Ruft eine Liste der gültigen Zwei-Faktor-Tokenanbieter für den angegebenen userals asynchronen Vorgang ab.
HasPasswordAsync(TUser)	Ruft ein Flag ab, das angibt, ob die angegebene user über ein Kennwort verfügt.
IsEmailConfirmedAsync(TUser)	Ruft ein Flag ab, das angibt, ob die E-Mail-Adresse für die angegebene user überprüft wurde, true, wenn die E-Mail-Adresse andernfalls false überprüft wurde.
IsInRoleAsync(TUser, String)	Gibt ein Flag zurück, das angibt, ob das angegebene user mitglied der angegebenen benannten Rolle ist.
IsLockedOutAsync(TUser)	Gibt ein Flag zurück, das angibt, ob der angegebene user als asynchroner Vorgang gesperrt ist.
IsPhoneNumberConfirmedAsync(TUser)	Ruft ein Flag ab, das angibt, ob die angegebene userTelefonnummer bestätigt wurde.
NormalizeEmail(String)	Normalisieren Sie E-Mails für konsistente Vergleiche.
NormalizeName(String)	Normalisieren Sie den Benutzer- oder Rollennamen für konsistente Vergleiche.
RedeemTwoFactorRecoveryCodeAsync(TUser, String)	Gibt zurück, ob ein Wiederherstellungscode für einen Benutzer gültig ist. Hinweis: Wiederherstellungscodes sind nur einmal gültig und nach der Verwendung ungültig.
RegisterTokenProvider(String, IUserTwoFactorTokenProvider<TUser>)	Registriert einen Tokenanbieter.
RemoveAuthenticationTokenAsync(TUser, String, String)	Entfernen Sie ein Authentifizierungstoken für einen Benutzer.
RemoveClaimAsync(TUser, Claim)	Entfernt das angegebene claim aus dem angegebenen user.
RemoveClaimsAsync(TUser, IEnumerable<Claim>)	Entfernt das angegebene claims aus dem angegebenen user.
RemoveFromRoleAsync(TUser, String)	Entfernt die angegebene user aus der benannten Rolle.
RemoveFromRolesAsync(TUser, IEnumerable<String>)	Entfernt die angegebenen user aus den benannten Rollen.
RemoveLoginAsync(TUser, String, String)	Versucht, die bereitgestellten externen Anmeldeinformationen aus dem angegebenen userzu entfernen. und gibt ein Flag zurück, das angibt, ob die Entfernung erfolgreich war oder nicht.
RemovePasswordAsync(TUser)	Entfernt das Kennwort eines Benutzers.
ReplaceClaimAsync(TUser, Claim, Claim)	Ersetzt die angegebene claim für die angegebene user durch die newClaim
ResetAccessFailedCountAsync(TUser)	Setzt die Anzahl der Zugriffsfehler für den angegebenen userzurück.
ResetAuthenticatorKeyAsync(TUser)	Setzt den Authentifikatorschlüssel für den Benutzer zurück.
ResetPasswordAsync(TUser, String, String)	Setzt das Kennwort des userKennworts auf das angegebene newPassword zurück, nachdem die angegebene Kennwortzurücksetzung tokenüberprüft wurde.
SetAuthenticationTokenAsync(TUser, String, String, String)	Legt ein Authentifizierungstoken für einen Benutzer fest.
SetEmailAsync(TUser, String)	Legt die email Adresse für ein fest user.
SetLockoutEnabledAsync(TUser, Boolean)	Legt ein Flag fest, das angibt, ob der angegebene user als asynchroner Vorgang gesperrt ist.
SetLockoutEndDateAsync(TUser, Nullable<DateTimeOffset>)	Sperrt einen Benutzer, bis das angegebene Enddatum abgelaufen ist. Wenn Sie ein Enddatum in der Vergangenheit festlegen, wird ein Benutzer sofort entsperrt.
SetPhoneNumberAsync(TUser, String)	Legt die Telefonnummer für den angegebenen userfest.
SetTwoFactorEnabledAsync(TUser, Boolean)	Legt ein Flag fest, das angibt, ob für die angegebene user Zwei-Faktor-Authentifizierung als asynchroner Vorgang aktiviert ist oder nicht.
SetUserNameAsync(TUser, String)	Legt das für userName den angegebenen userfest.
ThrowIfDisposed()	Löst aus, wenn diese Klasse verworfen wurde.
UpdateAsync(TUser)	Updates den im Sicherungsspeicher angegebenen user wert.
UpdateNormalizedEmailAsync(TUser)	Updates die normalisierte E-Mail für die angegebene user.
UpdateNormalizedUserNameAsync(TUser)	Updates den normalisierten Benutzernamen für den angegebenen user.
UpdatePasswordHash(TUser, String, Boolean)	Updates den Kennworthash eines Benutzers.
UpdateSecurityStampAsync(TUser)	Generiert den Sicherheitsstempel für den angegebenen user.
UpdateUserAsync(TUser)	Wird aufgerufen, um den Benutzer nach dem Überprüfen und Aktualisieren der normalisierten E-Mail/des Benutzernamens zu aktualisieren.
ValidatePasswordAsync(TUser, String)	Sollte zurückgegeben werden Success , wenn die Überprüfung erfolgreich war. Dies wird vor dem Aktualisieren des Kennworthashs aufgerufen.
ValidateUserAsync(TUser)	Sollte zurückgegeben werden Success , wenn die Überprüfung erfolgreich war. Dies wird aufgerufen, bevor der Benutzer über Create oder Update gespeichert wird.
VerifyChangePhoneNumberTokenAsync(TUser, String, String)	Gibt ein Flag zurück, das angibt, ob das angegebene userÜberprüfungstoken für die phoneNumberTelefonnummernänderung gültig ist.
VerifyPasswordAsync(IUserPasswordStore<TUser>, TUser, String)	Gibt ein PasswordVerificationResult zurück, das das Ergebnis eines Kennworthashvergleichs angibt.
VerifyTwoFactorTokenAsync(TUser, String, String)	Überprüft die angegebene zweistufige Authentifizierung token mit dem user.
VerifyUserTokenAsync(TUser, String, String, String)	Gibt ein Flag zurück, das angibt, ob das angegebene token für die angegebene user und purposegültig ist.