RequiredFieldValidator控件 为上文举例
(2009-02-15 23:17:18)
标签：
it分类：
程序世界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.C;
说明：使用 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:RequiredFieldValidatorID="RequiredFieldValidator4" runat="server" C
ErrorMessage="＊邮箱不能为空"></asp:RequiredFieldValidator>
<asp:RequiredFieldValidatorID="RequiredFieldValidator5" runat="server" C
ErrorMessage="＊电话不能为空"></asp:RequiredFieldValidator>
例2 验证DropDownList控件是否为空
本例使用RequiredFieldValidator控件验证DropDownList控件选项是否为空。运行本实例，在姓名文本框中输入姓名，然后单击【提交】按钮。
代码如下。
<asp:RequiredFieldValidatorID="RequiredFieldValidator1" runat="server" C
ErrorMessage="性别选项不能为空"Width="161px"></asp:RequiredFieldValidator>
