BaseValidator.ControlToValidateとは何？わかりやすく解説 Weblio辞書

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

索引トップ用語の索引ランキング

BaseValidator.ControlToValidate プロパティ

検証するコントロールの ID を取得または設定します。既定値は Empty です。

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

Visual Basic (宣言)

<BindableAttribute(False)> _
Public Property ControlToValidate As
 String

Visual Basic (使用法)

Dim instance As BaseValidator
Dim value As String

value = instance.ControlToValidate

instance.ControlToValidate = value

[BindableAttribute(false)] 
public string ControlToValidate { get;
 set; }

C++

[BindableAttribute(false)] 
public:
property String^ ControlToValidate {
    String^ get ();
    void set (String^ value);
}

/** @property */
public String get_ControlToValidate ()

/** @property */
public void set_ControlToValidate (String value)

JScript

public function get ControlToValidate
 () : String

public function set ControlToValidate
 (value : String)

プロパティ値
検証するコントロールの ID。

解説

ID が空または無効な場合は、レンダリングの前処理中に例外が発生します。

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1

参照

関連項目
BaseValidator クラス
BaseValidator メンバ
System.Web.UI.MobileControls 名前空間
BaseValidator
その他の技術情報
検証コントロール

BaseValidator.ControlToValidate プロパティ

検証対象の入力コントロールを取得または設定します。

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

Visual Basic (宣言)

<ThemeableAttribute(False)> _
Public Property ControlToValidate As
 String

Visual Basic (使用法)

Dim instance As BaseValidator
Dim value As String

value = instance.ControlToValidate

instance.ControlToValidate = value

[ThemeableAttribute(false)] 
public string ControlToValidate { get;
 set; }

C++

[ThemeableAttribute(false)] 
public:
property String^ ControlToValidate {
    String^ get ();
    void set (String^ value);
}

/** @property */
public String get_ControlToValidate ()

/** @property */
public void set_ControlToValidate (String value)

JScript

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 のテーマとスキンの概要の各トピックを参照してください。

Topic	Location
チュートリアル : Web フォームページにおけるユーザーの入力の検証	Visual Studio での ASP .NET Web アプリケーションの作成

使用例

ControlToValidate プロパティを使用して検証対象の入力コントロールを指定するコード例を次に示します。

Visual Basic

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

JScript

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

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
BaseValidator クラス
BaseValidator メンバ
System.Web.UI.WebControls 名前空間
String.Empty
System.Web.UI.ValidationPropertyAttribute
RequiredFieldValidator
CustomValidator

>> 「BaseValidator.ControlToValidate」を含む用語の索引
BaseValidator.ControlToValidateのページへのリンク

BaseValidator.ControlToValidateとは？わかりやすく解説

BaseValidator.ControlToValidate プロパティ

BaseValidator.ControlToValidate プロパティ

「BaseValidator.ControlToValidate」の関連用語


	© 2024 Microsoft.All rights reserved.

BaseValidator.ControlToValidateとは？ わかりやすく解説

BaseValidator.ControlToValidate プロパティ

BaseValidator.ControlToValidate プロパティ

急上昇のことば

「BaseValidator.ControlToValidate」の関連用語

BaseValidator.ControlToValidateとは？わかりやすく解説