RangeValidator クラス

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

RangeValidator クラス

他のコントロールの値が許容範囲に収まることを検証します。

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

Visual Basic (宣言)

Public Class RangeValidator
    Inherits BaseValidator

Visual Basic (使用法)

Dim instance As RangeValidator

C#

public class RangeValidator : BaseValidator

C++

public ref class RangeValidator : public
 BaseValidator

J#

public class RangeValidator extends BaseValidator

JScript

public class RangeValidator extends
 BaseValidator

解説

その範囲の最小値と最大値は、別のコントロールから直接取得されるか、別のコントロールへの参照によって取得されます。このクラスの動作は、System.Web.UI.WebControls.RangeValidator コントロールの動作と同じです。

既定では、サーバーにフォームが送信されると、Command コントロールは、検証を実行するための検証コントロールをフォーム上で発生させます。検証を自動的に実行しないようにするには、Command の CausesValidation プロパティを false に設定します。

使用例

MinimumValue プロパティを使用して、TextBox に入力された数値を検証する方法を次のコード例に示します。

メモ
次のコード サンプルはシングルファイル コード モデルを使用しており、分離コード ファイルに直接コピーされた場合は正常に動作しない可能性があります。このコード サンプルは、拡張子が .aspx の空のテキスト ファイルにコピーする必要があります。詳細については、「ASP.NET Web ページのコード モデル」を参照してください。

.NET Framework のセキュリティ

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

継承階層

System.Object
   System.Web.UI.Control
     System.Web.UI.MobileControls.MobileControl
       System.Web.UI.MobileControls.TextControl
         System.Web.UI.MobileControls.BaseValidator
          System.Web.UI.MobileControls.RangeValidator

スレッド セーフ

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

プラットフォーム

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

バージョン情報

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

参照

関連項目
RangeValidator メンバ
System.Web.UI.MobileControls 名前空間
BaseValidator クラス
CompareValidator クラス
RegularExpressionValidator
RequiredFieldValidator
ValidationSummary
その他の技術情報
RangeValidator コントロールの概要

RangeValidator クラス

入力コントロールの値が指定された範囲内の値であるかどうかをチェックします。

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

Visual Basic (宣言)

Public Class RangeValidator
    Inherits BaseCompareValidator

Visual Basic (使用法)

Dim instance As RangeValidator

C#

public class RangeValidator : BaseCompareValidator

C++

public ref class RangeValidator : public
 BaseCompareValidator

J#

public class RangeValidator extends BaseCompareValidator

JScript

public class RangeValidator extends
 BaseCompareValidator

解説

RangeValidator コントロールは、入力コントロールの値が指定された範囲内であるかどうかをテストします。

RangeValidator コントロールは 4 つのキー プロパティを使用して検証を実行します。ControlToValidate プロパティには検証対象である入力コントロールが格納されます。MinimumValue プロパティおよび MaximumValue プロパティでは、有効な範囲の最小値と最大値を指定します。

BaseCompareValidator.Type プロパティは、比較する値のデータ型を指定するために使用されます。比較する値は、検証が実行される前にこのデータ型に変換されます。比較できるデータ型の一覧を次の表に示します。

データ型	説明
String	文字列型
Integer	32 ビット符号付き整数型
Double	倍精度浮動小数点数型
Date	日付型
Currency	通貨記号を含めることができる 10 進数のデータ型

メモ
入力コントロールが空の場合、妥当性検査は成功します。RequiredFieldValidator コントロールを使用して、入力コントロールを必須フィールドにします。

メモ
MaximumValue プロパティまたは MinimumValue プロパティによって指定された値を、指定した BaseCompareValidator.Type に変換できない場合、RangeValidator コントロールは例外をスローします。

検証コントロールの追加情報については、BaseValidator のトピックを参照してください。

ユーザー補助

このコントロールに既定でレンダリングされるマークアップは、Web Content Accessibility Guidelines (WCAG) 1.0 の優先度 1 ガイドラインなどのユーザー補助に関する標準に適合しない可能性があります。このコントロールのユーザー補助サポートの詳細については、「ASP.NET コントロールとユーザー補助」を参照してください。

