Validation服务器控件:RequiredFieldValidator控件
阅读此文请先查看IT教学网的:ASP.NET入门教程:Validation服务器控件,简单讲述了Web服务器控件的使用方法。
定义和用法
RequiredFieldValidator 控件用于使输入控件成为一个必选字段。计算输入控件的值以确保用户输入值。
通过该控件,如果输入值的初始值未改变,那么验证将失败。默认地,初始值是空字符串 ("")。
注释:输入值的开头和结尾的空格将在验证前被删除。
注释:InitialValue 不为输入控件设置默认值。它指示了您不希望用户在输入控件中输入的值。
属性
属性 | 描述 |
---|---|
BackColor | RangeValidator 控件的背景颜色 |
ControlToValidate | 要验证的控件的 id |
Display | 验证控件的显示行为。
合法的值有:
|
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"/>