RangeValidator-Klasse
Überprüft, ob sich der Wert eines Eingabesteuerelements innerhalb eines angegebenen Wertebereichs befindet.
Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)
Syntax
'Declaration
Public Class RangeValidator
Inherits BaseCompareValidator
'Usage
Dim instance As RangeValidator
public class RangeValidator : BaseCompareValidator
public ref class RangeValidator : public BaseCompareValidator
public class RangeValidator extends BaseCompareValidator
public class RangeValidator extends BaseCompareValidator
Hinweise
Das RangeValidator-Steuerelement testet, ob sich der Wert eines Eingabesteuerelements innerhalb eines angegebenen Bereichs befindet.
Bei der Validierung durch das RangeValidator-Steuerelement werden vier Schlüsseleigenschaften verwendet. Die ControlToValidate-Eigenschaft enthält das zu validierende Eingabesteuerelement. Die MinimumValue-Eigenschaft und die MaximumValue-Eigenschaft geben den Mindest- und den Höchstwert des gültigen Bereichs an.
Mit der BaseCompareValidator.Type-Eigenschaft wird der Datentyp der zu vergleichenden Werte angegeben. Die zu vergleichenden Werte werden vor der Ausführung der Validierung in diesen Datentyp konvertiert. In der folgenden Tabelle werden die verschiedenen Datentypen aufgelistet, die verglichen werden können.
Datentyp |
Beschreibung |
|---|---|
String |
Ein String-Datentyp. |
Integer |
Ein ganzzahliger 32-Bit-Datentyp mit Vorzeichen. |
Double |
Ein Gleitkommazahl-Datentyp mit doppelter Genauigkeit. |
Date |
Ein Date-Datentyp. |
Currency |
Ein Dezimaldatentyp, der Währungssymbole enthalten kann. |
Hinweis
Die Validierung ist erfolgreich, wenn das Eingabesteuerelement leer ist. Mit einem RequiredFieldValidator-Steuerelement können Sie ein Eingabesteuerelement als erforderliches Feld festlegen.
Hinweis
Das RangeValidator-Steuerelement löst eine Ausnahme aus, wenn der durch die MaximumValue-Eigenschaft oder MinimumValue-Eigenschaft angegebene Wert nicht in den angegebenen BaseCompareValidator.Type konvertiert werden kann.
Weitere Informationen zu Validierungssteuerelementen finden Sie unter BaseValidator.
Eingabehilfen
Das für dieses Steuerelement standardmäßig wiedergegebene Markup entspricht eventuell nicht den Standards für die Eingabehilfen wie beispielsweise den Richtlinien der Web Content Accessibility Guidelines 1.0 (WCAG) mit der Priorität 1. Details über die Unterstützung von Eingabehilfen für dieses Steuerelement finden Sie unter Steuerelemente und Eingabehilfen von ASP.NET.
Beispiel
Im folgenden Beispiel wird veranschaulicht, wie auf der Webseite ein RangeValidator-Steuerelement erstellt wird, um festzustellen, ob sich der in ein Eingabesteuerelement eingegebene Wert innerhalb des Vergleichsbereichs befindet.
<%@ 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>
<%@ 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>
Vererbungshierarchie
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
Threadsicherheit
Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.
Plattformen
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 unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0
Siehe auch
Referenz
RangeValidator-Member
System.Web.UI.WebControls-Namespace
BaseValidator.ControlToValidate-Eigenschaft
MaximumValue
MinimumValue
BaseCompareValidator.Type-Eigenschaft
RequiredFieldValidator
BaseValidator-Klasse