Freigeben über


UserManager<TUser> Klasse

Definition

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

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>.

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 Kennwortzurücksetzungsmethoden verwendet wird.

Eigenschaften

CancellationToken

Das Abbruchtoken, das zum Abbrechen von Vorgängen verwendet wird.

ErrorDescriber

Die IdentityErrorDescriber verwendet, um Fehlermeldungen zu generieren.

KeyNormalizer

Die ILookupNormalizer verwendet, um Elemente wie Benutzer- und Rollennamen zu normalisieren.

Logger

Die ILogger verwendet, um Nachrichten vom Vorgesetzten zu protokollieren.

Options

Die zum Konfigurieren der Identität verwendete IdentityOptions.

PasswordHasher

Die zum Hashen von Kennwörtern verwendete IPasswordHasher<TUser>.

PasswordValidators

Die zum Überprüfen von Kennwörtern verwendete IPasswordValidator<TUser>.

Store

Dient zum Abrufen oder Festlegen des Persistenzspeichers, über den der Manager ausgeführt wird.

SupportsQueryableUsers

Ruft ein Flag ab, das angibt, ob der zugrunde stehenden Benutzerspeicher die Rückgabe von IQueryable Auflistungen von Informationen unterstützt.

SupportsUserAuthenticationTokens

Ruft ein Flag ab, das angibt, ob der sicherungsbasierte Benutzerspeicher Authentifizierungstoken unterstützt.

SupportsUserAuthenticatorKey

Ruft ein Flag ab, das angibt, ob der zugrunde stehenden Benutzerspeicher einen Benutzerauthentifikator unterstützt.

SupportsUserClaim

Ruft ein Flag ab, das angibt, ob der sicherungsbasierte Benutzerspeicher Benutzeransprüche unterstützt.

SupportsUserEmail

Ruft ein Flag ab, das angibt, ob der zugrunde stehenden Benutzerspeicher Benutzer-E-Mails unterstützt.

SupportsUserLockout

Ruft ein Flag ab, das angibt, ob der sicherungsbasierte Benutzerspeicher Benutzersperrungen unterstützt.

SupportsUserLogin

Ruft ein Flag ab, das angibt, ob der zugrunde stehenden Benutzerspeicher externe Anmeldungen unterstützt.

SupportsUserPassword

Ruft ein Flag ab, das angibt, ob der sicherungsnde Benutzerspeicher Benutzerwörter unterstützt.

SupportsUserPhoneNumber

Ruft ein Flag ab, das angibt, ob der sicherungsgebundene Benutzerspeicher Benutzertelefonnummern unterstützt.

SupportsUserRole

Ruft ein Flag ab, das angibt, ob der sicherungsnde Benutzerspeicher Benutzerrollen unterstützt.

SupportsUserSecurityStamp

Ruft ein Flag ab, das angibt, ob der sicherungsbezogene Benutzerspeicher Sicherheitsstempel unterstützt.

SupportsUserTwoFactor

Ruft ein Flag ab, das angibt, ob der sicherungsbasierte Benutzerspeicher die zweistufige Authentifizierung unterstützt.

SupportsUserTwoFactorRecoveryCodes

Ruft ein Flag ab, das angibt, ob der zugrunde stehenden Benutzerspeicher Wiederherstellungscodes unterstützt.

Users

Gibt eine IQueryable von Benutzern zurück, wenn der Speicher ein IQueryableUserStore ist.

UserValidators

Die IUserValidator<TUser> verwendet, um Benutzer zu überprüfen.

Methoden

AccessFailedAsync(TUser)

Erhöht die Anzahl des Zugriffsfehlers für den Benutzer als asynchronen Vorgang. Wenn das Konto für den fehlgeschlagenen Zugriff größer oder gleich der konfigurierten maximalen Anzahl von Versuchen ist, wird der Benutzer für die konfigurierte Sperrzeitspanne gesperrt.

AddClaimAsync(TUser, Claim)

Fügt der userdie angegebene claim hinzu.

AddClaimsAsync(TUser, IEnumerable<Claim>)

Fügt der userdie angegebene claims hinzu.

AddLoginAsync(TUser, UserLoginInfo)

Fügt der angegebenen usereine externe UserLoginInfo hinzu.

AddPasswordAsync(TUser, String)

Fügt die password nur dann zur angegebenen user hinzu, wenn der Benutzer noch kein Kennwort besitzt.

AddToRoleAsync(TUser, String)

Fügen Sie der benannten Rolle die angegebene user hinzu.

AddToRolesAsync(TUser, IEnumerable<String>)

Fügen Sie die angegebene user zu den benannten Rollen hinzu.

ChangeEmailAsync(TUser, String, String)

Aktualisiert benutzer-E-Mails, 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 die 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 Kennzeichen zurück, das angibt, ob die angegebene password für die angegebene 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 angegebene user im Sicherungsspeicher ohne Kennwort als asynchronen Vorgang.

CreateAsync(TUser, String)

