Ovládací prvek ValidationSummary (obecná reference)
Zobrazí seznam všech chyb ověřování na webové stránce.
<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"
/>
Poznámky
Ovládací prvek ValidationSummary umožňuje sbírat chybové zprávy ze všech ověřovacích ovládacích prvků webové stránky na jediném místě. Souhrn lze zobrazit jako seznam, seznam s odrážkami nebo jako jeden odstavec. To záleží na hodnotě vlastnosti DisplayMode. Chybová zpráva zobrazená v ovládacím prvku ValidationSummary pro každý ověřovací ovládací prvek na stránce, je určena vlastností ErrorMessage každého ověřovacího ovládacího prvku. Pokud není vlastnost ErrorMessage ověřovacího ovládacího prvku nastavena, nezobrazí se žádná chybová zpráva v ovládacím prvku ValidationSummary pro daný ověřovací ovládací prvek. Můžete také zadat vlastní titulek v oddílu nadpisu ovládacího prvku ValidationSummary nastavením vlastnosti HeaderText.
Můžete určit, zda je ovládací prvek ValidationSummary zobrazen či skryt, nastavením vlastnosti ShowSummary. Souhrn lze rovněž zobrazit v okně se zprávou nastavením vlastnosti ShowMessageBox na true.
Další informace o ovládacím prvku ValidationSummary naleznete v popisu třídy System.Web.UI.WebControls.ValidationSummary.
Příklad
Následující příklad kódu demonstruje použití ovládacího prvku ValidationSummary pro sumarizaci vstupních ovládacích prvků, u kterých na stránce selhalo ověřování.
.gif "Poznámka k zabezpečení") Poznámka k zabezpečení |
|---|
Tento příklad obsahuje textové pole přijímající vstup uživatele, což představuje potencionální bezpečnostní riziko.Ve výchozím nastavení webové stránky technologie ASP.NET ověřují, že vstup uživatele neobsahuje skript nebo prvky jazyka HTML.Další informace naleznete v tématu Přehled zneužití skriptů. |
<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>