ASP.NET ValidationSummary 控件

定义和用法

ValidationSummary 控件用于在网页、消息框或在这两者中内联显示所有验证错误的摘要。

在该控件中显示的错误消息是由每个验证控件的 ErrorMessage 属性规定的。如果未设置验证控件的 ErrorMessage 属性,就不会为那个验证控件显示错误消息。

属性

属性 描述
DisplayMode 如何显示摘要。合法值有: - BulletList - List - SingleParagraph
EnableClientScript 布尔值,规定是否启用客户端验证。
Enabled 布尔值,规定是否启用验证控件。
ForeColor 该控件的前景色。
HeaderText ValidationSummary 控件中的标题文本。
id 控件的唯一 id。
runat 规定该控件是一个服务器控件。必须设置为 "server"。
ShowMessageBox 布尔值,指示是否在消息框中显示验证摘要。
ShowSummary 布尔值,规定是否显示验证摘要。

实例

  • Validationsummary

    在本例中,我们使用 ValidationSummary 控件生成了一个用户未填的必选字段的列表。

  1. <html>
  2. <body>
  3. <form runat="server">
  4. <table>
  5. <tr>
  6. <td>
  7. <table bgcolor="#b0c4de" cellspacing="10">
  8. <tr>
  9. <td align="right">名字:</td>
  10. <td><asp:TextBox id="txt_name" runat="server"/></td>
  11. <td>
  12. <asp:RequiredFieldValidator
  13. ControlToValidate="txt_name"
  14. ErrorMessage="Name"
  15. Text="*"
  16. runat="server"/>
  17. </td>
  18. </tr>
  19. <tr>
  20. <td align="right">卡片类型:</td>
  21. <td>
  22. <asp:RadioButtonList id="rlist_type"
  23. RepeatLayout="Flow"
  24. runat="server">
  25. <asp:ListItem>Diners</asp:ListItem>
  26. <asp:ListItem>MasterCard</asp:ListItem>
  27. <asp:ListItem>Visa</asp:ListItem>
  28. </asp:RadioButtonList>
  29. </td>
  30. <td>
  31. <asp:RequiredFieldValidator
  32. ControlToValidate="rlist_type"
  33. ErrorMessage="Card Type"
  34. InitialValue=""
  35. Text="*"
  36. runat="server"/>
  37. </td>
  38. </tr>
  39. <tr>
  40. <td></td>
  41. <td><asp:Button id="b1" Text="提交" runat="server"/></td>
  42. <td></td>
  43. </tr>
  44. </table>
  45. </td>
  46. </tr>
  47. </table>
  48. <br />
  49. <asp:ValidationSummary
  50. HeaderText="您必须在下面的字段中输入值:"
  51. DisplayMode="BulletList"
  52. EnableClientScript="true"
  53. runat="server"/>
  54. </form>
  55. </body>
  56. </html>
  • Validationsummary 2

    在本例中,我们使用 ValidationSummary 控件显示了一个提示用户未填的必选字段的消息框。

  1. <html>
  2. <body>
  3. <form runat="server">
  4. <table>
  5. <tr>
  6. <td>
  7. <table bgcolor="#b0c4de" cellspacing="10">
  8. <tr>
  9. <td align="right">名字:</td>
  10. <td><asp:TextBox id="txt_name" runat="server"/></td>
  11. <td>
  12. <asp:RequiredFieldValidator
  13. ControlToValidate="txt_name"
  14. ErrorMessage="Name"
  15. Text="*"
  16. runat="server"/>
  17. </td>
  18. </tr>
  19. <tr>
  20. <td align="right">卡片类型:</td>
  21. <td>
  22. <asp:RadioButtonList id="rlist_type"
  23. RepeatLayout="Flow"
  24. runat="server">
  25. <asp:ListItem>Diners</asp:ListItem>
  26. <asp:ListItem>MasterCard</asp:ListItem>
  27. <asp:ListItem>Visa</asp:ListItem>
  28. </asp:RadioButtonList>
  29. </td>
  30. <td>
  31. <asp:RequiredFieldValidator
  32. ControlToValidate="rlist_type"
  33. ErrorMessage="Card Type"
  34. InitialValue=""
  35. Text="*"
  36. runat="server"/>
  37. </td>
  38. </tr>
  39. <tr>
  40. <td></td>
  41. <td><asp:Button id="b1" Text="提交" runat="server"/></td>
  42. <td></td>
  43. </tr>
  44. </table>
  45. </td>
  46. </tr>
  47. </table>
  48. <asp:ValidationSummary
  49. ShowMessageBox="true"
  50. ShowSummary="false"
  51. HeaderText="您必须在下面的字段中输入值:"
  52. EnableClientScript="true"
  53. runat="server"/>
  54. </form>
  55. </body>
  56. </html>