RequiredFieldValidator, contrôle (Référence générale)
Mise à jour : novembre 2007
Analyse la valeur d'un contrôle d'entrée pour s'assurer que l'utilisateur a bien entré une valeur.
<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"
/>
Notes
Utilisez le contrôle RequiredFieldValidator pour faire d'un contrôle d'entrée un champ obligatoire. La validation du contrôle d'entrée échoue si la valeur qu'il contient équivaut à sa valeur initiale lors de l'exécution de la validation. L'utilisateur est ainsi obligé de modifier le contrôle d'entrée associé. Par défaut, la valeur initiale est une chaîne vide (""), qui indique qu'une valeur doit être entrée dans le contrôle d'entrée pour que la validation s'effectue correctement.
.gif "Remarque") Remarque : |
|---|
Les espaces supplémentaires au début et à la fin de la valeur d'entrée sont supprimés avant que la validation soit effectuée. Cela évite qu'un espace entré dans le contrôle d'entrée passe la validation. |
Il peut arriver que vous ne souhaitiez pas avoir une chaîne vide comme valeur initiale. Cela est utile lorsqu'une valeur par défaut est associée au contrôle d'entrée et que vous voulez que l'utilisateur choisisse une valeur différente. C'est le cas, par exemple, d'un contrôle ListBox pour lequel l'entrée sélectionnée par défaut contient des instructions demandant à l'utilisateur de sélectionner un élément dans la liste. L'utilisateur doit sélectionner un élément du contrôle, mais vous ne voulez pas qu'il puisse sélectionner l'élément contenant les instructions. Pour empêcher l'utilisateur de sélectionner cet élément, spécifiez sa valeur comme étant la valeur initiale. Si l'utilisateur sélectionne cet élément, le contrôle RequiredFieldValidator affiche le message d'erreur associé. Pour spécifier la valeur initiale du contrôle d'entrée associé, définissez la propriété InitialValue.
| Remarque : |
|---|
La propriété InitialValue ne définit pas la valeur par défaut du contrôle d'entrée. Cette propriété InitialValue n'a même pas besoin de correspondre à la valeur par défaut du contrôle d'entrée. Elle indique simplement la valeur que l'utilisateur n'a pas le droit d'entrer dans le contrôle d'entrée. La validation du contrôle d'entrée échoue si celui-ci contient la valeur non autorisée lors de l'exécution de la validation. |
Plusieurs validateurs peuvent être associés au même contrôle d'entrée. Vous pouvez, par exemple, utiliser un contrôle RequiredFieldValidator pour garantir la présence d'une entrée dans un contrôle et avoir simultanément recours à un contrôle RangeValidator pour vous assurer que l'entrée fait partie d'une plage de données spécifiée.
Pour plus d'informations sur le contrôle RequiredFieldValidator, consultez la classe RequiredFieldValidator.
Exemple
L'exemple de code suivant montre comment utiliser un contrôle RequiredFieldValidator pour faire d'un contrôle TextBox un champ obligatoire.
.gif "Note de sécurité") Note de sécurité : |
|---|
Cet exemple a une zone de texte qui accepte l'entrée d'utilisateur, ce qui constitue une menace éventuelle pour la sécurité. Par défaut, les pages Web ASP.NET vérifient que les entrées d'utilisateur n'incluent pas de script ou d'éléments HTML. Pour plus d'informations, consultez Vue d'ensemble des attaques de script. |
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"/>