1.功能
ValidationSummary控件本身并不能验证数据，但可以用来显示其他验证控件的验证结果，换言之ValidationSummary控件是用来显示页面上各种验证控件显示的出错信息，在使用该控件之前需要先设置好其他验证控件的ErrorMessage属性。
2.属性
ValidationSummary控件部分常用属性及说明如表1所示。
表1 ValidationSummary控件常用的属性
|
属性 |
描述 |
|
HeaderText |
该属性获取或设置显示在摘要上方的标题文本 |
|
DisplayMode |
该属性获取或设置验证摘要的显示模式 |
|
ShowMessageBox |
是否以弹出方式显示每个被验证控件的错误信息 |
|
ShowSummary |
是否使用错误汇总信息 |
|
EnableClientScript |
是否使用客户端验证，系统默认值为True |
|
Validate |
执行验证并且更新IsValid属性 |
下面对比较重要的属性进行详细介绍。
(1)HeaderText属性
该属性获取或设置显示在摘要上方的标题文本。
语法：
| publicstringHeaderText{get;set;} |
属性值：
显示在摘要上方的标题文本。默认为 String.Empty。
例如：设置ValidationSummary控件的标题为“错误信息总汇” ，代码如下：
| ValidationSummary1.HeaderText="错误信息总汇"; |
(2)DisplayMode属性
该属性获取或设置验证摘要的显示模式。
语法：
| ValidationSummaryDisplayModeDisplayMode{get;set;} |
属性值：
ValidationSummaryDisplayMode值之一。默认为 BulletList。ValidationSummaryDisplayMode值是一个枚举类型值，表示指定 ValidationSummary 控件使用的验证摘要显示模式。ValidationSummaryDisplayMode枚举值及说明如表2所示。
表2 ValidationSummaryDisplayMode枚举值及说明
|
格举值 |
说明 |
|
BulletList |
显示在项目符号列表中的验证摘要 |
|
List |
显示在列表中的验证摘要 |
|
SingleParagraph |
显示在单个段落内的验证摘要 |
例如：设置ValidationSummary的显示模式为项目符号列表，代码如下：
| this.ValidationSummary1.DisplayMode=ValidationSummaryDisplayMode.BulletList; |
(3)ShowMessageBox属性
该属性获取或设置一个值，该值指示是否在消息框中显示验证摘要。
语法：
| publicboolShowMessageBox{get;set;} |
属性值：
如果在消息框中显示验证摘要，则为 true;否则为 false。默认为 false。
(4)ShowSummary属性
该属性获取或设置一个值，该值指示是否内联显示验证摘要。
语法：
| publicboolShowSummary{get;set;} |
属性值：
如果内联显示验证摘要，则为 true;否则为 false。默认为 true。
注意：如果 ShowMessageBox 和 ShowSummary 属性都设置为 true，则在消息框和网页上都显示验证摘要。
ValidationSummary控件常用方法，事件同RequiredFieldValidator控件类似。
3.典型实例
本例实现了使用ValidationSummary控件的相关属性，来显示页面中所有验证错误的信息。
代码如下。
| protectedvoidPage_Load(objectsender,EventArgse){
RequiredFieldValidator1.ControlToValidate="TextBox1";//设置要验证控件的ID RequiredFieldValidator1.ErrorMessage="用户名称不能为空";//设置错误信息 RequiredFieldValidator1.Display=ValidatorDisplay.None;//设置错误信息显示模式 RequiredFieldValidator2.ControlToValidate="TextBox2";//设置要验证控件的ID RequiredFieldValidator2.ErrorMessage="登录密码不能为空";//设置错误信息 RequiredFieldValidator2.Display=ValidatorDisplay.None;//设置错误信息显示模式 ValidationSummary1.HeaderText="登录错误信息提示：";//设置ValidationSummary控件的标题 ValidationSummary1.DisplayMode=ValidationSummaryDisplayMode.BulletList;//设置错误信息显示模式 ValidationSummary1.ShowMessageBox=true;//设置是否用对话框来显示错误信息 ValidationSummary1.ShowSummary=true;//设置是否在网页上显示错误信息 } |
新闻热点
疑难解答
