ValidationSummary, contrôle (Référence générale)
Mise à jour : novembre 2007
Affiche la liste des erreurs de validation sur la page Web.
<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"
/>
Notes
Le contrôle ValidationSummary permet de récapituler les messages d'erreur de tous les contrôles de validation d'une page Web, à un seul emplacement. Le résumé peut être affiché sous la forme d'une liste, d'une liste à puces ou d'un seul paragraphe, en fonction de la valeur de la propriété DisplayMode. Le message d'erreur affiché dans le contrôle ValidationSummary pour chaque contrôle de validation de la page est spécifié par la propriété ErrorMessage de chaque contrôle. Si la propriété ErrorMessage du contrôle de validation n'est pas définie, aucun message d'erreur n'est affiché dans le contrôle ValidationSummary de ce contrôle de validation. Vous pouvez également spécifier un titre personnalisé dans la section de titre du contrôle ValidationSummary en définissant la propriété HeaderText.
Vous pouvez déterminer si le contrôle ValidationSummary est affiché ou masqué en définissant la propriété ShowSummary. Le résumé peut également être affiché dans un message en affectant la valeur true à la propriété ShowMessageBox.
Pour plus d'informations sur le contrôle ValidationSummary, consultez la classe System.Web.UI.WebControls.ValidationSummary.
Exemple
L'exemple suivant montre comment utiliser le contrôle ValidationSummary pour récapituler les contrôles d'entrée de la page dont la validation a échoué.
.gif "Note de sécurité") Note de sécurité : |
|---|
Cet exemple a une zone de texte qui accepte l'entrée d'utilisateur, ce qui constitue une menace éventuelle pour la sécurité. Par défaut, les pages Web ASP.NET vérifient que les entrées d'utilisateur n'incluent pas de script ou d'éléments HTML. Pour plus d'informations, consultez Vue d'ensemble des attaques de script. |
<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>