Controle RequiredFieldValidator (referência geral)
Avalia o valor de um controle de entrada para garantir que o usuário insira um valor.
<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"
/>
Comentários
Use o RequiredFieldValidator controle para transformar um controle de entrada em um campo obrigatório. O controle de entrada falhará validação se o valor que ele contém não muda de seu valor inicial quando a validação é executada. Isso impede que o usuário deixa o controle de entrada associado inalterado. Por padrão, o valor inicial é uma seqüência de caracteres vazia (""), que indica que um valor deve ser inserido no controle de entrada para que ele passou na validação.
.gif "Observação") Observação: |
|---|
Espaços extras no início e no participante do valor de entrada foram removidos antes de validação é executada. Isso impede que um espaço inserido no controle de entrada de validação de passar. |
Às vezes, você deverá ter um valor inicial que não é uma seqüência de caracteres vazia. Isso é útil quando você tem um valor padrão para um controle de entrada e quiser que o usuário selecionar um valor diferente. Por exemplo, você pode ter um ListBox controle com uma entrada selecionada, por padrão, que contém instruções para o usuário para selecionar um item da lista. O usuário deve selecionar um item do controle, mas você não deseja que o usuário para selecionar o item que contém as instruções. Você pode impedir que o usuário selecionar esse item especificando seu valor sistema autônomo o valor inicial. Se o usuário selecionar este item, o RequiredFieldValidator controle exibirá sua mensagem de erro. Para especificar o valor inicial de controle de entrada associado, conjunto o InitialValue propriedade.
| Observação: |
|---|
O InitialValue propriedade não define o valor padrão para o controle de entrada. The InitialValue propriedade ainda não é necessário corresponder ao valor padrão de controle de entrada. Ele simplesmente indica o valor que não deseja que o usuário digite no controle de entrada. O controle de entrada falhar na validação se ele contiver esse valor quando a validação é executada. |
Vários validadores podem ser associados com o mesmo controle de entrada. Por exemplo, um RequiredFieldValidator controle pode ser usado para garantir que a entrada para um controle, e, ao mesmo time, um RangeValidator controle pode ser usado para garantir que a entrada está dentro de um intervalo de dados especificado.
Para obter mais informações sobre o RequiredFieldValidator controle, consulte o RequiredFieldValidator classe.
Exemplo
O exemplo de código a seguir demonstra como usar o RequiredFieldValidator controle para fazer um TextBox controle um campo obrigatório.
.gif "Observação de segurança") Observação de segurança: |
|---|
Este exemplo tem uma caixa de texto que aceita entrada do usuário, que é uma ameaça potencial de segurança. Por padrão, páginas Web ASP.NET validam se as entradas de usuário não incluem scripts ou elementos HTML. Para obter mais informações, consulte Visão Geral de Scripts Maliciosos. |
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"/>