ASP.NET CustomValidator-Steuerelement


Validation Server ControlsValidierungsserversteuerelement

Definition und Verwendung

Das CustomValidator-Steuerelement ermöglicht es Ihnen, Methoden zu schreiben, die die Validierung von Eingabewerten handhaben.


Eigenschaften

Eigenschaften Beschreibung
BackColor Die Hintergrundfarbe des CustomValidator-Steuerelements.
ClientValidationFunction Gibt den Namen der auszuführenden clientseitigen Skriptfunktion an.Hinweis:Das Skript muss in einer vom Browser unterstützten Sprache wie VBScript oder JScript geschrieben sein.

Bei Verwendung von VBScript muss sich die Funktion innerhalb des Formulars befinden:

Sub FunctionName (source, arguments)

Bei Verwendung von JScript muss sich die Funktion innerhalb des Formulars befinden:

Function FunctionName (source, arguments)

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 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 auf der Seite kein Platz für die Meldung reserviert, d. h. der für die 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 ValidationSummary-Steuerelement angezeigt wird, 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 Ein boolescher Wert, der angibt, ob das durch ControlToValidate angegebene Steuerelement die Validierung besteht.
OnServerValidate Gibt den Namen der auszuführenden serverseitigen Validierungsskriptfunktion an.
runat Gibt an, dass das Steuerelement ein Serversteuerelement ist. Muss auf "server" gesetzt werden.
Text Die Nachricht, die bei fehlgeschlagener Validierung angezeigt wird.


Beispiel

CustomValidator
In diesem Beispiel deklarieren wir zwei Label-Steuerelemente, ein TextBox-Steuerelement, ein Button-Steuerelement und ein CustomValidator-Steuerelement in der .aspx-Datei. Die Funktion user() kann die Länge des Eingabewerts erkennen. Wenn die Länge kleiner als 8 oder größer als 16 ist, wird der Text „A username must be between 8 and 16 characters!“ im CustomValidator-Steuerelement angezeigt.


Validation Server ControlsValidierungsserversteuerelement Weitere Erweiterungen