ChangePassword クラス
アセンブリ: System.Web (system.web.dll 内)
構文<BindableAttribute(False)> _ Public Class ChangePassword Inherits CompositeControl Implements INamingContainer
[BindableAttribute(false)] public class ChangePassword : CompositeControl, INamingContainer
[BindableAttribute(false)] public ref class ChangePassword : public CompositeControl, INamingContainer
/** @attribute BindableAttribute(false) */ public class ChangePassword extends CompositeControl implements INamingContainer
BindableAttribute(false) public class ChangePassword extends CompositeControl implements INamingContainer
解説ページ上で ChangePassword コントロールを使用して、Web サイトのユーザーが Web サイトにログオンするために使用するパスワードを変更できるようにします。
.gif) 重要 : |
|---|
| パスワードの変更、続行、およびキャンセルの機能は、ボタンがどのビューに配置されているかにかかわらず、正しいコマンド名を持つ任意のボタンに結び付けられます。たとえば、正常に完了ビュー上に commandname として changepassword が設定されているボタンがあった場合、そのボタンがパスワードの変更を試行すると、例外が発生します。 |
スタイルとテンプレート
さまざまなスタイル プロパティのセットを使用して、ChangePassword コントロールの外観をカスタマイズできます。ChangePassword コントロールの外観を完全に制御する必要がある場合は、別の方法として、カスタム テンプレートを 2 つのビューに適用できます。ビューのテンプレートを定義する場合は、ControlStyle プロパティが適用されます。ビューのテンプレートで設定する必要があるコントロールの一覧については、ChangePasswordTemplate プロパティおよび SuccessTemplate プロパティを参照してください。ChangePassword コントロールはテンプレートの内容を検査し、必要なコントロールが見つからない場合、名前が正しく指定されていない場合、または型が正しくない場合に例外をスローします。たとえば、テンプレートのコンテンツを使用し、DisplayUserName プロパティを true に設定した場合、ユーザー名に対応する TextBox コントロールやその他の IEditableTextControl コントロールが見つからないと、ChangePassword は例外をスローします。
ChangePassword コントロールのスタイル プロパティの一覧と、それらが影響を及ぼす UI 要素の説明を以下に示します。各スタイルが適用されるプロパティの一覧については、個々のスタイル プロパティを参照してください。
| CancelButtonStyle | |
| ChangePasswordButtonStyle | |
| ContinueButtonStyle | |
| FailureTextStyle | |
| HyperLinkStyle | |
| InstructionTextStyle | |
| LabelStyle | |
| PasswordHintStyle | |
| SuccessTextStyle | |
| TextBoxStyle | |
| TitleTextStyle |
検証のグループ化
ChangePassword コントロールは、ChangePassword コントロールと同じページ上の他のフィールドを別々に検証できるように、検証グループを使用します。既定では、ChangePassword コントロールの ID プロパティが、検証グループの名前として使用されます。たとえば、ID が "ChangePassword1" の ChangePassword コントロールの場合、検証グループの名前にも ChangePassword1 が使用されます。ChangePassword コントロールが所属する検証グループを設定するには、そのコントロールを含むテンプレートを作成してから、検証グループ名を変更する必要があります。
ユーザーが TextBox コントロールを空のままにした場合にエラー メッセージを表示するには、ValidationSummary コントロールをページに追加します。ValidationSummary コントロールの ValidationGroup プロパティを ChangePassword コントロールの ID プロパティに設定します。
ChangePassword コントロールがテンプレートでカスタマイズされていない場合、ChangePassword コントロールの AccessKey プロパティがコントロール内の最初のテキスト ボックスに適用されます。ChangePassword コントロールがテンプレートでカスタマイズされている場合、AccessKey プロパティは無視されます。その場合は、各テンプレートの子コントロールの AccessKey プロパティを直接設定します。TabIndex プロパティは、ChangePassword コントロールのすべての TextBox コントロールにレンダリングされます。ChangePassword コントロールがテンプレートでカスタマイズされている場合、TabIndex プロパティは無視されます。
このコントロールに既定でレンダリングされるマークアップは、Web Content Accessibility Guidelines (WCAG) 1.0 の優先度 1 ガイドラインなどのユーザー補助に関する標準に適合しない可能性があります。たとえば、CancelDestinationPageUrl または SuccessPageUrl を使用するとページが更新されますが、これは、ページ上のボタンやリンクをクリックしたときにページが更新されてはいけないというユーザー補助要件に反しています。このコントロールのユーザー補助サポートの詳細については、「ASP.NET コントロールとユーザー補助」を参照してください。
UserName や CurrentPassword など、テキスト ボックスで表される ChangePassword コントロールの各プロパティは、ページの有効期間のすべてのフェーズでアクセスできます。特に、Page_Init フェーズと Page_Load フェーズでは、これらのプロパティの値は、ChangePassword コントロールが表示された時点の値と同じになります。ユーザーが UserName ボックスを変更して UserName プロパティの値を変更した場合、Page_Load フェーズの後に発生する変更イベントが発生したときに、新しい値が有効になります。したがって、Page_Init フェーズや Page_Load フェーズで UserName プロパティの値を設定し、ChangePassword イベントのカスタム ハンドラを提供した場合、Page_Init フェーズや Page_Load フェーズで設定された値は、UserName ボックスでユーザーが加えた変更によってオーバーライドされます。
使用例NewPasswordRegularExpression プロパティを設定して、以下の基準に一致するようにパスワードをチェックする正規表現を定義する方法を次のコード例に示します。
PasswordHintText プロパティに格納されたパスワード要件は、ユーザーに表示されます。
ユーザーが入力したパスワードが NewPasswordRegularExpression プロパティの要件と一致しない場合は、NewPasswordRegularExpressionErrorMessage プロパティに格納されたテキストがユーザーに表示されます。新しいパスワードが入力されない場合、NewPasswordRequiredErrorMessage プロパティに格納されたテキストがユーザーに表示されます。
| メモ |
|---|
| 新しいパスワードは、MinRequiredPasswordLength、MinRequiredNonAlphanumericCharacters、および PasswordStrengthRegularExpression の各プロパティのメンバシップ プロバイダによって設定される最低限の条件を満たす必要があります。パスワードがこれらの要件を満たしていない場合、ChangePasswordError イベントが発生します。 |
<%@ page language="VB"%> <script runat="server"> </script> <html> <head runat="server"> <title>Change Password with Validation</title> </head> <body> <form id="form1" runat="server"> <div> <asp:changepassword id="ChangePassword1" runat="server" PasswordHintText = "Please enter a password at least 7 characters long, containing a number and one special character." NewPasswordRegularExpression = '@\"(?=.{7,})(?=(.*\d){1,})(?=(.*\W){1,})' NewPasswordRegularExpressionErrorMessage = "Your password must be at least 7 characters long, and contain at least one number and one special character."> </asp:changepassword> </div> </form> </body> </html>
<%@ page language="C#"%> <script runat="server"> </script> <html> <head runat="server"> <title>Change Password with Validation</title> </head> <body> <form id="form1" runat="server"> <div> <asp:changepassword id="ChangePassword1" runat="server" PasswordHintText = "Please enter a password at least 7 characters long, containing a number and one special character." NewPasswordRegularExpression = '@\"(?=.{7,})(?=(.*\d){1,})(?=(.*\W){1,})' NewPasswordRegularExpressionErrorMessage = "Error: Your password must be at least 7 characters long, and contain at least one number and one special character." > </asp:changepassword> </div> </form> </body> </html>
.NET Framework のセキュリティ継承階層System.Web.UI.Control
System.Web.UI.WebControls.WebControl
System.Web.UI.WebControls.CompositeControl
System.Web.UI.WebControls.ChangePassword
スレッド セーフプラットフォーム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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報参照ChangePassword メンバ
System.Web.UI.WebControls 名前空間
CurrentPassword
NewPassword
CreateUserWizard
PasswordRecovery
Login
DeleteUser
その他の技術情報
ASP.NET ログイン コントロールの概要
ASP.NET ログイン コントロールの外観のカスタマイズ
ASP.NET Web サーバー コントロール テンプレート
ASP.NET のテーマとスキンの概要
方法 : ASP.NET Web サーバー コントロールのテンプレートを動的に作成する
方法 : ASP.NET Web サーバー コントロールのテンプレートを宣言によって作成する
方法 : 匿名ユーザーおよびログイン ユーザーに異なる情報を表示する
Web サイト管理ツールの [セキュリティ] タブ
ログイン コントロールのセキュリティ保護
Web アプリケーションのセキュリティに関する基本的な対策
メンバシップのセキュリティ保護
- ChangePassword クラスのページへのリンク
