Freigeben über


Eigenschaften von allgemeinen Validierungssteuerelementen

[Dieses Dokument dient lediglich Vorschauzwecken und kann in späteren Versionen geändert werden. Leere Themen sind als Platzhalter enthalten.]

Die in der folgenden Tabelle aufgelisteten Eigenschaften gelten für alle Validierungssteuerelemente.

Eigenschaften

ControlToValidate

Die programmgesteuerte ID des Eingabesteuerelements, die durch das Validierungssteuerelement überprüft wird. Ist diese ID keine zulässige ID, wird eine Ausnahme ausgelöst.

Display

Das Anzeigeverhalten des angegebenen Validierungssteuerelements. Diese Eigenschaft kann einen der folgenden Werte haben:

None – Das Validierungssteuerelement wird grundsätzlich nicht inline angezeigt. Verwenden Sie diese Option, wenn die Fehlermeldung nur in einem ValidationSummary-Steuerelement angezeigt werden soll.

Static – Das Validierungssteuerelement zeigt eine Fehlermeldung an, wenn die Validierung fehlschlägt. Dieser Fehlermeldung wird auf der Webseite Platz zugewiesen, selbst wenn das Eingabesteuerelement die Validierung besteht. Das Layout der Seite ändert sich nicht, wenn das Validierungssteuerelement die Fehlermeldung anzeigt. Da das Seitenlayout statisch ist, müssen mehrere Validierungssteuerelemente für das gleiche Eingabesteuerelement unterschiedliche physikalische Positionen auf der Seite belegen.

Dynamic – Das Validierungssteuerelement zeigt eine Fehlermeldung an, wenn die Validierung fehlschlägt. Wenn die Validierung fehlschlägt, wird der Fehlermeldung dynamisch Platz auf der Seite zugewiesen. Dadurch können mehrere Validierungssteuerelemente die gleiche physikalische Position auf der Seite gemeinsam nutzen.

NoteNote
Da der Platz für das Validierungssteuerelement dynamisch erstellt wird, ändert sich das physikalische Layout der Seite.Damit sich das Seitenlayout beim Anzeigen eines Validierungssteuerelements nicht ändert, muss für das HTML-Element, in dem sich das Validierungssteuerelement befindet, eine Größe angegeben werden, die für die maximale Größe des Validierungssteuerelements ausreicht.

EnableClientScript

Gibt an, ob die clientseitige Validierung aktiviert ist. Sie können die clientseitige Validierung für Browser deaktivieren, die diese Funktion unterstützen, indem Sie die EnableClientScript-Eigenschaft auf false festlegen.

Enabled

Gibt an, ob das Validierungssteuerelement aktiviert ist. Sie können unterbinden, dass das Validierungssteuerelement ein Eingabesteuerelement überprüft, indem Sie diese Eigenschaft auf false festlegen.

ErrorMessage

Die Fehlermeldung, die im ValidationSummary-Steuerelement angezeigt werden soll, wenn die Validierung fehlschlägt. Wenn die Text-Eigenschaft des Validierungssteuerelements nicht festgelegt ist, wird dieser Text außerdem im Validierungssteuerelement angezeigt, wenn die Validierung fehlschlägt. Die ErrorMessage-Eigenschaft wird in der Regel verwendet, um unterschiedliche Meldungen für das Validierungssteuerelement und das ValidationSummary-Steuerelement bereitzustellen.

NoteNote
Diese Eigenschaft führt keine Konvertierung von Sonderzeichen in HTML-Entitäten durch.So wird z. B. das Kleiner-als-Symbol (<) nicht automatisch in &lt; umgewandelt.Dadurch können Sie in die Werte dieser Eigenschaft HTML-Elemente einbetten, z. B. ein <img>-Element.

ForeColor

Gibt die Farbe an, in der die Inlinemeldung angezeigt werden soll, wenn die Validierung fehlschlägt.

IsValid

Gibt an, ob das durch die ControlToValidate-Eigenschaft angegebene Eingabesteuerelement als gültig ermittelt wird.

SetFocusOnError

Gibt an, ob der Fokus auf das von der ControlToValidate-Eigenschaft angegebene Steuerelement festgelegt wird, wenn die Validierung fehlschlägt.

Text

Ist diese Eigenschaft festgelegt, wird diese Meldung bei fehlgeschlagener Validierung im Validierungssteuerelement angezeigt. Ist diese Eigenschaft nicht festgelegt, wird der in der ErrorMessage-Eigenschaft angegebene Text in dem Steuerelement angezeigt.

ValidationGroup

Gibt den Namen der Validierungsgruppe an, zu der dieses Validierungssteuerelement gehört.

Siehe auch

Referenz

BaseValidator

Weitere Ressourcen

Syntax von Validierungs-Serversteuerelementen