UserManager<TUser> Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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
-
UserManager<TUser>
- Abgeleitet
- Implementiert
Konstruktoren
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 |
AddClaimsAsync(TUser, IEnumerable<Claim>) |
Fügt dem |
AddLoginAsync(TUser, UserLoginInfo) |
Fügt dem angegebenen |
AddPasswordAsync(TUser, String) |
Fügt dem |
AddToRoleAsync(TUser, String) |
Fügen Sie der benannten Rolle das angegebene |
AddToRolesAsync(TUser, IEnumerable<String>) |
Fügen Sie den benannten Rollen das angegebene |
ChangeEmailAsync(TUser, String, String) |
Updates ein Benutzer eine E-Mail an, wenn die angegebene E-Mail-Änderung |
ChangePasswordAsync(TUser, String, String) |
Ändert das Kennwort eines Benutzers, nachdem bestätigt wurde, dass das angegebene |
ChangePhoneNumberAsync(TUser, String, String) |
Legt die Telefonnummer für die angegebene |
CheckPasswordAsync(TUser, String) |
Gibt ein Flag zurück, das angibt, ob das angegebene |
ConfirmEmailAsync(TUser, String) |
Überprüft, ob ein E-Mail-Bestätigungstoken mit dem angegebenen |
CountRecoveryCodesAsync(TUser) |
Gibt zurück, wie viele Wiederherstellungscode für einen Benutzer noch gültig sind. |
CreateAsync(TUser) |
Erstellt die im Sicherungsspeicher angegebene |
CreateAsync(TUser, String) |
Erstellt die im Sicherungsspeicher angegebene |
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 |
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 |
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 |
GenerateTwoFactorTokenAsync(TUser, String) |
Ruft ein zweistufiges Authentifizierungstoken für das angegebene |
GenerateUserTokenAsync(TUser, String, String) |
Generiert ein Token für die angegebene |
GetAccessFailedCountAsync(TUser) |
Ruft die aktuelle Anzahl fehlerhafter Zugriffe für den angegebenen |
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 |
GetEmailAsync(TUser) |
Ruft die E-Mail-Adresse für die angegebene |
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 |
GetRolesAsync(TUser) |
Ruft eine Liste von Rollennamen ab, zu der der angegebene |
GetSecurityStampAsync(TUser) |
Rufen Sie den Sicherheitsstempel für den angegebenen |
GetTwoFactorEnabledAsync(TUser) |
Gibt ein Flag zurück, das angibt, ob für die angegebene |
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 |
GetUserName(ClaimsPrincipal) |
Gibt den Name-Anspruchswert zurück, falls vorhanden andernfalls NULL zurückgegeben wird. |
GetUserNameAsync(TUser) |
Ruft den Benutzernamen für den angegebenen |
GetUsersForClaimAsync(Claim) |
Gibt eine Liste der Benutzer aus dem Benutzerspeicher zurück, die über den angegebenen |
GetUsersInRoleAsync(String) |
Gibt eine Liste der Benutzer aus dem Benutzerspeicher zurück, die Mitglieder des angegebenen |
GetValidTwoFactorProvidersAsync(TUser) |
Ruft eine Liste der gültigen Zwei-Faktor-Tokenanbieter für den angegebenen |
HasPasswordAsync(TUser) |
Ruft ein Flag ab, das angibt, ob die angegebene |
IsEmailConfirmedAsync(TUser) |
Ruft ein Flag ab, das angibt, ob die E-Mail-Adresse für die angegebene |
IsInRoleAsync(TUser, String) |
Gibt ein Flag zurück, das angibt, ob das angegebene |
IsLockedOutAsync(TUser) |
Gibt ein Flag zurück, das angibt, ob der angegebene |
IsPhoneNumberConfirmedAsync(TUser) |
Ruft ein Flag ab, das angibt, ob die angegebene |
NormalizeEmail(String) |
Normalisieren Sie E-Mails für konsistente Vergleiche. |
NormalizeKey(String) |
Normalisieren Sie einen Schlüssel (Benutzername, E-Mail) 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 |
RemoveClaimsAsync(TUser, IEnumerable<Claim>) |
Entfernt das angegebene |
RemoveFromRoleAsync(TUser, String) |
Entfernt die angegebene |
RemoveFromRolesAsync(TUser, IEnumerable<String>) |
Entfernt die angegebenen |
RemoveLoginAsync(TUser, String, String) |
Versucht, die bereitgestellten externen Anmeldeinformationen aus dem angegebenen |
RemovePasswordAsync(TUser) |
Entfernt das Kennwort eines Benutzers. |
RemovePasswordAsync(TUser, CancellationToken) |
Entfernt das Kennwort eines Benutzers. |
ReplaceClaimAsync(TUser, Claim, Claim) |
Ersetzt die angegebene |
ResetAccessFailedCountAsync(TUser) |
Setzt die Anzahl der Zugriffsfehler für den angegebenen |
ResetAuthenticatorKeyAsync(TUser) |
Setzt den Authentifikatorschlüssel für den Benutzer zurück. |
ResetPasswordAsync(TUser, String, String) |
Setzt das Kennwort des |
SetAuthenticationTokenAsync(TUser, String, String, String) |
Legt ein Authentifizierungstoken für einen Benutzer fest. |
SetEmailAsync(TUser, String) |
Legt die |
SetLockoutEnabledAsync(TUser, Boolean) |
Legt ein Flag fest, das angibt, ob der angegebene |
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 |
SetTwoFactorEnabledAsync(TUser, Boolean) |
Legt ein Flag fest, das angibt, ob für die angegebene |
SetUserNameAsync(TUser, String) |
Legt das für |
ThrowIfDisposed() |
Löst aus, wenn diese Klasse verworfen wurde. |
UpdateAsync(TUser) |
Updates den im Sicherungsspeicher angegebenen |
UpdateNormalizedEmailAsync(TUser) |
Updates die normalisierte E-Mail für die angegebene |
UpdateNormalizedUserNameAsync(TUser) |
Updates den normalisierten Benutzernamen für den angegebenen |
UpdatePasswordHash(TUser, String, Boolean) |
Updates den Kennworthash eines Benutzers. |
UpdateSecurityStampAsync(TUser) |
Generiert den Sicherheitsstempel für den angegebenen |
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 |
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 |
VerifyUserTokenAsync(TUser, String, String, String) |
Gibt ein Flag zurück, das angibt, ob das angegebene |
Gilt für:
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für