Validation服务器控件:RequiredFieldValidator控件

2009-03-15 01:51:37  来源:网页教学网 

WebjxCom提示:RequiredFieldValidator 控件用于使输入控件成为一个必选字段。

阅读此文请先查看网页教学网的: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"/>

更多

推荐文章