ValidationSummary コントロール
Web ページ上のすべての検証エラーのリストを表示します。
<asp:ValidationSummary
id="programmaticID" DisplayMode="BulletList | List | SingleParagraph" EnableClientScript="true | false" ShowSummary="true | false" ShowMessageBox="true | false" HeaderText="TextToDisplayAsSummaryTitle" runat="server"/>
解説
ValidationSummary コントロールを使用すると、Web ページ上にあるすべての検証コントロールから得られたエラー メッセージをまとめて表示できます。このエラー概要は、DisplayMode プロパティの値に基づいて、リスト、箇条書きリスト、または単一の段落として表示できます。ページ上の各検証コントロールに対して ValidationSummary コントロール内に表示されるエラー メッセージは、それぞれの検証コントロールの ErrorMessage プロパティで指定します。検証コントロールの ErrorMessage プロパティが設定されていない場合は、その検証コントロールに対して ValidationSummary コントロール内にエラー メッセージは表示されません。HeaderText プロパティを設定することにより、ValidationSummary コントロールの見出しセクションのカスタム タイトルも指定できます。
ValidationSummary コントロールを表示するか非表示にするかは、ShowSummary プロパティを設定することにより制御できます。ShowMessageBox プロパティを true に設定することで、エラー概要をメッセージ ボックスに表示することもできます。
ValidationSummay コントロールの詳細については、ValidationSummary クラスのトピックを参照してください。
例
ValidationSummary コントロールを使用して、ページ上の検証に失敗した入力コントロールについて、エラー概要を表示する方法を次の例に示します。
<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%"
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>
</body>
</html>