PasswordRecovery.VerifyingUser Ereignis
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.
Tritt ein, bevor der Benutzername vom Mitgliedschaftsanbieter überprüft wird.
public:
event System::Web::UI::WebControls::LoginCancelEventHandler ^ VerifyingUser;public event System.Web.UI.WebControls.LoginCancelEventHandler VerifyingUser;member this.VerifyingUser : System.Web.UI.WebControls.LoginCancelEventHandler Public Custom Event VerifyingUser As LoginCancelEventHandler Ereignistyp
Beispiele
Im folgenden Codebeispiel wird das VerifyingUser -Ereignis verwendet, um zu überprüfen, ob der übermittelte Benutzername als gültige E-Mail-Adresse formatiert ist. Wenn der Benutzername nicht ordnungsgemäß formatiert ist, wird die UserNameInstructionText -Eigenschaft geändert, um den Fehler anzuzeigen.
<%@ page language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
bool IsValidEmail(string strIn)
{
// Return true if strIn is in valid email format.
return Regex.IsMatch(strIn, @"^([\w-\.]+)@((\[[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.)|(([\w-]+\.)+))([a-zA-Z]{2,4}|[0-9]{1,3})(\]?)$");
}
void PasswordRecovery1_VerifyingUser(object sender, System.Web.UI.WebControls.LoginCancelEventArgs e)
{
if (!IsValidEmail(PasswordRecovery1.UserName))
{
PasswordRecovery1.UserNameInstructionText = "You must enter a valid email address.";
e.Cancel = true;
}
else
{
PasswordRecovery1.UserNameInstructionText = "Enter your User Name to receive your password.";
}
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>ASP.NET Example</title>
</head>
<body>
<form id="form1" runat="server">
<asp:passwordrecovery id="PasswordRecovery1"
runat="server"
onverifyinguser="PasswordRecovery1_VerifyingUser">
</asp:passwordrecovery>
</form>
</body>
</html>
<%@ page language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
Function IsValidEmail(ByVal strIn As String) As Boolean
' Return true if strIn is in valid email format.
Return Regex.IsMatch(strIn, ("^([\w-\.]+)@((\[[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.)|(([\w-]+\.)+))([a-zA-Z]{2,4}|[0-9]{1,3})(\]?)$"))
End Function
Sub PasswordRecovery1_VerifyingUser(ByVal sender As Object, ByVal e As System.Web.UI.WebControls.LoginCancelEventArgs)
If Not IsValidEmail(PasswordRecovery1.UserName) Then
PasswordRecovery1.UserNameInstructionText = "You must enter a valid email address."
e.Cancel = True
Else
PasswordRecovery1.UserNameInstructionText = "Enter your User Name to receive your password."
End If
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>ASP.NET Example</title>
</head>
<body>
<form id="form1" runat="server">
<asp:passwordrecovery id="PasswordRecovery1"
runat="server"
onverifyinguser="PasswordRecovery1_VerifyingUser">
</asp:passwordrecovery>
</form>
</body>
</html>
Hinweise
Das VerifyingUser Ereignis wird auf dem Server ausgelöst, bevor der Benutzername an den Mitgliedschaftsanbieter übermittelt wird, um zu bestimmen, ob der Benutzername gültig ist. Verwenden Sie dieses Ereignis, um alle für den Benutzernamen erforderlichen Vorverarbeitungen durchzuführen, z. B. die Konvertierung in Groß- oder Kleinbuchstaben oder die Überprüfung, ob der Benutzername in einem bestimmten Format vorliegt, z. B. eine E-Mail-Adresse.
Das PasswordRecovery -Steuerelement löst zuerst das VerifyingUser -Ereignis aus und verwendet dann den in der MembershipProvider -Eigenschaft angegebenen Mitgliedschaftsanbieter, um zu bestimmen, ob der eingegebene Benutzername ein gültiger Benutzername für die Website ist. Wenn sie gültig ist und der Mitgliedschaftsanbieter die Kennwortfrage und -antwort unterstützt, wird die Frage zur Kennwortüberprüfung von der Website zurückgegeben, und das PasswordRecovery Steuerelement zeigt die Frageansicht an. Wenn der Benutzername ungültig ist, wird der Text in der GeneralFailureText Eigenschaft in der UserName-Ansicht angezeigt, sodass der Benutzer einen anderen Benutzernamen eingeben kann.
Wenn der Mitgliedschaftsanbieter keine Kennwortfrage und -antwort unterstützt, wird das SendingMail Ereignis ausgelöst und eine E-Mail mit dem neuen oder wiederhergestellten Kennwort an den Benutzer gesendet.
Weitere Informationen zur Behandlung von Ereignissen finden Sie unter behandeln und Auslösen von Ereignissen.
