RangeValidator-Steuerelement (Allgemeine Referenz)
Evaluiert den Wert eines Eingabesteuerelements, um zu bestimmen, ob er zwischen der angegebenen Ober- und Untergrenze liegt.
<asp:RangeValidator
AccessKey="string"
BackColor="color name|#dddddd"
BorderColor="color name|#dddddd"
BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
Inset|Outset"
BorderWidth="size"
ControlToValidate="string"
CssClass="string"
CultureInvariantValues="True|False"
Display="None|Static|Dynamic"
EnableClientScript="True|False"
Enabled="True|False"
EnableTheming="True|False"
EnableViewState="True|False"
ErrorMessage="string"
Font-Bold="True|False"
Font-Italic="True|False"
Font-Names="string"
Font-Overline="True|False"
Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|
Large|X-Large|XX-Large"
Font-Strikeout="True|False"
Font-Underline="True|False"
ForeColor="color name|#dddddd"
Height="size"
ID="string"
MaximumValue="string"
MinimumValue="string"
OnDataBinding="DataBinding event handler"
OnDisposed="Disposed event handler"
OnInit="Init event handler"
OnLoad="Load event handler"
OnPreRender="PreRender event handler"
OnUnload="Unload event handler"
runat="server"
SetFocusOnError="True|False"
SkinID="string"
Style="string"
TabIndex="integer"
Text="string"
ToolTip="string"
Type="String|Integer|Double|Date|Currency"
ValidationGroup="string"
Visible="True|False"
Width="size"
/>
Hinweise
Mit dem RangeValidator-Steuerelement können Sie überprüfen, ob die Eingabe eines Benutzers zwischen einer angegebenen Ober- und Untergrenze liegt. Sie können Bereiche innerhalb von Zahlenpaaren, alphabetischen Zeichen und Datumsangaben überprüfen. Die Grenzwerte werden als Konstanten ausgedrückt.
Mithilfe der ControlToValidate-Eigenschaft wird das zu validierende Eingabesteuerelement angegeben. Die MinimumValue-Eigenschaft und die MaximumValue-Eigenschaft geben dabei den Mindestwert bzw. den Höchstwert des gültigen Bereichs an.
Die Type-Eigenschaft gibt den Datentyp der Werte an, die verglichen werden sollen. Die zu vergleichenden Werte werden vor der Ausführung des Vergleichs in diesen Datentyp konvertiert.
Hinweis |
---|
Wenn das Eingabesteuerelement leer ist, werden keine Validierungsfunktionen aufgerufen, und die Validierung wird erfolgreich durchgeführt.Verwenden Sie ein RequiredFieldValidator-Steuerelement, um zu verhindern, dass der Benutzer ein Eingabesteuerelement überspringt. |
Hinweis |
---|
Das RangeValidator-Steuerelement löst eine Ausnahme aus, wenn der von der MaximumValue-Eigenschaft oder der MinimumValue-Eigenschaft angegebene Wert nicht in den Datentyp konvertiert werden kann, der von der Type-Eigenschaft angegeben wird.Wenn beispielsweise die Type-Eigenschaft eines RangeValidator-Steuerelements auf "Currency" festgelegt ist, müssen die MinimumValue-Eigenschaft und die MaximumValue-Eigenschaft in einem Format bereitgestellt werden, das in NumberFormatInfo.CurrencyDecimalDigits beschrieben ist. Andernfalls wird eine Ausnahme ausgelöst. |
Weitere Informationen zum RangeValidator-Steuerelement finden Sie unter der System.Web.UI.WebControls.RangeValidator-Klasse.
Beispiel
Das folgende Beispiel veranschaulicht, wie Sie mit demRangeValidator-Steuerelement überprüfen, ob der in einem Textfeld eingegebene Wert zwischen 1 und 10 liegt. Das Ergebnis der Validierung wird anschließend auf der Seite ausgegeben.
Sicherheitshinweis |
---|
Dieses Beispiel enthält ein Textfeld, das eine Benutzereingabe akzeptiert. Diese stellt ein potenzielles Sicherheitsrisiko dar.Standardmäßig stellt die ASP.NET-Seite sicher, dass die Benutzereingabe keine Skript- oder HTML-Elemente enthält.Weitere Informationen finden Sie unter Übersicht über Skriptangriffe. |
<%@ 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 xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>RangeValidator Control (General Reference)</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"/>
<p />
<asp:Label id="Label1"
runat="server"/>
<p />
<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 xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>RangeValidator Control (General Reference)</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"/>
<p />
<asp:Label id="Label1"
runat="server"/>
<p />
<asp:Button id="Button1"
Text="Submit"
OnClick="ButtonClick"
runat="server"/>
</form>
</body>
</html>