ChangePassword

.NET Framework クラス ライブラリ リファレンス

ChangePassword イベント

パブリック イベント

	名前	説明
	CancelButtonClick	ユーザーが [キャンセル] ボタンをクリックしてパスワードの変更をキャンセルしたときに発生します。
	ChangedPassword	ユーザー アカウントのパスワードが変更されると発生します。
	ChangePasswordError	ユーザー アカウントのパスワード変更にエラーがある場合に発生します。
	ChangingPassword	ユーザー アカウントのパスワードがメンバシップ プロバイダによって変更される前に発生します。
	ContinueButtonClick	ユーザーが [続行] ボタンをクリックしたときに、ContinueButtonClick イベントを発生させます。
	DataBinding	サーバー コントロールがデータ ソースに連結すると発生します。 ( Control から継承されます。)
	Disposed	サーバー コントロールがメモリから解放されると発生します。これは、ASP.NET ページが要求されている場合のサーバー コントロールの有効期間における最終段階です。 ( Control から継承されます。)
	Init	サーバー コントロールが初期化されると発生します。これは、サーバー コントロールの有効期間における最初の手順です。 ( Control から継承されます。)
	Load	サーバー コントロールが Page オブジェクトに読み込まれると発生します。 ( Control から継承されます。)
	PreRender	Control オブジェクトの読み込み後、表示を開始する前に発生します。 ( Control から継承されます。)
	SendingMail	パスワードが変更されたことを伝える確認の電子メールがユーザーに送信される前に発生します。
	SendMailError	電子メール メッセージをユーザーに送信する際に SMTP エラーがあった場合に発生します。
	Unload	サーバー コントロールがメモリからアンロードされると発生します。 ( Control から継承されます。)

参照

関連項目

ChangePassword クラス
System.Web.UI.WebControls 名前空間
ChangePassword.CurrentPassword プロパティ
ChangePassword.NewPassword プロパティ
CreateUserWizard
PasswordRecovery
Login
DeleteUser

その他の技術情報

ASP.NET ログイン コントロールの概要
ASP.NET ログイン コントロールの外観のカスタマイズ
ASP.NET Web サーバー コントロール テンプレート
ASP.NET のテーマとスキンの概要
方法 : ASP.NET Web サーバー コントロールのテンプレートを動的に作成する
方法 : ASP.NET Web サーバー コントロールのテンプレートを宣言によって作成する
方法 : 匿名ユーザーおよびログイン ユーザーに異なる情報を表示する
Web サイト管理ツールの [セキュリティ] タブ
ログイン コントロールのセキュリティ保護
Web アプリケーションのセキュリティに関する基本的な対策
メンバシップのセキュリティ保護

ChangePassword クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

ユーザーが Web サイトのパスワードを変更できるようにするユーザー インターフェイスを提供します。

名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

<BindableAttribute(False)> _
Public Class ChangePassword
    Inherits CompositeControl
    Implements INamingContainer

Visual Basic (使用法)

Dim instance As ChangePassword

C#

[BindableAttribute(false)] 
public class ChangePassword : CompositeControl,
 INamingContainer

C++

[BindableAttribute(false)] 
public ref class ChangePassword : public
 CompositeControl, INamingContainer

J#

/** @attribute BindableAttribute(false) */ 
public class ChangePassword extends CompositeControl
 implements INamingContainer

JScript

BindableAttribute(false) 
public class ChangePassword extends
 CompositeControl implements INamingContainer

解説

ページ上で ChangePassword コントロールを使用して、Web サイトのユーザーが Web サイトにログオンするために使用するパスワードを変更できるようにします。

重要 :
パスワードの変更、続行、およびキャンセルの機能は、ボタンがどのビューに配置されているかにかかわらず、正しいコマンド名を持つ任意のボタンに結び付けられます。たとえば、正常に完了ビュー上に commandname として changepassword が設定されているボタンがあった場合、そのボタンがパスワードの変更を試行すると、例外が発生します。

スタイルとテンプレート

