如何：控制 ASP.NET 服务器控件的验证错误信息显示

  • 项目

更新：2007 年 11 月

在 Microsoft Visual Web Developer 中，您可以通过四种不同的方式显示错误信息文本，如下表中所述。

显示方法

说明

内联

在控件旁边验证控件所在的位置显示错误信息。

摘要

在一个涵盖所有错误的单独摘要中显示错误信息，该方式只在用户提交页时可用。或者，可以在消息框中显示错误信息，但是此选项仅在支持动态 HTML (DHTML) 的浏览器中可用。

内联和摘要

同一错误信息的摘要显示和内联显示可能会有所不同。您可以使用此选项内联显示较为简短的错误信息，而在摘要中显示较为详细的信息，也可以在输入字段旁显示错误标志符号，而在摘要中显示错误信息。

自定义

您可以创建您自己的错误信息显示。有关更多信息，请参见如何：显示 ASP.NET 服务器控件的服务器端自定义验证消息。

如果要显示错误信息摘要，您需要将控件添加到页。

显示错误信息摘要

  1. 将 ValidationSummary 控件添加到页中要显示收集的错误信息的位置上。

  2. 设置单个验证控件的 ErrorMessage 和 Display 属性。

  3. 若要格式化错误信息，请使用在 ValidationSummaryDisplayMode 枚举中定义的下面其中一个值来设置摘要控件的 DisplayMode 属性：

    值

    显示

    BulletList

    （默认值）每条错误信息都显示为单独的项。

    List

    每条错误信息都显示在单独的行中。

    SingleParagraph

    每条错误信息都显示为段落中的一个句子。

  4. 如果将单个验证控件与验证组关联，则需要对每个验证组使用一个 ValidationSummary 控件。

若要将错误信息内联显示以及显示为摘要，需要设置单个验证控件中属性的不同组合。

内联显示和摘要显示错误信息

  1. 按照前面步骤中所述添加一个 ValidationSummary 控件。

  2. 根据下表设置单个验证控件的 ErrorMessage、Text 和 Display 属性：

    选项

    需要 ValidationSummary 控件

    验证控件上的属性设置

    仅限内联

    否

    Display = Static 或 Dynamic

    ErrorMessage = <错误文本> 或 Text = <错误文本>

    仅限摘要（含可选消息框）

    是

    Display = None

    ErrorMessage = <错误文本> 或 Text = <错误文本>

    内联和摘要（含可选消息框）

    是

    Display = Static 或 Dynamic

    ErrorMessage = <摘要的错误文本>

    Text = <内联错误文本或标志符号>

如果客户端运行的浏览器支持 DHTML，则还可以在消息框中显示错误信息摘要。

在消息框中显示错误信息摘要

  1. 将 ValidationSummary 控件的 ShowMessageBox 属性设置为 true。

    用户提交页时，错误将同时显示在 ValidationSummary 控件和消息框中。

  2. 若要只在消息框中显示错误信息摘要，则将 ShowSummary 属性设置为 false。

请参见

任务

如何：指定 ASP.NET 服务器控件上就地消息的布局

参考

在 ASP.NET 网页中验证用户输入