MembershipProvider.ResetPassword(String, String) Methode
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.
Setzt das Kennwort eines Benutzers auf ein neues, automatisch generiertes Kennwort zurück.
public:
abstract System::String ^ ResetPassword(System::String ^ username, System::String ^ answer);
public abstract string ResetPassword (string username, string answer);
abstract member ResetPassword : string * string -> string
Public MustOverride Function ResetPassword (username As String, answer As String) As String
Parameter
- username
- String
Der Benutzer, für den das Kennwort zurückgesetzt werden soll.
- answer
- String
Die Kennwortantwort für den angegebenen Benutzer.
Gibt zurück
Das neue Kennwort für den angegebenen Benutzer.
Beispiele
Ein Beispiel für eine MembershipProvider Implementierung finden Sie unter Implementieren eines Profilanbieters.
Hinweise
Verwendet als Eingabe einen Benutzernamen und eine Kennwortantwort und generiert ein neues, zufälliges Kennwort für den angegebenen Benutzer.
Hinweis
Das von der ResetPassword -Methode erstellte zufällige Kennwort übergibt nicht garantiert den regulären Ausdruck in der PasswordStrengthRegularExpression -Eigenschaft. Das zufällige Kennwort erfüllt jedoch die Kriterien, die durch die MinRequiredPasswordLength Eigenschaften und MinRequiredNonAlphanumericCharacters festgelegt wurden.
Die ResetPassword -Methode aktualisiert die Benutzerinformationen in der Datenquelle mit dem neuen Kennwortwert und gibt das neue Kennwort als Zeichenfolge zurück. Ein praktischer Mechanismus zum Generieren eines zufälligen Kennworts ist die GeneratePassword -Methode.
ResetPassword stellt sicher, dass das EnablePasswordReset Flag auf true
festgelegt ist, bevor eine Aktion ausgeführt wird. Wenn EnablePasswordReset ist false
, wird eine NotSupportedException Ausnahme ausgelöst.
ResetPassword überprüft auch den Wert der RequiresQuestionAndAnswer Eigenschaft. Wenn RequiresQuestionAndAnswer ist true
, ResetPassword überprüft den Wert des angegebenen Antwortparameters mit der gespeicherten Kennwortantwort in der Datenquelle. Wenn sie nicht übereinstimmen, wird eine MembershipPasswordException Ausnahme ausgelöst.