ASP.NET RequiredFieldValidator-Steuerelement


Validation Server ControlsValidierungsserversteuerelement

Definition und Verwendung

Das Steuerelement RequiredFieldValidator wird verwendet, um ein Eingabesteuerelement zu einem Pflichtfeld zu machen.

Bei diesem Steuerelement schlägt die Validierung fehl, wenn sich der Anfangswert des Eingabewerts nicht geändert hat. Standardmäßig ist der Anfangswert eine leere Zeichenfolge ("").

Hinweis:Leerzeichen am Anfang und Ende des Eingabewerts werden vor der Validierung entfernt.

Hinweis:Die Eigenschaft InitialValue legt keinen Standardwert für das Eingabesteuerelement fest. Sie gibt den Wert an, den Sienichtmöchten, dass der Benutzer ihn in das Eingabesteuerelement eingibt.


Eigenschaften

Eigenschaft Beschreibung
BackColor Die Hintergrundfarbe des Steuerelements RequiredFieldValidator.
ControlToValidate Die ID des zu validierenden Steuerelements.
Anzeigen Das Anzeigeverhalten des Validierungssteuerelements. Gültige Werte sind:
  • None – Das Steuerelement wird nicht angezeigt. Wird nur im ValidationSummary-Steuerelement verwendet, um Fehlermeldungen 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 Platz für die Anzeige der Meldung ist im Voraus zugewiesen.
  • Dynamic – Wenn die Validierung fehlschlägt, zeigt das Steuerelement eine Fehlermeldung an. Wenn die Eingabe die Validierung besteht, wird kein Platz für die Anzeige der Meldung auf der Seite reserviert, d. h. der Platz für die Anzeige der Meldung 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.
InitialValue Gibt den Anfangswert (Startwert) des Eingabesteuerelements an. Der Standardwert ist "".
IsValid Ein boolescher Wert, der angibt, ob das durch ControlToValidate angegebene Steuerelement die Validierung besteht.
runat Gibt an, dass das Steuerelement ein Serversteuerelement ist. Muss auf "server" gesetzt werden.
Text Die Nachricht, die bei fehlgeschlagener Validierung angezeigt wird.


Beispiel

RequiredFieldValidator
In diesem Beispiel deklarieren wir zwei TextBox-Steuerelemente, ein Button-Steuerelement und ein RequiredFieldValidator-Steuerelement in der .aspx-Datei. Es veranschaulicht, wie das Steuerelement RequiredFieldValidator verwendet wird, um das Textfeld „txt_name“ zu einem Pflichtfeld zu machen.


Validation Server ControlsValidierungsserversteuerelement Weitere Erweiterungen