Erstellt die angegebene user im Sicherungsspeicher mit angegebenem 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 vom Benutzer-Manager verwendeten Ressourcen frei.

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 (falls vorhanden) ab, der dem normalisierten Wert der angegebenen E-Mail-Adresse zugeordnet ist. Hinweis: Es wird empfohlen, dass identityOptions.User.RequireUniqueEmail bei Verwendung dieser Methode auf "true" festgelegt wird, andernfalls kann der Speicher ausgelöst werden, wenn Benutzer mit doppelten E-Mails vorhanden sind.

FindByIdAsync(String)

Sucht und gibt einen Benutzer( falls vorhanden) zurück, der die angegebene userIdhat.

FindByLoginAsync(String, String)

Ruft den Benutzer ab, der dem angegebenen externen Anmeldeanbieter und dem Anmeldeanbieterschlüssel zugeordnet ist.

FindByNameAsync(String)

Sucht und gibt einen Benutzer( falls vorhanden) zurück, der den angegebenen Benutzernamen hat.

GenerateChangeEmailTokenAsync(TUser, String)

Generiert ein E-Mail-Änderungstoken für den angegebenen Benutzer.

GenerateChangePhoneNumberTokenAsync(TUser, String)

Generiert ein Änderungstoken für telefonnummern für den angegebenen Benutzer.

GenerateConcurrencyStampAsync(TUser)

Generiert einen Wert, der für die Verwendung in der Parallelitätsnachverfolgung geeignet ist.

GenerateEmailConfirmationTokenAsync(TUser)

Generiert ein E-Mail-Bestätigungstoken für den angegebenen Benutzer.

GenerateNewAuthenticatorKey()

Generiert einen neuen base32-codierten 160-Bit-Sicherheitsschlüssel (Größe von SHA1-Hash).

GenerateNewTwoFactorRecoveryCodesAsync(TUser, Int32)

Generiert Wiederherstellungscodes für den Benutzer. Dadurch werden alle vorherigen Wiederherstellungscodes für den Benutzer ungültig.

GeneratePasswordResetTokenAsync(TUser)

Generiert ein Kennwortzurücksetzungstoken für die angegebene usermithilfe des konfigurierten Tokenanbieters für die Kennwortzurücksetzung.

GenerateTwoFactorTokenAsync(TUser, String)

Ruft ein zweistufiges Authentifizierungstoken für die angegebene userab.

GenerateUserTokenAsync(TUser, String, String)

Generiert ein Token für die angegebene user und purpose.

GetAccessFailedCountAsync(TUser)

Ruft die aktuelle Anzahl der fehlgeschlagenen Zugriffe für die angegebene userab.

GetAuthenticationTokenAsync(TUser, String, String)

Gibt ein Authentifizierungstoken für einen Benutzer zurück.

GetAuthenticatorKeyAsync(TUser)

Gibt den Authentifizierungsschlüssel für den Benutzer zurück.

GetChangeEmailTokenPurpose(String)

Generiert den Tokenzweck, der zum Ändern von E-Mails verwendet wird.

GetClaimsAsync(TUser)

Ruft eine Liste der Claims ab, die zur angegebenen user als asynchroner Vorgang 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 Benutzersperrung für den angegebenen Benutzer aktiviert werden kann.

GetLockoutEndDateAsync(TUser)

Ruft die letzte DateTimeOffset die letzte Sperrung eines Benutzers abgelaufen ist, falls vorhanden. Ein Zeitwert in der Vergangenheit gibt an, dass ein Benutzer zurzeit nicht gesperrt ist.

GetLoginsAsync(TUser)

Ruft die zugeordneten Anmeldungen für das angegebene .

GetPhoneNumberAsync(TUser)

Ruft die Telefonnummer (falls vorhanden) für die angegebene userab.

GetRolesAsync(TUser)

Ruft eine Liste der Rollennamen ab, zu der die angegebene user gehört.

GetSecurityStampAsync(TUser)

Rufen Sie den Sicherheitsstempel für die angegebene userab.

GetTwoFactorEnabledAsync(TUser)

Gibt ein Flag zurück, das angibt, ob die angegebene user die zweistufige Authentifizierung aktiviert hat oder nicht, als asynchroner Vorgang.

GetUserAsync(ClaimsPrincipal)

Gibt den Benutzer zurück, der dem Anspruch IdentityOptions.ClaimsIdentity.UserIdClaimType im Prinzipal oder null entspricht.

GetUserId(ClaimsPrincipal)

Gibt den Anspruchswert der Benutzer-ID zurück, wenn vorhanden andernfalls NULL zurückgegeben wird.

GetUserIdAsync(TUser)

Ruft den Benutzerbezeichner für die angegebene userab.

GetUserName(ClaimsPrincipal)

Gibt den Wert des Namensanspruchs zurück, wenn vorhanden andernfalls NULL zurückgegeben wird.

GetUserNameAsync(TUser)

Ruft den Benutzernamen für die angegebene userab.

GetUsersForClaimAsync(Claim)

Gibt eine Liste von Benutzern aus dem Benutzerspeicher zurück, die über die angegebene claimverfügen.

GetUsersInRoleAsync(String)

