ASP.NET RegularExpressionValidatorControl


Validation Server ControlsValidierungsserversteuerelement

Definition und Verwendung

Das RegularExpressionValidator-Steuerelement wird verwendet, um zu überprüfen, ob der Eingabewert einem bestimmten Muster entspricht.

Hinweis:Es werden sowohl serverseitige als auch clientseitige Validierungen durchgeführt, es sei denn, der Browser unterstützt keine clientseitige Validierung oder die EnableClientScript-Eigenschaft ist auf false gesetzt.

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


Eigenschaften

Eigenschaften Beschreibung
BackColor Die Hintergrundfarbe des Steuerelements RegularExpressionValidator.
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 die 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 die Fehlermeldung an. Wenn die Eingabe die Validierung besteht, wird kein Platz für die Anzeige der Meldung auf der Seite reserviert, d. h. der für die Anzeige der Meldung verwendete Platz wird dynamisch hinzugefügt.
EnableClientScript Ein boolescher Wert, der angibt, ob die clientseitige Validierung aktiviert ist.
Enabled Ein boolescher Wert, der angibt, ob das Validierungssteuerelement aktiviert ist.
ErrorMessage Der Text, der im Steuerelement ValidationSummary angezeigt wird, wenn die Validierung fehlschlägt.Hinweis:Wenn die Eigenschaft Text nicht festgelegt ist, wird der Text auch im Validierungssteuerelement angezeigt.
ForeColor Die Vordergrundfarbe des Steuerelements.
id Die eindeutige ID des Steuerelements.
IsValid Ein boolescher Wert, der angibt, ob das durch ControlToValidate angegebene Steuerelement die Validierung besteht.
runat Gibt an, dass es sich bei diesem Steuerelement um ein Serversteuerelement handelt. Muss auf "server" gesetzt werden.
BackColor Die Hintergrundfarbe des Steuerelements RegularExpressionValidator.
Text Die Nachricht, die bei fehlgeschlagener Validierung angezeigt wird.
ValidationExpression Gibt den regulären Ausdruck an, der zum Validieren des Eingabesteuerelements verwendet wird. Die Syntax des Ausdrucks ist auf dem Client und dem Server unterschiedlich. Auf dem Client wird JScript verwendet. Auf dem Server wird er gemäß der von Ihnen angegebenen Sprache verwendet.


Beispiel

RegularExpressionValidator
In diesem Beispiel deklarieren wir ein TextBox-Steuerelement, ein Button-Steuerelement, ein Label-Steuerelement und ein RegularExpressionValidator-Steuerelement in einer .aspx-Datei. Die Funktion submit() prüft, ob die Seite gültig ist. Wenn sie gültig ist, gibt sie „The page is valid!“ im Label-Steuerelement zurück. Wenn sie nicht gültig ist, gibt sie „The page is not valid!“ im Label-Steuerelement zurück. Wenn die Validierung fehlschlägt, wird der Text „The zip code must be 5 numeric digits!“ im RegularExpressionValidator-Steuerelement angezeigt.


Validation Server ControlsValidierungsserversteuerelement Weitere Erweiterungen