RangeValidator-Steuerelement (Allgemeine Referenz)
[Dieses Dokument dient lediglich Vorschauzwecken und kann in späteren Versionen geändert werden. Leere Themen sind als Platzhalter enthalten.]
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.
.gif "Sicherheitshinweis") Sicherheitshinweis |
|---|
In diesem Beispiel ist ein Textfeld für eine Benutzereingabe enthalten. Dies 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 Script Exploits Overview. |
<%@ 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>