Gibt eine Liste von Benutzern aus dem Benutzerspeicher zurück, die Mitglieder der angegebenen roleNamesind.

GetValidTwoFactorProvidersAsync(TUser)

Ruft eine Liste der gültigen zweistufigen Tokenanbieter für die angegebene 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 falsch überprüft wird.

IsInRoleAsync(TUser, String)

Gibt ein Flag zurück, das angibt, ob die angegebene user ein Mitglied der angegebenen benannten Rolle ist.

IsLockedOutAsync(TUser)

Gibt ein Flag zurück, das angibt, ob die angegebene user gesperrt ist, als asynchroner Vorgang.

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.

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 werden nach der Verwendung ungültig.

RegisterTokenProvider(String, IUserTwoFactorTokenProvider<TUser>)

Registriert einen Tokenanbieter.

RemoveAuthenticationTokenAsync(TUser, String, String)

Entfernen Eines Authentifizierungstokens für einen Benutzer.

RemoveClaimAsync(TUser, Claim)

Entfernt den angegebenen claim aus dem angegebenen user.

RemoveClaimsAsync(TUser, IEnumerable<Claim>)

Entfernt den angegebenen claims aus dem angegebenen user.

RemoveFromRoleAsync(TUser, String)

Entfernt die angegebene user aus der benannten Rolle.

RemoveFromRolesAsync(TUser, IEnumerable<String>)

Entfernt die angegebene user aus den benannten Rollen.

RemoveLoginAsync(TUser, String, String)

Versucht, die bereitgestellten externen Anmeldeinformationen aus dem angegebenen userzu entfernen. und gibt ein Kennzeichen zurück, das angibt, ob die Entfernung erfolgreich war oder nicht.

RemovePasswordAsync(TUser)

Entfernt das Kennwort eines Benutzers.

RemovePasswordAsync(TUser, CancellationToken)

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 des Zugriffsfehlers für die angegebene userzurück.

ResetAuthenticatorKeyAsync(TUser)

Setzt den Authentifizierungsschlüssel für den Benutzer zurück.

ResetPasswordAsync(TUser, String, String)

Setzt das Kennwort des userauf die 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 eine userfest.

SetLockoutEnabledAsync(TUser, Boolean)

Legt ein Flag fest, das angibt, ob die angegebene user als asynchroner Vorgang gesperrt werden kann.

SetLockoutEndDateAsync(TUser, Nullable<DateTimeOffset>)

Sperrt einen Benutzer, bis das angegebene Enddatum überschritten wurde. Durch das Festlegen eines Enddatums in der Vergangenheit wird ein Benutzer sofort entsperrt.

SetPhoneNumberAsync(TUser, String)

Legt die Telefonnummer für die angegebene userfest.

SetTwoFactorEnabledAsync(TUser, Boolean)

Legt ein Flag fest, das angibt, ob die angegebene user die zweistufige Authentifizierung aktiviert hat oder nicht, als asynchroner Vorgang.

SetUserNameAsync(TUser, String)

Legt die angegebene userName für die angegebene userfest.

ThrowIfDisposed()

Löst aus, wenn diese Klasse verworfen wurde.

UpdateAsync(TUser)

Aktualisiert die angegebene user im Sicherungsspeicher.

UpdateNormalizedEmailAsync(TUser)

Aktualisiert die normalisierte E-Mail für die angegebene user.

UpdateNormalizedUserNameAsync(TUser)

Aktualisiert den normalisierten Benutzernamen für die angegebene user.

UpdatePasswordHash(TUser, String, Boolean)

Aktualisiert den Kennworthash eines Benutzers.

UpdateSecurityStampAsync(TUser)

Generiert den Sicherheitsstempel für die angegebene user.

UpdateUserAsync(TUser)

Wird aufgerufen, um den Benutzer nach der Überprüfung und Aktualisierung des normalisierten E-Mail-/Benutzernamens zu aktualisieren.

ValidatePasswordAsync(TUser, String)

Sollte Success zurückgegeben werden, wenn die Überprüfung erfolgreich ist. Dies wird vor dem Aktualisieren des Kennworthashs aufgerufen.

ValidateUserAsync(TUser)

Sollte Success zurückgegeben werden, wenn die Überprüfung erfolgreich ist. Dies wird aufgerufen, bevor der Benutzer über "Erstellen" oder "Aktualisieren" gespeichert wird.

VerifyChangePhoneNumberTokenAsync(TUser, String, String)

Gibt ein Kennzeichen zurück, das angibt, ob das angegebene userÜberprüfungstoken für die angegebene phoneNumbergültig ist.

VerifyPasswordAsync(IUserPasswordStore<TUser>, TUser, String)

Gibt einen PasswordVerificationResult zurück, der das Ergebnis eines Kennworthashvergleichs angibt.

VerifyTwoFactorTokenAsync(TUser, String, String)

Überprüft die angegebene zweistufige Authentifizierung token für die user.

VerifyUserTokenAsync(TUser, String, String, String)

Gibt ein Flag zurück, das angibt, ob die angegebene token für die angegebene user und purposegültig ist.

Gilt für: