Eigenschaften von allgemeinen Validierungssteuerelementen
Aktualisiert: November 2007
Die in der folgenden Tabelle aufgelisteten Eigenschaften gelten für alle Validierungssteuerelemente.
Eigenschaften
Die programmgesteuerte ID des Eingabesteuerelements, die durch das Validierungssteuerelement überprüft wird. Ist diese ID keine zulässige ID, wird eine Ausnahme ausgelöst. |
|
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. Tipp 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. |
|
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. |
|
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. |
|
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. Tipp Diese Eigenschaft führt keine Konvertierung von Sonderzeichen in HTML-Entitäten durch. So wird z. B. das Kleiner-als-Symbol (<) nicht automatisch in < umgewandelt. Dadurch können Sie in die Werte dieser Eigenschaft HTML-Elemente einbetten, z. B. ein <img>-Element. |
|
Gibt die Farbe an, in der die Inlinemeldung angezeigt werden soll, wenn die Validierung fehlschlägt. |
|
Gibt an, ob das durch die ControlToValidate-Eigenschaft angegebene Eingabesteuerelement als gültig ermittelt wird. |
|
Gibt an, ob der Fokus auf das von der ControlToValidate-Eigenschaft angegebene Steuerelement festgelegt wird, wenn die Validierung fehlschlägt. |
|
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. |
|
Gibt den Namen der Validierungsgruppe an, zu der dieses Validierungssteuerelement gehört. |