RequiredFieldValidator，ValidationSummary控件详解

<div class="addcomment">

<asp:TextBox ID="txtcomment" runat="server" TextMode="MultiLine" Text="请在此输入评论内容" onclick="this.select()" Height="250" Width="600" CssClass="comment_con"></asp:TextBox>

<p>验证码：<a name="com"> </a><img src="handler/WaterMark.ashx" id="vimg" onclick="changeCode()" alt="" />

<asp:TextBox ID="txtCode" runat="server" CssClass="txtcode"></asp:TextBox>

<asp:RequiredFieldValidator
ID="RequiredFieldValidator1" runat="server" ControlToValidate="txtCode" ErrorMessage="请输入验证码" Text="*"></asp:RequiredFieldValidator>

<asp:Button ID="btnSub" runat="server" Text="提交" />

<asp:ValidationSummary ID="ValidationSummary1" runat="server" ShowMessageBox="true" ShowSummary="false" />

</p>

</div>

RequiredFieldValidator控件

1. 功能

RequiredFieldValidator控件，常用于验证文本输入框是否为空。当用户提交网页中的数据到服务器端时，系统自动检查被验证控件的输入内容是否为空，如果为空，则RequiredFieldValidator控件在网页中显示提示信息。

2. 属性

RequiredFieldValidator控件部分常用属性及说明如表1所示。

表1 RequiredFieldValidator控件部分常用属性

属性	描述
ControlToValidate	该属性获取或设置要验证的输入控件
Display	该属性获取或设置验证控件中错误信息的显示行为
EnableViewState	该属性获取或设置一个值，该值指示服务器控件是否向发出请求的客户端保持自己的视图状态以及它所包含的任何子控件的视图状态
ErrorMessage	该属性获取或设置验证失败时 ValidationSummary控件中显示的错误信息的文本
ForeColor	该属性获取或设置验证失败后显示的消息的颜色
IsValid	该属性获取或设置一个值，该值指示关联的输入控件是否通过验证
SetFocusOnError	该属性获取或设置一个值，该值指示在验证失败时是否将焦点设置到ControlToValidate属性指定的控件上
Text	该属性获取或设置验证失败时验证控件中显示的文本
Page	该属性获取对包含服务器控件的 Page 实例的引用
Visible	该属性获取或设置一个值，该值指示服务器控件是否作为 UI 呈现在页上

下面对比较重要的属性进行详细介绍。

（１）ControlToValidate属性

该属性获取或设置要验证的输入控件。

语法：

public string ControlToValidate { get; set; }

属性值：

要验证的输入控件。默认值为 String.Empty，表示未设置此属性。

例如：要验证ID属性为txtUserName的TextBox控件，只要将RequiredFieldValidator控件的ControlToValidate属性设置为txtUserName。代码如下：

this.RequiredFieldValidator1.ControlToValidate = "txtUserName";

说明：使用 ControlToValidate 属性来指定要验证的输入控件。对于所有验证控件，此属性必须设置为输入控件的 ID（CustomValidator控件除外，对它来说，此属性可以保留为空白）。如果没有指定有效输入控件，则在呈现该页时将引发异常。该ID必须引用与验证控件相同的容器中的控件。

（２）Display属性

该属性获取或设置验证控件中错误信息的显示行为。

语法：

public ValidatorDisplay Display { get; set; }

属性值：

ValidatorDisplay 值之一。默认值为 Static。ValidatorDisplay值是一个枚举值表示验证控件中错误信息的不同显示行为。ValidatorDisplay枚举值及说明如表2所示。

表2 ValidatorDisplay枚举值及说明

枚举值	描述
Dynamic	验证失败时动态添加到页面中的验证程序内容
None	从不内联显示的验证程序内容
Static	作为页面布局的物理组成部分的验证程序内容

（3）ErrorMessage属性

该属性获取或设置验证失败时ValidationSummary控件中显示的错误信息的文本。

语法：

public string ErrorMessage { get; set; }

属性值：

验证失败时ValidationSummary 控件中显示的错误信息。默认值为空字符串 ("")，指示尚未设置此属性。

例如：设置TextBox控件中输入内容不能为空，将RequiredFieldValidator控件的错误消息提示文本设置为“文本框中输入内容不能为空”。代码如下：

