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

ASP.NET
FreeTextBox(版本3.1.6)在ASP.Net 2.0中使用方法
.NET 常用功能和代码小结
在 .NET Framework 2.0 中未处理的异常导致基于 ASP.NET 的应用程序意外退出
asp.net IList查询数据后格式化数据再绑定控件
asp.net sql存储过程
asp.net 简单实现禁用或启用页面中的某一类型的控件
asp.net(c#)获取内容第一张图片地址的函数
The remote procedure call failed and did not execute的解决办法
ASP.NET 在线文件管理
asp.net 读取并修改config文件实现代码
ASP.NET Cookie 操作实现
asp.net Silverlight中的模式窗体
Silverlight中动态获取Web Service地址
asp.net Silverlight应用程序中获取载体aspx页面参数
asp.net 水晶报表隔行换色实现方法
asp.net 获取Gridview隐藏列的值
手动把asp.net的类生成dll文件的方法
asp.net 使用ObjectDataSource控件在ASP.NET中实现Ajax真分页
动态指定任意类型的ObjectDataSource对象的查询参数
asp.net Md5的用法小结

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


出处:互联网   整理: 软晨网(RuanChen.com)   发布: 2009-09-28   浏览: 98 ::
收藏到网摘: 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"/>