BaseValidator.ControlToValidate プロパティ
アセンブリ: System.Web.Mobile (system.web.mobile.dll 内)

Dim instance As BaseValidator Dim value As String value = instance.ControlToValidate instance.ControlToValidate = value
[BindableAttribute(false)] public: property String^ ControlToValidate { String^ get (); void set (String^ value); }
/** @property */ public String get_ControlToValidate () /** @property */ public void set_ControlToValidate (String value)
public function get ControlToValidate () : String public function set ControlToValidate (value : String)
検証するコントロールの ID。


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.ControlToValidate プロパティ
アセンブリ: System.Web (system.web.dll 内)

Dim instance As BaseValidator Dim value As String value = instance.ControlToValidate instance.ControlToValidate = value
[ThemeableAttribute(false)] public: property String^ ControlToValidate { String^ get (); void set (String^ value); }
/** @property */ public String get_ControlToValidate () /** @property */ public void set_ControlToValidate (String value)
public function get ControlToValidate () : String public function set ControlToValidate (value : String)
検証対象の入力コントロール。既定値は String.Empty で、このプロパティが設定されていないことを示します。

ControlToValidate プロパティを使用して、検証対象の入力コントロールを指定します。このプロパティは、すべての検証コントロールについて入力コントロールの ID に設定する必要があります。ただし、CustomValidator コントロールは空白のままにしておくことができます。有効な入力コントロールを指定しない場合は、ページが表示されるときに例外がスローされます。ID は、検証コントロールと同じコンテナ内のコントロールを参照している必要があります。これは、同じページまたはユーザー コントロール内にあるか、テンプレート コントロールの同じテンプレート内にある必要があります。
-
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
![]() |
---|
検証する入力コントロールに対しては、System.Web.UI.ValidationPropertyAttribute 属性を適用する必要があります。 |
ControlToValidate プロパティで指定された入力コントロールにテキストが含まれていない場合、RequiredFieldValidator コントロールを除くすべての検証コントロールの検証が成功します。CustomValidator コントロールを使用する場合は、クライアント側の検証関数とサーバー側の検証関数のどちらも呼び出されません。
このプロパティをテーマ別またはスタイル シート テーマ別に設定することはできません。詳細については、ThemeableAttribute、ASP.NET のテーマとスキンの概要 の各トピックを参照してください。

ControlToValidate プロパティを使用して検証対象の入力コントロールを指定するコード例を次に示します。
<%@ 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>

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.ControlToValidateのページへのリンク