Gewusst wie: Steuern der Anzeige von Validierungsfehlermeldungen für ASP.NET-Serversteuerelemente
Aktualisiert: November 2007
In Microsoft Visual Web Developer können Sie Fehlermeldungstext auf vier verschiedene Arten darstellen, die in der folgenden Tabelle beschrieben sind.
Anzeigemethode |
Beschreibung |
|---|---|
Inline |
Die Fehlermeldung wird neben dem Steuerelement an der Stelle angezeigt, an der sich das Validierungssteuerelement befindet. |
Zusammenfassung |
Die Fehlermeldung wird in einer gesonderten Zusammenfassung aller Fehler angezeigt, die nur verfügbar ist, wenn der Benutzer die Seite sendet. Optional kann die Fehlermeldung in einem Meldungsfeld angezeigt werden. Diese Option ist jedoch nur in Browsern verfügbar, die Dynamic HTML (DHTML) unterstützen. |
Inline und Zusammenfassung |
Die Fehlermeldung kann in der Zusammenfassung und inline unterschiedlich dargestellt werden. Sie können diese Option verwenden, um eine kurze Fehlermeldung inline und eine ausführliche Fehlermeldung in der Zusammenfassung anzuzeigen oder um ein Fehlerschriftzeichen neben dem Eingabefeld und eine Fehlermeldung in der Zusammenfassung anzuzeigen. |
Benutzerdefiniert |
Sie können eine eigene Anzeige für Fehlermeldungen erstellen. Weitere Informationen finden Sie unter Gewusst wie: Anzeigen von benutzerdefinierten Validierungsmeldungen des Servers für ASP.NET-Serversteuerelemente. |
Wenn Sie Fehlermeldungen in einer Zusammenfassung anzeigen möchten, müssen Sie ein Steuerelement zur Seite hinzufügen.
So zeigen Sie eine Zusammenfassung von Fehlermeldungen an
Fügen Sie an der Stelle ein ValidationSummary-Steuerelement zu der Seite hinzu, an der die erfassten Fehlermeldungen angezeigt werden sollen.
Legen Sie die ErrorMessage-Eigenschaft und die Display-Eigenschaft der einzelnen Validierungssteuerelemente fest.
Legen Sie die DisplayMode-Eigenschaft des Zusammenfassungssteuerelements zum Formatieren der Fehlermeldungen fest, und verwenden Sie dabei einen der folgenden Werte, die in der ValidationSummaryDisplayMode-Auflistung definiert sind:
Wert
Anzeige
BulletList
(Standard) Alle Fehlermeldungen werden in einer Aufzählung aufgeführt.
List
Jede Fehlermeldung steht in einer eigenen Zeile.
SingleParagraph
Jede Fehlermeldung wird als Satz in einem Abschnitt angezeigt.
Wenn Sie Validierungsgruppen einzelne Validierungssteuerelemente zuordnen, müssen Sie ein ValidationSummary-Steuerelement für jede Validierungsgruppe verwenden.
Um Fehlermeldungen inline und als Zusammenfassung anzuzeigen, müssen Sie verschiedene Kombinationen von Eigenschaften in den einzelnen Validierungssteuerelementen festlegen.
So zeigen Sie Fehlermeldungen inline und als Zusammenfassung an
Fügen Sie ein ValidationSummary-Steuerelement hinzu, wie in der vorherigen Vorgehensweise beschrieben.
Legen Sie die Eigenschaften ErrorMessage, Text und Display der einzelnen Validierungssteuerelemente entsprechend der folgenden Tabelle fest:
Option
Erfordert das ValidationSummary-Steuerelement
Eigenschafteneinstellungen im Validierungssteuerelement
Nur Inline
Nein
Display = Static oder Dynamic
ErrorMessage = <Fehlertext> oder Text = <Fehlertext>
Nur Zusammenfassung (einschließlich optionales Meldungsfeld)
Ja
Display = None
ErrorMessage = <Fehlertext> oder Text = <Fehlertext>
Inline und Zusammenfassung (einschließlich optionales Meldungsfeld)
Ja
Display = Static oder Dynamic
ErrorMessage = <Fehlertext für Zusammenfassung>
Text = <Inlinefehlertext oder Symbol>
Wenn auf dem Client ein Browser ausgeführt wird, der DHTML unterstützt, können zusammengefasste Fehlermeldungen auch in einem Meldungsfeld angezeigt werden.
So zeigen Sie Zusammenfassungen von Fehlermeldungen in einem Meldungsfeld an
Legen Sie die ShowMessageBox-Eigenschaft des ValidationSummary-Steuerelements auf true fest.
Wenn der Benutzer die Seite sendet, werden Fehler im ValidationSummary-Steuerelement und im Meldungsfeld angezeigt.
Um zusammengefasste Fehlermeldungen nur in einem Meldungsfeld anzuzeigen, legen Sie die ShowSummary-Eigenschaft auf false fest.
Siehe auch
Aufgaben
Gewusst wie: Angeben des Layouts für direkte Meldungen in ASP.NET-Serversteuerelementen