ValidationSummary-Steuerelement (Allgemeine Referenz)
Aktualisiert: November 2007
Zeigt eine Liste aller Validierungsfehler auf der Webseite an.
<asp:ValidationSummary
AccessKey="string"
BackColor="color name|#dddddd"
BorderColor="color name|#dddddd"
BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
Inset|Outset"
BorderWidth="size"
CssClass="string"
DisplayMode="List|BulletList|SingleParagraph"
EnableClientScript="True|False"
Enabled="True|False"
EnableTheming="True|False"
EnableViewState="True|False"
Font-Bold="True|False"
Font-Italic="True|False"
Font-Names="string"
Font-Overline="True|False"
Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|
Large|X-Large|XX-Large"
Font-Strikeout="True|False"
Font-Underline="True|False"
ForeColor="color name|#dddddd"
HeaderText="string"
Height="size"
ID="string"
OnDataBinding="DataBinding event handler"
OnDisposed="Disposed event handler"
OnInit="Init event handler"
OnLoad="Load event handler"
OnPreRender="PreRender event handler"
OnUnload="Unload event handler"
runat="server"
ShowMessageBox="True|False"
ShowSummary="True|False"
SkinID="string"
Style="string"
TabIndex="integer"
ToolTip="string"
ValidationGroup="string"
Visible="True|False"
Width="size"
/>
Hinweise
Mit dem ValidationSummary-Steuerelement können Sie die Fehlermeldungen aller Validierungssteuerelemente an einer Stelle auf der Webseite zusammenfassen. Die Zusammenfassung wird abhängig vom Wert der DisplayMode-Eigenschaft als Liste, Aufzählung oder einzelner Absatz angezeigt. Die Fehlermeldung, die für die einzelnen Validierungssteuerelemente auf der Seite im ValidationSummary-Steuerelement angezeigt wird, wird durch die ErrorMessage-Eigenschaft des jeweiligen Steuerelements angegeben. Wenn die ErrorMessage-Eigenschaft des Validierungssteuerelements nicht festgelegt ist, wird im ValidationSummary-Steuerelement für dieses Validierungssteuerelement keine Fehlermeldung angezeigt. Sie können außerdem im Kopfzeilenabschnitt des ValidationSummary-Steuerelements einen benutzerdefinierten Titel angeben, indem Sie die HeaderText-Eigenschaft festlegen.
Sie können steuern, ob das ValidationSummary-Steuerelement angezeigt oder ausgeblendet wird, indem Sie die ShowSummary-Eigenschaft festlegen. Außerdem können Sie die Zusammenfassung in einem Meldungsfeld anzeigen, indem Sie die ShowMessageBox-Eigenschaft auf true festlegen.
Weitere Informationen zum ValidationSummary-Steuerelement finden Sie in den Erläuterungen zur System.Web.UI.WebControls.ValidationSummary-Klasse.
Beispiel
Das folgende Codebeispiel veranschaulicht, wie Sie mit dem ValidationSummary-Steuerelement eine Zusammenfassung der Eingabesteuerelemente anzeigen, die die Validierung nicht bestanden haben.
.gif "Sicherheitshinweis") Sicherheitshinweis: |
|---|
Dieses Beispiel enthält ein Textfeld, das eine Benutzereingabe akzeptiert. Diese stellt ein potenzielles Sicherheitsrisiko dar. Standardmäßig stellt die ASP.NET-Seite sicher, dass die Benutzereingabe keine Skript- oder HTML-Elemente enthält. Weitere Informationen finden Sie unter Übersicht über Skriptangriffe. |
<h3>ValidationSummary Sample</h3>
<br />
<form id="Form1" runat="server">
<table cellpadding="10">
<tr>
<td>
<table style="background-color:#eeeeee; padding: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="center" rowspan="1">
<asp:RequiredFieldValidator
id="RequiredFieldValidator1"
ControlToValidate="RadioButtonList1"
ErrorMessage="Card Type."
Display="Static"
InitialValue=""
Width="100%"
Text="*"
runat="server"/>
</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%"
Text="*"
runat="server"/>
</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"
EnableClientScript="true"
HeaderText="You must enter a value in the following fields:"
runat="server"/>
</td>
</tr>
</table>
</td>
</tr>
</table>
</form>
<h3>ValidationSummary Sample</h3>
<br />
<form id="Form1" runat="server">
<table cellpadding="10">
<tr>
<td>
<table style="background-color:#eeeeee; padding: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="center" rowspan="1">
<asp:RequiredFieldValidator
id="RequiredFieldValidator1"
ControlToValidate="RadioButtonList1"
ErrorMessage="Card Type."
Display="Static"
InitialValue=""
Width="100%"
Text="*"
runat="server"/>
</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%"
Text="*"
runat="server"/>
</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"
EnableClientScript="true"
HeaderText="You must enter a value in the following fields:"
runat="server"/>
</td>
</tr>
</table>
</td>
</tr>
</table>
</form>