ASP.NET RangeValidatorControl


Validation Server ControlsValidierungsserversteuerelemente

Definition und Verwendung

Das RangeValidator-Steuerelement wird verwendet, um zu überprüfen, ob der vom Benutzer eingegebene Wert zwischen zwei Werten liegt. Es kann Werte verschiedener Typen wie Zahlen, Daten und Zeichen vergleichen.

Hinweis:Wenn das Eingabesteuerelement leer ist, schlägt die Validierung nicht fehl. Verwenden Sie das RequiredFieldValidator-Steuerelement, um das Feld als Pflichtfeld festzulegen.

Hinweis:Wenn der Eingabewert nicht in den angegebenen Datentyp konvertiert werden kann, schlägt die Validierung nicht fehl. Verwenden Sie das CompareValidator-Steuerelement und setzen Sie dessen Operator-Eigenschaft auf ValidationCompareOperator.DataTypeCheck, um den Datentyp des Eingabewerts zu überprüfen.


Eigenschaften

Eigenschaft Beschreibung
BackColor Die Hintergrundfarbe des RangeValidator-Steuerelements.
ControlToValidate Die ID des zu validierenden Steuerelements.
Anzeigen Das Anzeigeverhalten des Validierungssteuerelements. Gültige Werte sind:
  • None – Das Steuerelement wird nicht angezeigt. Es wird nur verwendet, um Fehlermeldungen im ValidationSummary-Steuerelement anzuzeigen.
  • Static – Wenn die Validierung fehlschlägt, zeigt das Steuerelement eine Fehlermeldung an. Selbst wenn die Eingabe die Validierung besteht, wird auf der Seite Platz für die Anzeige der Meldung reserviert, d. h. der für die Anzeige der Meldung verwendete Platz ist im Voraus zugewiesen.
  • Dynamic – Wenn die Validierung fehlschlägt, zeigt das Steuerelement eine Fehlermeldung an. Wenn die Eingabe die Validierung besteht, wird auf der Seite kein Platz für die Anzeige der Meldung reserviert, d. h. der Platz für die Anzeige der Meldung wird dynamisch hinzugefügt.
EnableClientScript Boolescher Wert, der angibt, ob die clientseitige Validierung aktiviert ist.
Enabled Boolescher Wert, der angibt, ob das Validierungssteuerelement aktiviert ist.
ErrorMessage Der Text, der im ValidationSummary-Steuerelement angezeigt werden soll, wenn die Validierung fehlschlägt.Hinweis:Wenn die Text-Eigenschaft nicht festgelegt ist, wird der Text auch im Validierungssteuerelement angezeigt.
ForeColor Die Vordergrundfarbe des Steuerelements.
id Die eindeutige ID des Steuerelements.
IsValid Boolescher Wert, der angibt, ob das durch ControlToValidate angegebene Steuerelement die Validierung besteht.
MaximumValue Gibt den Maximalwert des Eingabesteuerelements an.
MinimumValue Gibt den Minimalwert des Eingabesteuerelements an.
runat Gibt an, dass das Steuerelement ein Serversteuerelement ist. Muss auf "server" gesetzt werden.
Type Gibt den Datentyp des zu überprüfenden Werts an. Die Typen sind:
  • Currency
  • Date
  • Double
  • Integer
  • String
Text Die Nachricht, die angezeigt werden soll, wenn die Validierung fehlschlägt.


Beispiele

RangeValidator
In diesem Beispiel deklarieren wir ein TextBox-Steuerelement, ein Button-Steuerelement und ein RangeValidator-Steuerelement in einer .aspx-Datei. Wenn die Validierung fehlschlägt, wird der Text "The date must be between 1/1/2002 and 31/5/2002!" im RangeValidator-Steuerelement angezeigt.

RangeValidator 2
In diesem Beispiel deklarieren wir ein TextBox-Steuerelement, ein Button-Steuerelement, ein Label-Steuerelement und ein RangeValidator-Steuerelement in einer .aspx-Datei. Die Funktion submit() kann erkennen, ob die Seite gültig ist. Wenn sie gültig ist, gibt sie "The page is valid!" im Label-Steuerelement zurück. Wenn sie ungültig ist, gibt sie "The page is not valid!" im Label-Steuerelement zurück. Wenn die Validierung fehlschlägt, wird "The value must be from 1 to 100!" im RangeValidator-Steuerelement angezeigt.


Validation Server ControlsValidierungsserversteuerelemente Weitere Erweiterungen