Topic	Location
チュートリアル : Web フォーム ページにおけるユーザーの入力の検証	Visual Studio での ASP .NET Web アプリケーションの作成
方法 : ASP.NET サーバー コントロールに必要なエントリを検証する	ASP .NET Web アプリケーションの作成
方法 : ASP.NET サーバー コントロールのカスタム検証メッセージを表示する	ASP .NET Web アプリケーションの作成
方法 : ASP.NET サーバー コントロールのデータベースの値を検証する	ASP .NET Web アプリケーションの作成
方法 : ASP.NET サーバー コントロールのデータ型を検証する	ASP .NET Web アプリケーションの作成
方法 : ASP.NET サーバー コントロールのパターンに対して検証する	ASP .NET Web アプリケーションの作成
方法 : ASP.NET サーバー コントロールの値の範囲を検証する	ASP .NET Web アプリケーションの作成
方法 : ASP.NET サーバー コントロールの固有の値を検証する	ASP .NET Web アプリケーションの作成
方法 : ASP.NET サーバー コントロールの埋め込み先メッセージのレイアウトを指定する	ASP .NET Web アプリケーションの作成
方法 : ASP.NET サーバー コントロールの有効性をプログラムでテストする	ASP .NET Web アプリケーションの作成
方法 : ASP.NET サーバー コントロールの検証エラー メッセージの書式を設定する	ASP .NET Web アプリケーションの作成
方法 : ASP.NET サーバー コントロールの検証を無効にする	ASP .NET Web アプリケーションの作成
方法 : ASP.NET サーバー コントロールをカスタム関数で検証する	ASP .NET Web アプリケーションの作成
方法 : ASP.NET サーバー コントロールをプログラムで検証する	ASP .NET Web アプリケーションの作成

使用例

Web ページに RangeValidator コントロールを作成して、入力コントロールに入力された値が比較範囲内であるかどうかを確認する方法を次の例に示します。

Visual Basic

<%@ Page Language="VB" AutoEventWireup="True"
 %>

<html>

<head>

   <script runat="server">

      Sub ButtonClick(sender As Object,
 e As EventArgs)

         If Page.IsValid Then
         
            Label1.Text="Page is valid."
         
         Else
         
            Label1.Text="Page is not valid!!"
         
         End If

      End Sub

   </script>

</head>

<body>

   <form runat="server">

      <h3>RangeValidator Example</h3>

      Enter a number from 1 to 10:

      <br>

      <asp:TextBox id="TextBox1"
           runat="server"/>

      <br>

      <asp:RangeValidator id="Range1"
           ControlToValidate="TextBox1"
           MinimumValue="1"
           MaximumValue="10"
           Type="Integer"
           EnableClientScript="false"
           Text="The value must be from 1 to 10!"
           runat="server"/>

      <br><br>

      <asp:Label id="Label1"
           runat="server"/>

      <br><br>

      <asp:Button id="Button1"
           Text="Submit"
           OnClick="ButtonClick"
           runat="server"/>
            

   </form>

</body>
</html>

C#

<%@ Page Language="C#" AutoEventWireup="True" %>

<html>

<head>

   <script runat="server">

      void ButtonClick(Object sender, EventArgs e)
      {

         if (Page.IsValid)
         {
            Label1.Text="Page is valid.";
         }
         else
         {
            Label1.Text="Page is not valid!!";
         }

      }

   </script>

</head>

<body>

   <form runat="server">

      <h3>RangeValidator Example</h3>

      Enter a number from 1 to 10:

      <br>

      <asp:TextBox id="TextBox1"
           runat="server"/>

      <br>

      <asp:RangeValidator id="Range1"
           ControlToValidate="TextBox1"
           MinimumValue="1"
           MaximumValue="10"
           Type="Integer"
           EnableClientScript="false"
           Text="The value must be from 1 to 10!"
           runat="server"/>

      <br><br>

      <asp:Label id="Label1"
           runat="server"/>

      <br><br>

      <asp:Button id="Button1"
           Text="Submit"
           OnClick="ButtonClick"
           runat="server"/>
            

   </form>

</body>
</html>

継承階層

System.Object
   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.RangeValidator

スレッド セーフ

この型の 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、1.1、1.0

参照

関連項目
RangeValidator メンバ
System.Web.UI.WebControls 名前空間
BaseValidator.ControlToValidate プロパティ
MaximumValue
MinimumValue
BaseCompareValidator.Type プロパティ
RequiredFieldValidator
BaseValidator クラス