PasswordRecovery.VerifyingUser イベント
アセンブリ: System.Web (system.web.dll 内)
構文Dim instance As PasswordRecovery Dim handler As LoginCancelEventHandler AddHandler instance.VerifyingUser, handler
public: event LoginCancelEventHandler^ VerifyingUser { void add (LoginCancelEventHandler^ value); void remove (LoginCancelEventHandler^ value); }
解説VerifyingUser イベントは、ユーザー名が有効かどうかを確認するためにメンバシップ プロバイダに送信される前に、サーバー上で発生します。このイベントを使用して、ユーザー名に対して必要なプリプロセス (ユーザー名をすべて英大文字または英小文字に変換する、ユーザー名が電子メール アドレスなどの特定の形式であるかどうかを確認するなど) を実行します。
PasswordRecovery コントロールは、VerifyingUser イベントを発生させた後、MembershipProvider プロパティで指定されたメンバシップ プロバイダを使用して、入力されたユーザー名が Web サイトの有効なユーザー名かどうかを確認します。ユーザー名が有効であり、メンバシップ プロバイダがパスワードの質問と解答をサポートしている場合は、パスワード確認の質問が Web サイトから返され、PasswordRecovery コントロールに質問ビューが表示されます。ユーザー名が有効ではない場合は、GeneralFailureText プロパティのテキストがユーザー名ビューに表示され、ユーザーが別のユーザー名を入力できるようになります。
メンバシップ プロバイダがパスワードの質問と解答をサポートしていない場合は、SendingMail イベントが発生し、新しいパスワードまたは回復されたパスワードが含まれる電子メールがユーザーに送信されます。
使用例VerifyingUser イベントを使用して、送信されたユーザー名が有効な電子メール アドレスとして書式設定されているかどうかを調べるコード例を次に示します。ユーザー名が適切に書式設定されていない場合、UserNameInstructionText プロパティが変更され、エラーが表示されます。
<%@ page language="VB" %> <script runat="server"> Function IsValidEmail(ByVal strIn As String) As Boolean ' Return true if strIn is in valid e-mail 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 e-mail address." e.Cancel = True Else PasswordRecovery1.UserNameInstructionText = "Enter your User Name to receive your password." End If End Sub </script> <html> <body> <form runat="server"> <asp:passwordrecovery id="PasswordRecovery1" runat="server" onverifyinguser="PasswordRecovery1_VerifyingUser"> </asp:passwordrecovery> </form> </body> </html>
<%@ page language="C#" %> <script runat="server"> bool IsValidEmail(string strIn) { // Return true if strIn is in valid e-mail 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 e-mail address."; e.Cancel = true; } else { PasswordRecovery1.UserNameInstructionText = "Enter your User Name to receive your password."; } } </script> <html> <body> <form runat="server"> <asp:passwordrecovery id="PasswordRecovery1" runat="server" onverifyinguser="PasswordRecovery1_VerifyingUser"> </asp:passwordrecovery> </form> </body> </html>
プラットフォームWindows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報参照- PasswordRecovery.VerifyingUser イベントのページへのリンク
