Controle RequiredFieldValidator (referênciaGeral )
Avalia o valor de um controle de entrada para garantir que o usuário insere 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 o controle para fazer um controle de entrada um campo obrigatório. O controle de entrada falha validação se o valor que ele contém não alterar 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 vazia (""), que indica que um valor deve ser inserido no controle de entrada para que ele passou na validação.
Observação
Espaços extras no início e no final do valor de entrada são 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ê desejará ter um valor inicial, não é uma seqüência vazia. Isso é útil quando você tiver um valor padrão para um controle de entrada e deseja que o usuário selecione um valor diferente. Por exemplo, você pode ter um ListBox o controle com uma entrada selecionada, por padrão, que contém instruções para o usuário selecione um item da lista. O usuário deve selecionar um item do controle, mas 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 este item, especificando o seu valor como o valor inicial. Se o usuário selecionar este item, o RequiredFieldValidator controle exibe a mensagem de erro. Para especificar o valor inicial do controle de entrada associado, defina a InitialValue propriedade.
Observação
O InitialValue a propriedade não definida com o valor padrão para o controle de entrada.O InitialValue propriedade nem mesmo precisa corresponder ao valor padrão de controle de entrada.Ele simplesmente indica o valor que você não deseja que o usuário digite no controle de entrada.O controle de entrada falha 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 tempo, 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 o controle para fazer uma TextBox controle de um campo obrigatório.
.gif "Observação de segurança") Observação sobre 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"/>