通过

RequiredFieldValidator 控件（常规参考）

  • 项目

更新：2007 年 11 月

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

<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 元素。有关更多信息，请参见脚本侵入概述。

 
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

其他资源

验证服务器控件语法