ASP.NET CustomValidator-Steuerelement
Validierungsserversteuerelement
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:
|
| 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.
Validierungsserversteuerelement Weitere Erweiterungen