UserManager<TUser> Klasse

Referenz

Definition

Namespace:: Microsoft.AspNetCore.Identity

Assembly:: Microsoft.AspNetCore.Identity.dll

Assembly:: Microsoft.Extensions.Identity.Core.dll

Paket:: Microsoft.AspNetCore.Identity v1.0.0

Paket:: Microsoft.AspNetCore.Identity v1.1.0

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

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

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

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

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

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

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

Paket:: Microsoft.Extensions.Identity.Core v7.0.5

Paket:: Microsoft.Extensions.Identity.Core v8.0.0

Paket:: Microsoft.Extensions.Identity.Core v9.0.0-preview.6.24328.4

Quelle:: UserManager.cs

Quelle:: UserManager.cs

Quelle:: UserManager.cs

Quelle:: UserManager.cs

Quelle:: UserManager.cs

Quelle:: UserManager.cs

Quelle:: UserManager.cs

Quelle:: UserManager.cs

Quelle:: UserManager.cs

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: 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>.
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 `user`die angegebene `claim` hinzu.
AddClaimsAsync(TUser, IEnumerable<Claim>)	Fügt der `user`die angegebene `claims` hinzu.
AddLoginAsync(TUser, UserLoginInfo)	Fügt der angegebenen `user`eine 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 `user`gü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 `userId`hat.
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 `user`mithilfe des konfigurierten Tokenanbieters für die Kennwortzurücksetzung.
GenerateTwoFactorTokenAsync(TUser, String)	Ruft ein zweistufiges Authentifizierungstoken für die angegebene `user`ab.
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 `user`ab.
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 `user`ab.
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 `user`ab.
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 `user`ab.
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 `user`ab.
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 `user`ab.
GetUsersForClaimAsync(Claim)	Gibt eine Liste von Benutzern aus dem Benutzerspeicher zurück, die über die angegebene `claim`verfügen.
GetUsersInRoleAsync(String)	Gibt eine Liste von Benutzern aus dem Benutzerspeicher zurück, die Mitglieder der angegebenen `roleName`sind.
GetValidTwoFactorProvidersAsync(TUser)	Ruft eine Liste der gültigen zweistufigen Tokenanbieter für die angegebene `user`als 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 `user`Telefonnummer 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 `user`zu 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 `user`zurück.
ResetAuthenticatorKeyAsync(TUser)	Setzt den Authentifizierungsschlüssel für den Benutzer zurück.
ResetPasswordAsync(TUser, String, String)	Setzt das Kennwort des `user`auf 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 `user`fest.
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 `user`fest.
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 `user`fest.
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 `phoneNumber`gü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 `purpose`gültig ist.

Gilt für:

Freigeben über