Элемент управления RequiredFieldValidator (общие справочные сведения)

Статья
08/11/2011

Проверяет значение элемента управления вводом, чтобы обеспечить обязательный ввод значения пользователем.

<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 не обязано даже совпадать со значением по умолчанию элемента управления вводом.Оно лишь указывает значение, которое пользователь не должен вводить в элемент управления вводом.Элемент управления вводом вызывает сбой проверки, если при выполнении проверки обнаруживается данное значение.

Свойство InitialValue не устанавливает значение по умолчанию для элемента управления вводом.Свойство InitialValue не обязано даже совпадать со значением по умолчанию элемента управления вводом.Оно лишь указывает значение, которое пользователь не должен вводить в элемент управления вводом.Элемент управления вводом вызывает сбой проверки, если при выполнении проверки обнаруживается данное значение.

С одним и тем же элементом управления вводом может быть связано несколько проверяющих элементов управления. Например, элемент управления RequiredFieldValidator можно использовать для обеспечения гарантированного ввода данных в элемент управления, а элемент управления RangeValidator — для недопущения выхода вводимых данных за указанные пределы.

Дополнительные сведения об элементе управления RequiredFieldValidator см. в документации класса RequiredFieldValidator.

Пример

В следующем примере кода показано использование элемента управления RequiredFieldValidator для превращения элемента управления TextBox в обязательное поле.

Примечание по безопасности
В данном примере используется текстовое поле для ввода пользовательских данных, что представляет потенциальную угрозу безопасности.По умолчанию данные, вводимые пользователем на веб-страницах ASP.NET, проверяются на наличие скриптов и HTML-элементов.Дополнительные сведения см. в разделе Общие сведения об использовании скриптов.

В данном примере используется текстовое поле для ввода пользовательских данных, что представляет потенциальную угрозу безопасности.По умолчанию данные, вводимые пользователем на веб-страницах 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

Другие ресурсы

Синтаксис серверного элемента управления Validation

Поделиться через