BaseValidator イベント
パブリック イベント| 名前 | 説明 | |
|---|---|---|
.gif) | DataBinding | サーバー コントロールがデータ ソースに連結すると発生します。 ( Control から継承されます。) |
| | Disposed | サーバー コントロールがメモリから解放されると発生します。これは、ASP.NET ページが要求されている場合のサーバー コントロールの有効期間における最終段階です。 ( Control から継承されます。) |
| | Init | サーバー コントロールが初期化されると発生します。これは、サーバー コントロールの有効期間における最初の手順です。 ( Control から継承されます。) |
| | Load | サーバー コントロールが Page オブジェクトに読み込まれると発生します。 ( Control から継承されます。) |
| | PreRender | Control オブジェクトの読み込み後、表示を開始する前に発生します。 ( Control から継承されます。) |
| | Unload | サーバー コントロールがメモリからアンロードされると発生します。 ( Control から継承されます。) |
参照BaseValidator イベント
パブリック イベント| 名前 | 説明 | |
|---|---|---|
| | DataBinding | サーバー コントロールがデータ ソースに連結すると発生します。 ( Control から継承されます。) |
| | Disposed | サーバー コントロールがメモリから解放されると発生します。これは、ASP.NET ページが要求されている場合のサーバー コントロールの有効期間における最終段階です。 ( Control から継承されます。) |
| | Init | サーバー コントロールが初期化されると発生します。これは、サーバー コントロールの有効期間における最初の手順です。 ( Control から継承されます。) |
| | Load | サーバー コントロールが Page オブジェクトに読み込まれると発生します。 ( Control から継承されます。) |
| | PreRender | Control オブジェクトの読み込み後、表示を開始する前に発生します。 ( Control から継承されます。) |
| | Unload | サーバー コントロールがメモリからアンロードされると発生します。 ( Control から継承されます。) |
参照BaseValidator クラス
アセンブリ: System.Web.Mobile (system.web.mobile.dll 内)
構文解説BaseValidator クラスは TextControl 基本クラスを継承しているため、Text プロパティを持ちます。検証コントロールでは、エントリが無効な場合に、Text プロパティの値が表示されます。このプロパティが設定されていなければ、代わりに ErrorMessage プロパティの値が検証コントロールに表示されます。これは、ValidationSummary コントロールに示されるテキストです。これは、Web フォーム検証コントロールとの一貫性を確保するための動作です。
ASP.NET モバイル コントロールのうち検証をサポートしているコントロールは、TextBox コントロール (Text プロパティ) と SelectionList コントロール (SelectedIndex プロパティ) です。その他のコントロールは、ValidationPropertyAttribute 属性を含めることで検証を実行させることができます。詳細については、「Validating Against a Specific Value for ASP.NET Server Controls」を参照してください。
.NET Framework のセキュリティ継承階層System.Web.UI.Control
System.Web.UI.MobileControls.MobileControl
System.Web.UI.MobileControls.TextControl
System.Web.UI.MobileControls.BaseValidator
System.Web.UI.MobileControls.CompareValidator
System.Web.UI.MobileControls.CustomValidator
System.Web.UI.MobileControls.RangeValidator
System.Web.UI.MobileControls.RegularExpressionValidator
System.Web.UI.MobileControls.RequiredFieldValidator
スレッド セーフプラットフォームWindows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報参照BaseValidator クラス
アセンブリ: System.Web (system.web.dll 内)
構文解説BaseValidator クラスは、すべての検証コントロールのコア実装を提供します。検証コントロールは、関連付けられた入力コントロール内のユーザー入力を検証するために使用されます。ユーザーが入力した値が検証に合格しない場合は、検証コントロールからエラー メッセージが表示されます。検証コントロールは入力コントロールから切り離されているので、入力コントロールに関連するページ内のどの場所にでもエラー メッセージを配置できます。ASP.NET には、特定の種類の検証を実行する複数の検証コントロールが用意されています。これらのコントロールを次の表に示します。
| CompareValidator | CompareValidator.Operator プロパティを ValidationCompareOperator.DataTypeCheck に設定することにより、他の入力コントロールに入力された値、定数値、または適切なデータ型に対して値を検証します。 |
| CustomValidator | |
| RangeValidator | |
| RegularExpressionValidator | |
| RequiredFieldValidator |
検証コントロールは、常に関連付けられている入力コントロールをサーバー上で検証します。検証コントロールはクライアント側で実装することもでき、スクリプトに対応しているブラウザ (Internet Explorer Version 4.0 以降など) によりクライアント上で検証を実行できます。クライアント側の検証で、ユーザーによる入力をサーバーに送信する前にチェックすることによって、検証プロセスが強化されます。これによりフォームを送信する前にクライアントでエラーを検出し、サーバー側での検証に必要な情報のラウンド トリップが発生しないようにできます。
複数の検証コントロールを 1 つの入力コントロールに関連付けて、異なる基準で検証を実行できます。たとえば、TextBox コントロールには複数の検証コントロールを適用できます。RangeValidator コントロールを使用すると、TextBox コントロールに入力された値が必ず指定範囲内に収まるように設定できます。また RequiredFieldValidator コントロールを使用すると、ユーザーが必ず値を入力するように設定できます。
ASP.NET には、サーバーに対するポストバック機能を持つ多数のコントロールが用意されています。これらのコントロールのうち、いずれかのコントロールの CausesValidation プロパティを true に設定すると、そのコントロールがサーバーにポストバックするときに検証が実行されます。サーバーへのポストバック機能を持つコントロールを次に示します。
-
System.Web.UI.WebControls.BulletedList
-
System.Web.UI.WebControls.Button
-
System.Web.UI.WebControls.CheckBox
-
System.Web.UI.WebControls.CheckBoxList
-
System.Web.UI.WebControls.DropDownList
-
System.Web.UI.HtmlControls.HtmlButton
-
System.Web.UI.HtmlControls.HtmlInputButton
-
System.Web.UI.HtmlControls.HtmlInputImage
-
System.Web.UI.WebControls.ImageButton
-
System.Web.UI.WebControls.LinkButton
-
System.Web.UI.WebControls.ListBox
-
System.Web.UI.WebControls.RadioButtonList
-
System.Web.UI.WebControls.TextBox
これらの各コントロールには ValidationGroup プロパティがあります。このプロパティを設定すると、そのコントロールでサーバーへのポストバックが発生するときに、指定したグループ内の検証コントロールだけが検証されます。検証コントロールをグループ化するには、各検証コントロールの ValidationGroup プロパティを同じ値に設定します。
入力コントロールを検証コントロールに関連付けるには、ControlToValidate プロパティを使用します。検証が失敗した場合に検証コントロールで表示するテキストを指定するには、Text プロパティを使用します。ValidationSummary コントロールを使用して、そのページで検証に失敗したすべてのコントロールの要約を表示することもできます。ValidationSummary コントロールに表示するテキストを指定するには、ErrorMessage プロパティを使用します。
検証コントロールを使用する場合は、処理を実行する前にサーバー側の検証結果を確認する必要があります。ポストバックが終了してからイベント メソッドを呼び出す直前までの間に、ページは検証コントロールを呼び出して検証結果を Page.IsValid プロパティに集約します (Validate メソッドを使用して検証コントロールを明示的に呼び出すこともできます)。独自のコードを使用する場合、入力を処理する前に、Page.IsValid プロパティが true を返すことを確認する必要があります。検証が失敗した場合、クライアントでポストバックが発生するのをスクリプト対応のブラウザが防ぐ場合もありますが、検証済みデータを処理する前に必ずサーバー コードで Page.IsValid を確認する必要があります。
検証は手動でも実行できます。ページ上のすべての検証コントロールを検証するには、Page.Validate メソッドを使用します。個別の検証コントロールを検証するには、そのコントロールの Validate メソッドを使用します。
.gif) メモ |
|---|
| Page_Load メソッドで Page.IsValid プロパティを使用する場合は、最初に明示的に Page.Validate メソッドを呼び出す必要があります。検証は、ページの Control.Load イベントが終了してから Click イベントまたは Command イベントのイベント ハンドラが処理されるまでの間に実行されるため、Page.Validate メソッドが呼び出されるまで Page.IsValid プロパティは更新されません。代案として、Page_Load メソッドの代わりに Click イベントまたは Command イベントのイベント ハンドラにコードを配置することもできます。 |
一部の Web サーバー コントロールでは検証コントロールがサポートされません。検証コントロールで検証できる標準コントロールを次に示します。
-
System.Web.UI.WebControls.DropDownList
-
System.Web.UI.WebControls.FileUpload
-
System.Web.UI.WebControls.ListBox
-
System.Web.UI.WebControls.RadioButtonList
-
System.Web.UI.WebControls.TextBox
-
System.Web.UI.HtmlControls.HtmlInputFile
-
System.Web.UI.HtmlControls.HtmlInputPassword
-
System.Web.UI.HtmlControls.HtmlInputText
-
System.Web.UI.HtmlControls.HtmlSelect
-
System.Web.UI.HtmlControls.HtmlTextArea
検証が失敗した場合、SetFocusOnError プロパティを true に設定して、関連付けられた入力コントロールにフォーカスを設定できます。
BaseValidator のインスタンスの初期プロパティ値の一覧については、BaseValidator コンストラクタのトピックを参照してください。
ユーザー補助
このコントロールに既定でレンダリングされるマークアップは、Web Content Accessibility Guidelines (WCAG) 1.0 の優先度 1 ガイドラインなどのユーザー補助に関する標準に適合しない可能性があります。このコントロールのユーザー補助サポートの詳細については、「ASP.NET コントロールとユーザー補助」を参照してください。
使用例複数の検証コントロールを使用して、ユーザーが TextBox コントロールに有効値を入力するようにするコード例を次に示します。
<%@ Page Language="VB" AutoEventWireup="False" %> <script runat="server"> Sub Button_Click(ByVal sender As Object, ByVal e As EventArgs) Handles SubmitButton.Click If Page.IsValid Then MessageLabel.Text = "Page submitted successfully." Else MessageLabel.Text = "There is an error on the page." End If End Sub </script> <html> <body> <form runat="server"> <h3>Validator Example</h3> Enter a number from 1 to 10. <asp:textbox id="NumberTextBox" runat="server"/> <asp:rangevalidator id="NumberCompareValidator" controltovalidate="NumberTextBox" enableclientscript="False" type="Integer" display="Dynamic" errormessage="Please enter a value from 1 to 10." maximumvalue="10" minimumvalue="1" text="*" runat="server"/> <asp:requiredfieldvalidator id="TextBoxRequiredValidator" controltovalidate="NumberTextBox" enableclientscript="False" display="Dynamic" errormessage="Please enter a value." text="*" runat="server"/> <br><br> <asp:button id="SubmitButton" text="Submit" runat="server"/> <br><br> <asp:label id="MessageLabel" runat="server"/> <br><br> <asp:validationsummary id="ErrorSummary" runat="server"/> </form> </body> </html>
<%@ Page Language="C#" %> <script runat="server"> void Button_Click(Object sender, EventArgs e) { if (Page.IsValid) { MessageLabel.Text = "Page submitted successfully."; } else { MessageLabel.Text = "There is an error on the page."; } } </script> <html> <body> <form runat="server"> <h3>Validator Example</h3> Enter a number from 1 to 10. <asp:textbox id="NumberTextBox" runat="server"/> <asp:rangevalidator id="NumberCompareValidator" controltovalidate="NumberTextBox" enableclientscript="False" type="Integer" display="Dynamic" errormessage="Please enter a value from 1 to 10." maximumvalue="10" minimumvalue="1" text="*" runat="server"/> <asp:requiredfieldvalidator id="TextBoxRequiredValidator" controltovalidate="NumberTextBox" enableclientscript="False" display="Dynamic" errormessage="Please enter a value." text="*" runat="server"/> <br><br> <asp:button id="SubmitButton" text="Submit" onclick="Button_Click" runat="server"/> <br><br> <asp:label id="MessageLabel" runat="server"/> <br><br> <asp:validationsummary id="ErrorSummary" runat="server"/> </form> </body> </html>
<%@ Page Language="JScript" %> <script runat="server"> function Button_Click(sender, e : EventArgs) { if (Page.IsValid) { MessageLabel.Text = "Page submitted successfully."; } else { MessageLabel.Text = "There is an error on the page."; } } </script> <html> <body> <form runat="server"> <h3>Validator Example</h3> Enter a number from 1 to 10. <asp:textbox id="NumberTextBox" runat="server"/> <asp:rangevalidator id="NumberCompareValidator" controltovalidate="NumberTextBox" enableclientscript="False" type="Integer" display="Dynamic" errormessage="Please enter a value from 1 to 10." maximumvalue="10" minimumvalue="1" text="*" runat="server"/> <asp:requiredfieldvalidator id="TextBoxRequiredValidator" controltovalidate="NumberTextBox" enableclientscript="False" display="Dynamic" errormessage="Please enter a value." text="*" runat="server"/> <br><br> <asp:button id="SubmitButton" text="Submit" onclick="Button_Click" runat="server"/> <br><br> <asp:label id="MessageLabel" runat="server"/> <br><br> <asp:validationsummary id="ErrorSummary" runat="server"/> </form> </body> </html>
継承階層System.Web.UI.Control
System.Web.UI.WebControls.WebControl
System.Web.UI.WebControls.Label
System.Web.UI.WebControls.BaseValidator
System.Web.UI.WebControls.BaseCompareValidator
System.Web.UI.WebControls.CustomValidator
System.Web.UI.WebControls.RegularExpressionValidator
System.Web.UI.WebControls.RequiredFieldValidator
スレッド セーフプラットフォーム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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報参照BaseValidator メンバ
System.Web.UI.WebControls 名前空間
CompareValidator
CustomValidator
RangeValidator
RegularExpressionValidator
RequiredFieldValidator
ValidationSummary
CausesValidation
ErrorMessage
Text
ValidationGroup
BaseValidator コンストラクタ
アセンブリ: System.Web.Mobile (system.web.mobile.dll 内)
構文解説プラットフォームWindows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報参照BaseValidator コンストラクタ
アセンブリ: System.Web (system.web.dll 内)
構文解説このコンストラクタは直接には呼び出されません。このクラスを継承した検証コントロールは、このコンストラクタを独自のコンストラクタから呼び出して基本プロパティを初期化します。
BaseValidator のインスタンスの初期プロパティ値を次の表に示します。
プラットフォーム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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報参照BaseValidator プロパティ
パブリック プロパティ.gif)
プロテクト プロパティ.gif)
参照BaseValidator プロパティ
パブリック プロパティプロテクト プロパティ参照関連項目
BaseValidator クラスSystem.Web.UI.WebControls 名前空間
CompareValidator
CustomValidator
RangeValidator
RegularExpressionValidator
RequiredFieldValidator
ValidationSummary
CausesValidation
ErrorMessage
Text
ValidationGroup
BaseValidator メソッド
パブリック メソッド.gif)
.gif)
プロテクト メソッド.gif)
参照BaseValidator メソッド
パブリック メソッドプロテクト メソッド参照関連項目
BaseValidator クラスSystem.Web.UI.WebControls 名前空間
CompareValidator
CustomValidator
RangeValidator
RegularExpressionValidator
RequiredFieldValidator
ValidationSummary
CausesValidation
ErrorMessage
Text
ValidationGroup
BaseValidator メンバ
このクラスから派生したすべての検証コントロールの実装の中核となります。抽象クラスであるため、このクラスのインスタンスは作成できません。
BaseValidator データ型で公開されるメンバを以下の表に示します。
プロテクト コンストラクタパブリック プロパティプロテクト プロパティパブリック メソッドプロテクト メソッドパブリック イベント| 名前 | 説明 | |
|---|---|---|
| | DataBinding | サーバー コントロールがデータ ソースに連結すると発生します。(Control から継承されます。) |
| | Disposed | サーバー コントロールがメモリから解放されると発生します。これは、ASP.NET ページが要求されている場合のサーバー コントロールの有効期間における最終段階です。(Control から継承されます。) |
| | Init | サーバー コントロールが初期化されると発生します。これは、サーバー コントロールの有効期間における最初の手順です。(Control から継承されます。) |
| | Load | サーバー コントロールが Page オブジェクトに読み込まれると発生します。(Control から継承されます。) |
| | PreRender | Control オブジェクトの読み込み後、表示を開始する前に発生します。(Control から継承されます。) |
| | Unload | サーバー コントロールがメモリからアンロードされると発生します。(Control から継承されます。) |
参照BaseValidator メンバ
BaseValidator データ型で公開されるメンバを以下の表に示します。
プロテクト コンストラクタパブリック プロパティプロテクト プロパティパブリック メソッドプロテクト メソッドパブリック イベント| 名前 | 説明 | |
|---|---|---|
| | DataBinding | サーバー コントロールがデータ ソースに連結すると発生します。(Control から継承されます。) |
| | Disposed | サーバー コントロールがメモリから解放されると発生します。これは、ASP.NET ページが要求されている場合のサーバー コントロールの有効期間における最終段階です。(Control から継承されます。) |
| | Init | サーバー コントロールが初期化されると発生します。これは、サーバー コントロールの有効期間における最初の手順です。(Control から継承されます。) |
| | Load | サーバー コントロールが Page オブジェクトに読み込まれると発生します。(Control から継承されます。) |
| | PreRender | Control オブジェクトの読み込み後、表示を開始する前に発生します。(Control から継承されます。) |
| | Unload | サーバー コントロールがメモリからアンロードされると発生します。(Control から継承されます。) |
参照関連項目
BaseValidator クラスSystem.Web.UI.WebControls 名前空間
CompareValidator
CustomValidator
RangeValidator
RegularExpressionValidator
RequiredFieldValidator
ValidationSummary
CausesValidation
ErrorMessage
Text
ValidationGroup
- BaseValidatorのページへのリンク
