PasswordRecovery イベント
パブリック イベント| 名前 | 説明 | |
|---|---|---|
.gif) | AnswerLookupError | パスワード回復用の確認質問に対してユーザーが誤った解答を入力した場合に発生します。 |
| | DataBinding | サーバー コントロールがデータ ソースに連結すると発生します。 ( Control から継承されます。) |
| | Disposed | サーバー コントロールがメモリから解放されると発生します。これは、ASP.NET ページが要求されている場合のサーバー コントロールの有効期間における最終段階です。 ( Control から継承されます。) |
| | Init | サーバー コントロールが初期化されると発生します。これは、サーバー コントロールの有効期間における最初の手順です。 ( Control から継承されます。) |
| | Load | サーバー コントロールが Page オブジェクトに読み込まれると発生します。 ( Control から継承されます。) |
| | PreRender | Control オブジェクトの読み込み後、表示を開始する前に発生します。 ( Control から継承されます。) |
| | SendingMail | パスワードが電子メールでユーザーに送信される前に発生します。 |
| | SendMailError | 電子メール メッセージを送信しようとしたときに、SMTP メール システムがエラーをスローした場合に発生します。 |
| | Unload | サーバー コントロールがメモリからアンロードされると発生します。 ( Control から継承されます。) |
| | UserLookupError | ユーザーが入力したユーザー名をメンバシップ プロバイダが検索できない場合に発生します。 |
| | VerifyingAnswer | パスワード回復用の確認質問への解答をユーザーが送信したときに発生します。 |
| | VerifyingUser | メンバシップ プロバイダがユーザー名を検証する前に発生します。 |
参照PasswordRecovery クラス
アセンブリ: System.Web (system.web.dll 内)
構文<BindableAttribute(False)> _ Public Class PasswordRecovery Inherits CompositeControl
[BindableAttribute(false)] public class PasswordRecovery : CompositeControl
BindableAttribute(false) public class PasswordRecovery extends CompositeControl
解説PasswordRecovery コントロールは、パスワードを忘れたユーザーを支援します。このコントロールによって、ユーザーは新しいパスワードまたはユーザー名に既に関連付けられているパスワードが含まれた電子メール メッセージを要求できます。
.gif) メモ |
|---|
| PasswordRecovery Web コントロールは、インターネット電子メール サービスを使用して、回復したパスワードまたは新しいパスワードをユーザーに送信します。電子メールでパスワードを送信する場合、セキュリティ上のリスクが伴います。これらのセキュリティ上のリスクがサイトの許容範囲かどうかを判断する必要があります。 |
ユーザーがパスワードを回復できるのは、MembershipProvider プロパティで定義されたメンバシップ プロバイダが、クリア テキストのパスワードまたは暗号化されたパスワードをサポートしている場合だけです。ハッシュされたパスワードを回復することはできないため、ハッシュされたパスワードを使用するサイトのユーザーは、パスワードのリセットだけを行うことができます。
| メモ |
|---|
| PasswordRecovery コントロールは、メンバシップ ユーザーが承認されていない場合 (MembershipUser.IsApproved が false に設定されている場合) は使用できますが、メンバシップ ユーザーがロックアウトされている場合 (MembershipUser.IsLockedOut が true に設定されている場合) には使用できません。 |
電子メール メッセージは、MailDefinition クラスを使用して送信されます。ユーザーに電子メールを送信できるようにするには、アプリケーションの Web.config ファイルでメール サーバーを構成する必要があります。MailDefinition プロパティでカスタム メッセージを設定することにより、ユーザーに送信する電子メールの内容を変更できます。
ビュー
PasswordRecovery コントロールには、次の 3 つの状態 (ビュー) があります。
PasswordRecovery コントロールは、MembershipProvider プロパティで定義されたメンバシップ プロバイダがパスワードの質問と解答をサポートしている場合にのみ、質問ビューを表示します。
PasswordRecovery コントロールの各スタイル プロパティと、各プロパティが影響を及ぼすビューを次の表に示します。
スタイルとテンプレート
さまざまなスタイル プロパティのセットを使用して、PasswordRecovery コントロールの外観をカスタマイズできます。コントロールの外観を完全に制御する必要がある場合は、3 つのビューにカスタム テンプレートを適用することもできます。QuestionTemplate、SuccessTemplate、UserNameTemplate の各プロパティを使用して、これらのビューのテンプレートを作成できます。ビューのテンプレートを定義した場合、PasswordRecovery のスタイル プロパティは無効になります。
PasswordRecovery コントロールのスタイル プロパティと、各スタイル プロパティが影響を及ぼす UI 要素を次の表に示します。各スタイルが適用されるプロパティの一覧については、個々のスタイル プロパティに関するドキュメントを参照してください。
| SubmitButtonStyle | |
| FailureTextStyle | |
| HyperLinkStyle | 他のページへのリンク |
| InstructionTextStyle | |
| LabelStyle | |
| TextBoxStyle | |
| TitleTextStyle | |
| SuccessTextStyle |
PasswordRecovery コントロールの各ビューに適用されるテンプレートのプロパティを次の表に示します。各テンプレートで設定する必要のあるコントロールの一覧については、各テンプレートのプロパティに関するドキュメントを参照してください。
PasswordRecovery コントロールがテンプレートでカスタマイズされていない場合は、PasswordRecovery コントロールの AccessKey プロパティが、コントロールの最初のテキスト ボックス、およびコントロールのすべてのテキスト ボックスに適用される TabIndex プロパティに適用されます。PasswordRecovery コントロールがテンプレートでカスタマイズされている場合には、AccessKey プロパティと TabIndex プロパティは無視されます。その場合は、各テンプレートの子コントロールの AccessKey プロパティと TabIndex プロパティを直接設定します。
Answer や Question など、テキスト ボックスで表される PasswordRecovery コントロールの各プロパティは、ページの有効期間のすべてのフェーズでアクセスできます。コントロールは、テキスト ボックスが発生させる TextChanged イベントによって、エンド ユーザーが加えた変更を検出します。
検証のグループ化
PasswordRecovery コントロールは、ページ上の他の入力コントロールが PasswordRecovery コントロールの検証の影響を受けないように、コントロールのすべての必須フィールド検証コントロールの検証グループを作成します。既定では、PasswordRecovery コントロールの ID プロパティが検証グループの名前として使用されます。たとえば、PasswordRecovery コントロールの ID が "PasswordRecovery1" である場合、検証グループの名前にも "PasswordRecovery1" が使用されます。PasswordRecovery コントロールを別の検証グループに参加させる場合は、そのコントロールのテンプレートを作成する必要があります。
このコントロールに既定でレンダリングされるマークアップは、Web Content Accessibility Guidelines (WCAG) 1.0 の優先度 1 ガイドラインなどのユーザー補助に関する標準に適合しない可能性があります。このコントロールのユーザー補助サポートの詳細については、「ASP.NET コントロールとユーザー補助」を参照してください。
使用例PasswordRecovery コントロールを使用するコード例を次に示します。
<%@ 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"> ' Set the field label background color if the user name is not found. Sub PasswordRecovery1_UserLookupError(ByVal sender As Object, ByVal e As System.EventArgs) PasswordRecovery1.LabelStyle.ForeColor = System.Drawing.Color.Red End Sub ' Reset the field label background color. Sub PasswordRecovery1_Load(ByVal sender As Object, ByVal e As System.EventArgs) PasswordRecovery1.LabelStyle.ForeColor = System.Drawing.Color.Black End Sub </SCRIPT> <HTML> <BODY> <FORM runat="server"> <asp:PasswordRecovery id="PasswordRecovery1" runat="server" BorderStyle="Solid" BorderWidth="1px" BackColor="#F7F7DE" Font-Size="10pt" Font-Names="Verdana" BorderColor="#CCCC99" HelpPageText="Need help?" HelpPageUrl=recoveryHelp.aspx onuserlookuperror="PasswordRecovery1_UserLookupError" onload="PasswordRecovery1_Load" > <successtemplate> <table border="0" style="font-size:10pt;"> <tr> <td>Your password has been sent to you.</td> </tr> </table> </successtemplate> <titletextstyle font-bold="True" forecolor="White" backcolor="#6B696B"> </titletextstyle> </asp:PasswordRecovery> </FORM> </BODY> </HTML>
<%@ 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"> // Set the field label background color if the user name is not found. void PasswordRecovery1_UserLookupError(object sender, System.EventArgs e) { PasswordRecovery1.LabelStyle.ForeColor = System.Drawing.Color.Red; } // Reset the field label background color. void PasswordRecovery1_Load(object sender, System.EventArgs e) { PasswordRecovery1.LabelStyle.ForeColor = System.Drawing.Color.Black; } </SCRIPT> <HTML> <BODY> <FORM runat="server"> <asp:PasswordRecovery id="PasswordRecovery1" runat="server" BorderStyle="Solid" BorderWidth="1px" BackColor="#F7F7DE" Font-Size="10pt" Font-Names="Verdana" BorderColor="#CCCC99" HelpPageText="Need help?" HelpPageUrl=recoveryHelp.aspx onuserlookuperror="PasswordRecovery1_UserLookupError" onload="PasswordRecovery1_Load" > <successtemplate> <table border="0" style="font-size:10pt;"> <tr> <td>Your password has been sent to you.</td> </tr> </table> </successtemplate> <titletextstyle font-bold="True" forecolor="White" backcolor="#6B696B"> </titletextstyle> </asp:PasswordRecovery> </FORM> </BODY> </HTML>
.NET Framework のセキュリティ継承階層System.Web.UI.Control
System.Web.UI.WebControls.WebControl
System.Web.UI.WebControls.CompositeControl
System.Web.UI.WebControls.PasswordRecovery
スレッド セーフプラットフォーム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 コンストラクタ
アセンブリ: System.Web (system.web.dll 内)
構文解説プラットフォーム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 フィールド
.gif)
PasswordRecovery プロパティ
パブリック プロパティ.gif)
プロテクト プロパティ.gif)
参照PasswordRecovery メソッド
パブリック メソッド.gif)
プロテクト メソッド.gif)
参照PasswordRecovery メンバ
ユーザーが忘れたパスワードを回復またはリセットし、電子メールでそのパスワードを受け取ることができるようにするユーザー インターフェイス (UI: User Interface) 要素を提供します。
PasswordRecovery データ型で公開されるメンバを以下の表に示します。
パブリック コンストラクタパブリック フィールドパブリック プロパティプロテクト プロパティパブリック メソッドプロテクト メソッドパブリック イベント| 名前 | 説明 | |
|---|---|---|
| | AnswerLookupError | パスワード回復用の確認質問に対してユーザーが誤った解答を入力した場合に発生します。 |
| | DataBinding | サーバー コントロールがデータ ソースに連結すると発生します。(Control から継承されます。) |
| | Disposed | サーバー コントロールがメモリから解放されると発生します。これは、ASP.NET ページが要求されている場合のサーバー コントロールの有効期間における最終段階です。(Control から継承されます。) |
| | Init | サーバー コントロールが初期化されると発生します。これは、サーバー コントロールの有効期間における最初の手順です。(Control から継承されます。) |
| | Load | サーバー コントロールが Page オブジェクトに読み込まれると発生します。(Control から継承されます。) |
| | PreRender | Control オブジェクトの読み込み後、表示を開始する前に発生します。(Control から継承されます。) |
| | SendingMail | パスワードが電子メールでユーザーに送信される前に発生します。 |
| | SendMailError | 電子メール メッセージを送信しようとしたときに、SMTP メール システムがエラーをスローした場合に発生します。 |
| | Unload | サーバー コントロールがメモリからアンロードされると発生します。(Control から継承されます。) |
| | UserLookupError | ユーザーが入力したユーザー名をメンバシップ プロバイダが検索できない場合に発生します。 |
| | VerifyingAnswer | パスワード回復用の確認質問への解答をユーザーが送信したときに発生します。 |
| | VerifyingUser | メンバシップ プロバイダがユーザー名を検証する前に発生します。 |
参照- PasswordRecoveryのページへのリンク
