ValidationSummary-Klasse
Zeigt eine Zusammenfassung aller bei der Validierung aufgetretenen Fehler inline auf einer Webseite und/oder in einem Meldungsfeld an.
Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)
Syntax
'Declaration
Public Class ValidationSummary
Inherits WebControl
'Usage
Dim instance As ValidationSummary
public class ValidationSummary : WebControl
public ref class ValidationSummary : public WebControl
public class ValidationSummary extends WebControl
public class ValidationSummary extends WebControl
Hinweise
Mit der ValidationSummary-Klasse werden die Fehlermeldungen von allen Validierungssteuerelementen an einer Position auf einer Webseite zusammengefasst. Sie können die Fehlermeldungen aus einer Gruppe von Validierungssteuerelementen auf einer Webseite zusammenfassen, indem Sie das ValidationSummary-Steuerelement durch Festlegen der ValidationGroup-Eigenschaft einer Validierungsgruppe zuweisen.
Gemäß der DisplayMode-Eigenschaft wird die Zusammenfassung als Liste, Aufzählung oder einzelner Absatz angezeigt.
Die Zusammenfassung kann auf der Webseite bzw. in einem Meldungsfeld angezeigt werden, indem die ShowSummary-Eigenschaft bzw. die ShowMessageBox-Eigenschaft festgelegt wird.
Eine Liste der anfänglichen Eigenschaftenwerte für eine Instanz von ValidationSummary finden Sie unter ValidationSummary-Konstruktor.
Beispiel
Im folgenden Codebeispiel wird veranschaulicht, wie mit einem ValidationSummary-Steuerelement die Fehlermeldungen von allen Validierungssteuerelementen auf einer Webseite zusammengefasst und als Aufzählung angezeigt werden.
<%@ Page Language="VB" AutoEventWireup="True" %>
<html>
<head>
</head>
<body>
<h3>ValidationSummary Sample</h3>
<p>
<form runat="server">
<table cellpadding=10>
<tr>
<td>
<table bgcolor="#eeeeee" cellpadding=10>
<tr>
<td colspan=3>
<b>Credit Card Information</b>
</td>
</tr>
<tr>
<td align=right>
Card Type:
</td>
<td>
<asp:RadioButtonList id=RadioButtonList1
RepeatLayout="Flow"
runat=server>
<asp:ListItem>MasterCard</asp:ListItem>
<asp:ListItem>Visa</asp:ListItem>
</asp:RadioButtonList>
</td>
<td align=middle rowspan=1>
<asp:RequiredFieldValidator
id="RequiredFieldValidator1"
ControlToValidate="RadioButtonList1"
ErrorMessage="Card Type. "
Display="Static"
InitialValue="" Width="100%" runat=server>
</asp:RequiredFieldValidator>
</td>
</tr>
<tr>
<td align=right>
Card Number:
</td>
<td>
<asp:TextBox id=TextBox1 runat=server />
</td>
<td>
<asp:RequiredFieldValidator
id="RequiredFieldValidator2"
ControlToValidate="TextBox1"
ErrorMessage="Card Number. "
Display="Static"
Width="100%" runat=server>
</asp:RequiredFieldValidator>
</td>
</tr>
<tr>
<td></td>
<td>
<asp:Button
id=Button1
text="Validate"
runat=server />
</td>
<td></td>
</tr>
</table>
</td>
<td valign=top>
<table cellpadding=20>
<tr>
<td>
<asp:ValidationSummary
id="valSum"
DisplayMode="BulletList"
runat="server"
HeaderText="You must enter a value in the following fields:"
Font-Name="verdana"
Font-Size="12"/>
</td>
</tr>
</table>
</td>
</tr>
</table>
</form>
</body>
</html>
<%@ Page Language="C#" AutoEventWireup="True" %>
<html>
<head>
</head>
<body>
<h3>ValidationSummary Sample</h3>
<p>
<form runat="server">
<table cellpadding=10>
<tr>
<td>
<table bgcolor="#eeeeee" cellpadding=10>
<tr>
<td colspan=3>
<b>Credit Card Information</b>
</td>
</tr>
<tr>
<td align=right>
Card Type:
</td>
<td>
<asp:RadioButtonList id=RadioButtonList1
RepeatLayout="Flow"
runat=server>
<asp:ListItem>MasterCard</asp:ListItem>
<asp:ListItem>Visa</asp:ListItem>
</asp:RadioButtonList>
</td>
<td align=middle rowspan=1>
<asp:RequiredFieldValidator
id="RequiredFieldValidator1"
ControlToValidate="RadioButtonList1"
ErrorMessage="Card Type. "
Display="Static"
InitialValue="" Width="100%" runat=server>
</asp:RequiredFieldValidator>
</td>
</tr>
<tr>
<td align=right>
Card Number:
</td>
<td>
<asp:TextBox id=TextBox1 runat=server />
</td>
<td>
<asp:RequiredFieldValidator
id="RequiredFieldValidator2"
ControlToValidate="TextBox1"
ErrorMessage="Card Number. "
Display="Static"
Width="100%" runat=server>
</asp:RequiredFieldValidator>
</td>
</tr>
<tr>
<td></td>
<td>
<asp:Button
id=Button1
text="Validate"
runat=server />
</td>
<td></td>
</tr>
</table>
</td>
<td valign=top>
<table cellpadding=20>
<tr>
<td>
<asp:ValidationSummary
id="valSum"
DisplayMode="BulletList"
runat="server"
HeaderText="You must enter a value in the following fields:"
Font-Name="verdana"
Font-Size="12"/>
</td>
</tr>
</table>
</td>
</tr>
</table>
</form>
</body>
</html>
Vererbungshierarchie
System.Object
System.Web.UI.Control
System.Web.UI.WebControls.WebControl
System.Web.UI.WebControls.ValidationSummary
Threadsicherheit
Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.
Plattformen
Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0
Siehe auch
Referenz
ValidationSummary-Member
System.Web.UI.WebControls-Namespace
ValidationSummaryDisplayMode
BaseValidator-Klasse
RequiredFieldValidator-Klasse
DisplayMode
ShowMessageBox
ShowSummary
WebControl