さまざまなスタイル プロパティのセットを使用して、ChangePassword コントロールの外観をカスタマイズできます。ChangePassword コントロールの外観を完全に制御する必要がある場合は、別の方法として、カスタム テンプレートを 2 つのビューに適用できます。ビューのテンプレートを定義する場合は、ControlStyle プロパティが適用されます。ビューのテンプレートで設定する必要があるコントロールの一覧については、ChangePasswordTemplate プロパティおよび SuccessTemplate プロパティを参照してください。ChangePassword コントロールはテンプレートの内容を検査し、必要なコントロールが見つからない場合、名前が正しく指定されていない場合、または型が正しくない場合に例外をスローします。たとえば、テンプレートのコンテンツを使用し、DisplayUserName プロパティを true に設定した場合、ユーザー名に対応する TextBox コントロールやその他の IEditableTextControl コントロールが見つからないと、ChangePassword は例外をスローします。

ChangePassword コントロールのスタイル プロパティの一覧と、それらが影響を及ぼす UI 要素の説明を以下に示します。各スタイルが適用されるプロパティの一覧については、個々のスタイル プロパティを参照してください。

ChangePassword スタイル プロパティ	UI 要素
CancelButtonStyle	パスワードの変更ビューのキャンセル ボタン
ChangePasswordButtonStyle	パスワードの変更ビューのパスワードの変更ボタン
ContinueButtonStyle	正常に完了ビューの続行ボタン
FailureTextStyle	ユーザーに表示されるエラー テキスト
HyperLinkStyle	他のページへのハイパーリンク
InstructionTextStyle	ChangePassword コントロールの使い方を説明するページ上の説明テキスト
LabelStyle	テキスト ボックスなど、すべての入力フィールドのラベル
PasswordHintStyle	Web サイトに使用できるパスワードを指定するためのヒント
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 コントロールとユーザー補助」を参照してください。

Page_Load および Page_Init 時のコントロールへのアクセス

UserName や CurrentPassword など、テキスト ボックスで表される ChangePassword コントロールの各プロパティは、ページの有効期間のすべてのフェーズでアクセスできます。特に、Page_Init フェーズと Page_Load フェーズでは、これらのプロパティの値は、ChangePassword コントロールが表示された時点の値と同じになります。ユーザーが UserName ボックスを変更して UserName プロパティの値を変更した場合、Page_Load フェーズの後に発生する変更イベントが発生したときに、新しい値が有効になります。したがって、Page_Init フェーズや Page_Load フェーズで UserName プロパティの値を設定し、ChangePassword イベントのカスタム ハンドラを提供した場合、Page_Init フェーズや Page_Load フェーズで設定された値は、UserName ボックスでユーザーが加えた変更によってオーバーライドされます。

使用例

NewPasswordRegularExpression プロパティを設定して、以下の基準に一致するようにパスワードをチェックする正規表現を定義する方法を次のコード例に示します。

• 6 文字より多いこと。

• 少なくとも 1 つの数字を含むこと。

• 少なくとも 1 つの特殊 (英数字以外) 文字を含むこと。

PasswordHintText プロパティに格納されたパスワード要件は、ユーザーに表示されます。

ユーザーが入力したパスワードが NewPasswordRegularExpression プロパティの要件と一致しない場合は、NewPasswordRegularExpressionErrorMessage プロパティに格納されたテキストがユーザーに表示されます。新しいパスワードが入力されない場合、NewPasswordRequiredErrorMessage プロパティに格納されたテキストがユーザーに表示されます。

メモ
新しいパスワードは、MinRequiredPasswordLength、MinRequiredNonAlphanumericCharacters、および PasswordStrengthRegularExpression の各プロパティのメンバシップ プロバイダによって設定される最低限の条件を満たす必要があります。パスワードがこれらの要件を満たしていない場合、ChangePasswordError イベントが発生します。

Visual Basic

<%@ 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>

C#

<%@ 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 のセキュリティ

• AspNetHostingPermission  (ホスト環境での動作に必要なアクセス許可)要求値 : LinkDemand; アクセス許可値 : Minimal。
• AspNetHostingPermission  (ホスト環境での動作に必要なアクセス許可)要求値 : InheritanceDemand; アクセス許可値 : Minimal。

継承階層

System.Object
   System.Web.UI.Control
     System.Web.UI.WebControls.WebControl
       System.Web.UI.WebControls.CompositeControl
        System.Web.UI.WebControls.ChangePassword

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
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 アプリケーションのセキュリティに関する基本的な対策
メンバシップのセキュリティ保護