Share via


RequiredFieldValidator 控件(常规参考)

[本文档仅供预览,在以后的发行版中可能会发生更改。包含的空白主题用作占位符。]

计算输入控件的值以确保用户输入值。

<asp:RequiredFieldValidator
    AccessKey="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 控件的更多信息,请参见 RequiredFieldValidator 类。

示例

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

安全说明安全说明

该示例具有一个文本框,用于接受用户输入,这是一个潜在的安全威胁。默认情况下,ASP.NET 网页验证用户输入是否不包括脚本或 HTML 元素。有关更多信息,请参见Script Exploits Overview

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"/>
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"/>

请参见

参考

RequiredFieldValidator

其他资源

验证服务器控件语法