this.RequiredFieldValidator1.ErrorMessage = "文本框中输入内容不能为空";

（４）Text属性

该属性获取或设置验证失败时验证控件中显示的文本。

语法：

public override string Text { get; set; }

属性值：

验证失败时验证控件中显示的文本。默认值为空字符串("")，表示尚未设置此属性。

（5）EnableViewState属性

该属性获取或设置一个值，该值指示服务器控件是否向发出请求的客户端保持自己的视图状态，以及它所包含的任何子控件的视图状态。

语法：

public virtual bool EnableViewState { get; set; }

属性值：

如果服务器控件维护自己的视图状态，则为true；否则为 false。默认为true。

（6）ForeColor属性

该属性获取或设置控件的前景色。

语法：

public override Color ForeColor { get; set; }

属性值：

表示控件前景色的System.Drawing.Color。默认为Red。

例如：设置RequiredFieldValidator控件前景色为“绿色”。代码如下：

RequiredFieldValidator1.ForeColor = System.Drawing.Color.Green;

（7）IsValid属性

该属性获取或设置一个值，该值指示关联的输入控件是否通过验证。

语法：

public bool IsValid { get; set; }

属性值：

如果关联的输入控件通过验证，则为true；否则为false。默认值为true。

（8）SetFocusOnError属性

该属性获取或设置一个值，该值指示在验证失败时是否将焦点设置到ControlToValidate属性指定的控件上。

语法：

public bool SetFocusOnError { get; set; }

属性值：

如果在验证失败时将焦点设置到ControlToValidate指定的控件上，则为true；否则为false。默认为false。

（9）Page属性

该属性获取对包含服务器控件的Page实例的引用。

public virtual PagePage { get; set; }

属性值：

包含服务器控件的Page实例。

（10）Visible属性

该属性获取或设置一个值，该值指示服务器控件是否作为UI呈现在Web页面上。

语法：

public virtual bool Visible { get; set; }

属性值：

如果控件在Web页上可见，则为 rue；否则为false。

3.方法

RequiredFieldValidator控件部分常用方法及说明如表3所示。

表3 RequiredFieldValidator控件部分常用方法

方法	描述
FindControl	在当前的命名容器中搜索指定的服务器控件
Focus	为控件设置输入焦点
IsVisibleOnPage	返回一个值，该值指示控件在窗体的分页上是否可见。用于窗体分页
PaginateRecursive	对此控件及其子控件进行分页
ResolveClientUrl	获取浏览器可以使用的URL
ResolveUrl	将URL转换为在请求客户端可用的URL
ToString	返回表示当前Object的String
Validate	执行控件验证，然后根据验证的结果设置IsValid属性

下面对比较重要的方法进行详细介绍。

（1）IsVisibleOnPage方法

用于窗体分页。此方法返回一个值，该值指示控件在窗体的分页上是否可见。

语法：

public bool IsVisibleOnPage (int pageNumber)

参数：

pageNumber：页码。

返回值：如果控件在窗体的分页可见，则为true；否则为false。

（2）ResolveClientUrl方法

此方法获取浏览器可以使用的URL。

语法：

public string ResolveClientUrl (string relativeUrl)

参数：

relativeUrl：相对于当前页的URL。

返回值：适合用于浏览器的指定资源的完全限定URL。

4.事件

RequiredFieldValidator控件部分常用事件及说明如表4所示。

表4 RequiredFieldValidator控件部分常用事件

事件	描述
DataBinding	此事件当服务器控件绑定到数据源时发生
Disposed	此事件当从内存释放服务器控件时发生，这是请求 ASP.NET 页时服务器控件生存期的最后阶段
Init	此事件当服务器控件初始化时发生；初始化是控件生存期的第一步
Load	此事件当服务器控件加载到 Page 对象中时发生
PreRender	此事件在加载 Control 对象之后、呈现之前发生
Unload	此事件当服务器控件从内存中卸载时发生

下面对比较重要的事件进行详细介绍。

（１）Init事件

此事件当服务器控件初始化时发生，初始化是控件生存期的第一步。

语法：

public event EventHandler Init

（２）Load事件

此事件当服务器控件初始化时发生，初始化是控件生存期的第一步。

