如何:控制 ASP.NET 服务器控件的验证错误信息显示
更新:2007 年 11 月
在 Microsoft Visual Web Developer 中,您可以通过四种不同的方式显示错误信息文本,如下表中所述。
显示方法 |
说明 |
---|---|
内联 |
在控件旁边验证控件所在的位置显示错误信息。 |
摘要 |
在一个涵盖所有错误的单独摘要中显示错误信息,该方式只在用户提交页时可用。或者,可以在消息框中显示错误信息,但是此选项仅在支持动态 HTML (DHTML) 的浏览器中可用。 |
内联和摘要 |
同一错误信息的摘要显示和内联显示可能会有所不同。您可以使用此选项内联显示较为简短的错误信息,而在摘要中显示较为详细的信息,也可以在输入字段旁显示错误标志符号,而在摘要中显示错误信息。 |
自定义 |
您可以创建您自己的错误信息显示。有关更多信息,请参见如何:显示 ASP.NET 服务器控件的服务器端自定义验证消息。 |
如果要显示错误信息摘要,您需要将控件添加到页。
显示错误信息摘要
将 ValidationSummary 控件添加到页中要显示收集的错误信息的位置上。
设置单个验证控件的 ErrorMessage 和 Display 属性。
若要格式化错误信息,请使用在 ValidationSummaryDisplayMode 枚举中定义的下面其中一个值来设置摘要控件的 DisplayMode 属性:
值
显示
BulletList
(默认值)每条错误信息都显示为单独的项。
List
每条错误信息都显示在单独的行中。
SingleParagraph
每条错误信息都显示为段落中的一个句子。
如果将单个验证控件与验证组关联,则需要对每个验证组使用一个 ValidationSummary 控件。
若要将错误信息内联显示以及显示为摘要,需要设置单个验证控件中属性的不同组合。
内联显示和摘要显示错误信息
按照前面步骤中所述添加一个 ValidationSummary 控件。
根据下表设置单个验证控件的 ErrorMessage、Text 和 Display 属性:
选项
需要 ValidationSummary 控件
验证控件上的属性设置
仅限内联
否
Display = Static 或 Dynamic
ErrorMessage = <错误文本> 或 Text = <错误文本>
仅限摘要(含可选消息框)
是
Display = None
ErrorMessage = <错误文本> 或 Text = <错误文本>
内联和摘要(含可选消息框)
是
Display = Static 或 Dynamic
ErrorMessage = <摘要的错误文本>
Text = <内联错误文本或标志符号>
如果客户端运行的浏览器支持 DHTML,则还可以在消息框中显示错误信息摘要。
在消息框中显示错误信息摘要
将 ValidationSummary 控件的 ShowMessageBox 属性设置为 true。
用户提交页时,错误将同时显示在 ValidationSummary 控件和消息框中。
若要只在消息框中显示错误信息摘要,则将 ShowSummary 属性设置为 false。