更新：2007 年 11 月
命名空間：
System.Web.UI.WebControls 組件：
System.Web (在 System.Web.dll 中)
<AspNetHostingPermissionAttribute(SecurityAction.InheritanceDemand, Level := AspNetHostingPermissionLevel.Minimal)> _
<AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level := AspNetHostingPermissionLevel.Minimal)> _
Public Class RangeValidator _
Inherits BaseCompareValidator
Dim instance As RangeValidator
[AspNetHostingPermissionAttribute(SecurityAction.InheritanceDemand, Level = AspNetHostingPermissionLevel.Minimal)]
[AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level = AspNetHostingPermissionLevel.Minimal)]
public class RangeValidator : BaseCompareValidator
[AspNetHostingPermissionAttribute(SecurityAction::InheritanceDemand, Level = AspNetHostingPermissionLevel::Minimal)]
[AspNetHostingPermissionAttribute(SecurityAction::LinkDemand, Level = AspNetHostingPermissionLevel::Minimal)]
public ref class RangeValidator : public BaseCompareValidator
/** @attribute AspNetHostingPermissionAttribute(SecurityAction.InheritanceDemand, Level = AspNetHostingPermissionLevel.Minimal) */
/** @attribute AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level = AspNetHostingPermissionLevel.Minimal) */
public class RangeValidator extends BaseCompareValidator
public class RangeValidator extends BaseCompareValidator
RangeValidator 控制項測試輸入控制項的值是否在指定的範圍內。
RangeValidator 控制項使用四個關鍵屬性執行它的驗證。ControlToValidate 屬性包含所要驗證的輸入控制項。MinimumValue 和 MaximumValue 屬性指定有效範圍的最小和最大值。
BaseCompareValidator..::.Type 屬性用來指定比較值的資料型別。比較值在執行驗證作業之前，將轉換至這個資料型別。
.gif "注意事項") 注意事項： |
|---|
當 Type 屬性設定為 Date，且目前日曆類型不為西曆時，驗證器僅執行伺服器端的驗證。驗證器用戶端指令碼僅支援西曆日曆。 |
下列表格列出可以比較的各種資料型別。
資料型別 | 說明 |
|---|
String | 字串資料型別。 |
Integer | 32 位元帶正負號的整數資料型別。 |
Double | 雙精度浮點數資料型別。 |
Date | 日期資料型別。 |
Currency | 可包含貨幣符號的十進位資料型別。 |
如需驗證控制項的額外資訊，請參閱 BaseValidator。
可及性
根據預設為這個控制項呈現的標記，可能與可及性標準 (例如 Web 內容可及性方針 1.0 (WCAG) 優先權 1 方針) 不一致。如需這個控制項之可及性支援的詳細資料，請參閱 ASP.NET 控制項和網頁可及性。
下列範例示範如何在 Web 網頁上建立 RangeValidator 控制項，檢查輸入至輸入控制項的值是否在比較範圍內。
.gif "安全性注意事項") 安全性注意事項： |
|---|
這個範例有一個可接受使用者輸入的文字方塊，這可能會造成安全性威脅。根據預設，ASP.NET Web 網頁會驗證使用者輸入未包含指令碼或 HTML 項目。如需詳細資訊，請參閱 指令碼攻擊概觀。 |
<%@ Page Language="VB" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html >
<head>
<title>RangeValidator Example</title>
<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 id="form1" 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>
<%@ Page Language="C#" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html >
<head>
<title>RangeValidator Example</title>
<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 id="form1" 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 Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98
.NET Framework 和 .NET Compact Framework 並不支援各種平台的所有版本。如需支援平台版本的相關資訊，請參閱 .NET Framework 系統需求。
.NET Framework
支援版本：3.5、3.0、2.0、1.1、1.0
參考