语法：

public event EventHandler Load

5.典型实例

例1 验证TextBox控件是否为空

本例通过设置RequiredFieldValidator控件的ControlToValidate属性和ErrorMessage属性来验证文本框中输入的内容不能为空。代码如下。

<asp:RequiredFieldValidator ID="RequiredFieldValidator4" runat="server" ControlToValidate="TextBox4" ErrorMessage="＊邮箱不能为空"></asp:RequiredFieldValidator> <asp:RequiredFieldValidator ID="RequiredFieldValidator5" runat="server" ControlToValidate="TextBox5" ErrorMessage="＊电话不能为空"></asp:RequiredFieldValidator>

例2 验证DropDownList控件是否为空

本例使用RequiredFieldValidator控件验证DropDownList控件选项是否为空。运行本实例，在姓名文本框中输入姓名，然后单击【提交】按钮。

代码如下。

<asp:RequiredFieldValidator ID="RequiredFieldValidator1" runat="server" ControlToValidate="DropDownList1" ErrorMessage="性别选项不能为空" Width="161px"></asp:RequiredFieldValidator>

ValidationSummary控件

2009-12-21 22:45:55| 分类： asp.net|字号 订阅

1.功能

ValidationSummary控件本身并不能验证数据，但可以用来显示其他验证控件的验证结果，换言之ValidationSummary控件是用来显示页面上各种验证控件显示的出错信息，在使用该控件之前需要先设置好其他验证控件的ErrorMessage属性。

2.属性

ValidationSummary控件部分常用属性及说明如表1所示。

表1 ValidationSummary控件常用的属性

属性	描述
HeaderText	该属性获取或设置显示在摘要上方的标题文本
DisplayMode	该属性获取或设置验证摘要的显示模式
ShowMessageBox	是否以弹出方式显示每个被验证控件的错误信息
ShowSummary	是否使用错误汇总信息
EnableClientScript	是否使用客户端验证，系统默认值为True
Validate	执行验证并且更新IsValid属性

下面对比较重要的属性进行详细介绍。

（1）HeaderText属性

该属性获取或设置显示在摘要上方的标题文本。

语法：

public string HeaderText { get; set; }

属性值：

显示在摘要上方的标题文本。默认为 String.Empty。

例如：设置ValidationSummary控件的标题为“错误信息总汇” ，代码如下：

ValidationSummary1.HeaderText = "错误信息总汇";

（2）DisplayMode属性

该属性获取或设置验证摘要的显示模式。

语法：

ValidationSummaryDisplayMode DisplayMode { get; set; }

属性值：

ValidationSummaryDisplayMode值之一。默认为 BulletList。ValidationSummaryDisplayMode值是一个枚举类型值，表示指定 ValidationSummary 控件使用的验证摘要显示模式。ValidationSummaryDisplayMode枚举值及说明如表2所示。

表2 ValidationSummaryDisplayMode枚举值及说明

格举值	说明
BulletList	显示在项目符号列表中的验证摘要
List	显示在列表中的验证摘要
SingleParagraph	显示在单个段落内的验证摘要

例如：设置ValidationSummary的显示模式为项目符号列表，代码如下：

this.ValidationSummary1.DisplayMode = ValidationSummaryDisplayMode.BulletList;

（3）ShowMessageBox属性

该属性获取或设置一个值，该值指示是否在消息框中显示验证摘要。

语法：

public bool ShowMessageBox { get; set; }

属性值：

如果在消息框中显示验证摘要，则为 true；否则为 false。默认为 false。

（4）ShowSummary属性

该属性获取或设置一个值，该值指示是否内联显示验证摘要。

语法：

public bool ShowSummary { get; set; }

属性值：

如果内联显示验证摘要，则为 true；否则为 false。默认为 true。

注意：如果 ShowMessageBox 和 ShowSummary 属性都设置为 true，则在消息框和网页上都显示验证摘要。

ValidationSummary控件常用方法，事件同RequiredFieldValidator控件类似。

3.典型实例

本例实现了使用ValidationSummary控件的相关属性，来显示页面中所有验证错误的信息。

代码如下。

protected void Page_Load(object sender, EventArgs e){ 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;//设置是否在网页上显示错误信息 }