当前位置: 首页 > 图文教程 > 网络编程 > ASP.NET > Validation服务器控件:RequiredFieldValidator控件

ASP.NET
漫谈.Net开发关于命名空间和目录划分
.net中关于企业Excel报表的生成
.NET中取得IP/用户名等信息常用方法
关于.Net开发下的分布式缓存设计
.NET中为组合框添加自动查询功能
ASP.NET如何进行性能优化问题
开发中如何有效监控.NET应用程序
ASP.NET2.0 显示写入日期和时间语法
用.NET Array类的Sort方法分类数值
Asp.net Mvc Pv4中使用AjaxHelper
Asp.net中Forms验证的角色验证授权(一)
Asp.net中Forms验证的角色验证授权(二)
Asp.Net2.0数据库基本操作方法学习
Asp.Net之枚举类型输出需要类型转换
用.NET的File控件上传文件的解决方案
.NET泛型技巧之类型参数之间的转换
在ASP.NET中将数据直接输出成Excel格式
在.NET框架下使用自定义配置设置
跟ASP.NET MVC一起使用jQuery
Visual Basic中文本框处理技巧集萃

ASP.NET 中的 Validation服务器控件:RequiredFieldValidator控件


出处:互联网   整理: 软晨网(RuanChen.com)   发布: 2009-09-28   浏览: 157 ::
收藏到网摘: n/a

阅读此文请先查看软晨学习网的:ASP.NET入门教程:Validation服务器控件,简单讲述了Web服务器控件的使用方法。

定义和用法

RequiredFieldValidator 控件用于使输入控件成为一个必选字段。计算输入控件的值以确保用户输入值。

通过该控件,如果输入值的初始值未改变,那么验证将失败。默认地,初始值是空字符串 ("")。

注释:输入值的开头和结尾的空格将在验证前被删除。

注释:InitialValue 不为输入控件设置默认值。它指示了您不希望用户在输入控件中输入的值。

属性

属性 描述
BackColor RangeValidator 控件的背景颜色
ControlToValidate 要验证的控件的 id
Display 验证控件的显示行为。

合法的值有:

  • None - 验证消息从不内联显示。
  • Static - 在页面布局中分配用于显示验证消息的空间。
  • Dynamic - 如果验证失败,将用于显示验证消息的空间动态添加到页面。
EnableClientScript 布尔值,规定是否启用客户端验证。
Enabled 布尔值,规定是否启用验证控件。
ErrorMessage

当验证失败时,在 ValidationSummary 控件中显示的文本。

注释:如果未设置 Text 属性,文本也会显示在该验证控件中。

ForeColor 该控件的前景色。
id 控件的唯一 id。
InitialValue 规定输入控件的初始值(开始值)。默认是 ""。
IsValid 布尔值,指示关联的输入控件是否通过验证。
runat 规定该控件是一个服务器控件。必须设置为 "server"。
Text 当验证失败时显示的消息。

语法

<asp:RequiredFieldValidator
    AccessKey="string"
    AssociatedControlID="string"
    BackColor="color name|#dddddd"
    BorderColor="color name|#dddddd"
    BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
        Inset|Outset"
    BorderWidth="size"
    ControlToValidate="string"
    CssClass="string"
    Display="None|Static|Dynamic"
    EnableClientScript="True|False"
    Enabled="True|False"
    EnableTheming="True|False"
    EnableViewState="True|False"
    ErrorMessage="string"
    Font-Bold="True|False"
    Font-Italic="True|False"
    Font-Names="string"
    Font-Overline="True|False"
    Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|
        Large|X-Large|XX-Large"
    Font-Strikeout="True|False"
    Font-Underline="True|False"
    ForeColor="color name|#dddddd"
    Height="size"
    ID="string"
    InitialValue="string"
    OnDataBinding="DataBinding event handler"
    OnDisposed="Disposed event handler"
    OnInit="Init event handler"
    OnLoad="Load event handler"
    OnPreRender="PreRender event handler"
    OnUnload="Unload event handler"
    runat="server"
    SetFocusOnError="True|False"
    SkinID="string"
    Style="string"
    TabIndex="integer"
    Text="string"
    ToolTip="string"
    ValidationGroup="string"
    Visible="True|False"
    Width="size"
/>

备注:使用 RequiredFieldValidator 控件使输入控件成为强制字段。当验证执行时,如果输入控件包含的值仍为初始值而未更改,则该输入控件验证失败。这会防止用户使关联的输入控件保持不变。默认情况下,初始值为空字符串 (""),这指示必须在输入控件中输入值方可通过验证。

注意:请在执行验证之前移除输入值前后的多余空格。这样可防止在输入控件中输入的空格通过验证。

有时,您可能希望初始值不为空字符串。当输入控件具有默认值而且希望用户选择其他值时,这将非常有用。例如,默认情况下,可能有一个具有选定输入的 ListBox 控件,其中包含用户从列表中选择项的说明。用户必须从控件中选择一项,但您不希望用户选择包含说明的项。您可通过将该项的值指定为初始值来防止用户选择该项。如果用户选择该项,RequiredFieldValidator 控件将显示它的错误信息。若要指定关联输入控件的起始值,请设置 InitialValue 属性。

注意:InitialValue 属性不设置输入控件的默认值。InitialValue 属性甚至不需要与输入控件的默认值匹配。它仅指示您不希望用户在输入控件中输入的值。当验证执行时,如果输入控件包含该值,则其验证失败。

多个验证程序可与同一个输入控件关联。例如,可使用 RequiredFieldValidator 控件确保输入到控件中,同时可用 RangeValidator 控件确保输入在指定的数据范围内。

示例

下面的代码示例演示如何使用 RequiredFieldValidator 控件使 TextBox 控件成为强制字段。

Visual Basic

Name:
 <asp:TextBox id="Text1"
      Text="Enter a value"
      runat="server"/>
 <asp:RequiredFieldValidator id="RequiredFieldValidator1" 
      ControlToValidate="Text1"
      Text="Required Field!"
      runat="server"/>
 <p />  
 <asp:Button id="Button1"
      runat="server"
      Text="Validate"/>

C#

Name:
 <asp:TextBox id="Text1"
      Text="Enter a value"
      runat="server"/>
 <asp:RequiredFieldValidator id="RequiredFieldValidator1" 
      ControlToValidate="Text1"
      Text="Required Field!"
      runat="server"/>
 <p />  
 <asp:Button id="Button1"
      runat="server"
      Text="Validate"/>