RangeValidator クラス
入力コントロールの値が指定された範囲内の値であるかどうかをチェックします。
この型のすべてのメンバの一覧については、RangeValidator メンバ を参照してください。
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 Class RangeValidator
Inherits BaseCompareValidator
[C#]
public class RangeValidator : BaseCompareValidator
[C++]
public __gc class RangeValidator : public BaseCompareValidator
[JScript]
public class RangeValidator extends BaseCompareValidator
スレッドセーフ
この型の public static (Visual Basicでは Shared) のすべてのメンバは、マルチスレッド操作で安全に使用できます。インスタンスのメンバの場合は、スレッドセーフであるとは限りません。
解説
RangeValidator コントロールは、入力コントロールの値が指定された範囲内であるかどうかをテストします。
RangeValidator コントロールは 4 つのキー プロパティを使用して検証を実行します。 ControlToValidate プロパティには検証対象である入力コントロールが格納されます。 MinimumValue プロパティおよび MaximumValue プロパティでは、有効な範囲の最小値と最大値を指定します。
BaseCompareValidator.Type プロパティは、比較する値のデータ型を指定するために使用されます。比較する値は、検証が実行される前にこのデータ型に変換されます。比較できるデータ型の一覧を次の表に示します。
| データ型 | 説明 |
|---|---|
| String | 文字列型 |
| Integer | 32 ビット符号付き整数型 |
| Double | 倍精度浮動小数点数型 |
| Date | 日付型 |
| Currency | 通貨記号を含めることができる 10 進数のデータ型 |
メモ 入力コントロールが空の場合、妥当性検査は成功します。 RequiredFieldValidator コントロールを使用して、入力コントロールを必須フィールドにします。
メモ MaximumValue プロパティまたは MinimumValue プロパティによって指定された値を、指定した BaseCompareValidator.Type に変換できない場合、 RangeValidator コントロールは例外をスローします。
検証コントロールの追加情報については、 BaseValidator のトピックを参照してください。
使用例
[Visual Basic, C#] Web ページに RangeValidator コントロールを作成して、入力コントロールに入力された値が比較範囲内であるかどうかを確認する方法を次の例に示します。
<%@ 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>
[C++, JScript] C++ および JScript のサンプルはありません。Visual Basic および C# のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン .gif)
をクリックします。
必要条件
名前空間: System.Web.UI.WebControls
プラットフォーム: Windows 2000, Windows XP Professional, Windows Server 2003 ファミリ
アセンブリ: System.Web (System.Web.dll 内)
参照
RangeValidator メンバ | System.Web.UI.WebControls 名前空間 | ControlToValidate | MaximumValue | MinimumValue | BaseCompareValidator.Type | RequiredFieldValidator | BaseValidator