RequiredFieldValidator, contrôle

Article
04/11/2008

Le contrôle RequiredFieldValidator vérifie si la valeur d'un autre contrôle est différente de sa valeur initiale.

En termes de validation, il se comporte de la même manière que le contrôle ASP.NET System.Web.UI.WebControls.RequiredFieldValidator.

Syntaxe des contrôles mobiles

Les propriétés, valeurs par défaut et éléments de code requis sont indiqués en caractères gras.

<mobile:RequiredFieldValidatorrunat="server"
   id="id"
   Font-Name="fontName"
   Font-Size={ NotSet|Normal|Small|Large }
   Font-Bold={ NotSet|False|True }
   Font-Italic="{NotSet|False|True}"
   ForeColor="foregroundColor"
   BackColor="backgroundColor"
   Alignment="{NotSet|Left|Center|Right}"
   StyleReference="styleReference"
   Wrapping="{NotSet|Wrap|NoWrap}"

   ControlToValidate="IdOfTargetControl"
   Display="{None|Static|Dynamic}"
   ErrorMessage="ErrorTextForSummary"
   InitialValue="initialValueInTheControl">
innerText
</mobile:RequiredFieldValidator>

Règles relatives à la relation contenant-contenu

Les contrôles suivants peuvent contenir un contrôle RequiredFieldValidator.

Contrôle	Commentaires
System.Web.UI.MobileControls.Form	Peut contenir n'importe quel nombre de contrôles RequiredFieldValidator.
System.Web.UI.MobileControls.Panel	Peut contenir n'importe quel nombre de contrôles RequiredFieldValidator.

Le contrôle RequiredFieldValidator ne peut pas contenir d'autres contrôles.

Modèles de périphériques

Aucun.

Comportement spécifique au périphérique

Lorsqu'un validateur est rendu, son rendu spécifique au périphérique est identique au rendu spécifique au périphérique du contrôle Label, sauf que la propriété StyleReference du contrôle a initialement la valeur Error. Dans ce cas, le contrôle utilise le style d'erreur qui figure dans la feuille de style de la page. En l'absence de cette feuille de style, le contrôle utilise la feuille de style par défaut du système.

Exemple

L'exemple suivant invite un utilisateur à entrer un nombre compris entre 1 et 23. Il utilise à la fois les contrôles RangeValidator et RequiredFieldValidator.

<%@ Page Inherits=
   "System.Web.UI.MobileControls.MobilePage" Language="VB" %>
<%@ Register TagPrefix="mobile"
    Namespace="System.Web.UI.MobileControls"
    Assembly="System.Web.Mobile" %>

<script language="vb" runat="server">

Protected Sub Submit_OnClick(sender As Object, e As EventArgs)
   If Page.IsValid Then
      ActiveForm = Form2
   End If
End Sub

</script>

<mobile:Form id="Form1" runat="server">
   <mobile:Label runat="server">
      Please enter an integer from 1 through 23
   </mobile:Label>

   <mobile:TextBox id="number" runat="server"/>

   <mobile:RangeValidator ControlToValidate="number"
      Type="Integer"
      MaximumValue="23"
      MinimumValue="1"
      runat="server">
      Invalid number
   </mobile:RangeValidator>

   <mobile:RequiredFieldValidator ControlToValidate="number" 
      runat="server">
      A number is required
   </mobile:RequiredFieldValidator>

   <mobile:Command runat="server" OnClick="Submit_OnClick">
      Submit
   </mobile:Command>

</mobile:Form>

<mobile:Form id="Form2" runat="server">
   <mobile:Label runat="server">Number is submitted</mobile:Label>
</mobile:Form>
[C#]
<%@ Page Inherits=
   "System.Web.UI.MobileControls.MobilePage" Language="C#" %>
<%@ Register TagPrefix="mobile"
    Namespace="System.Web.UI.MobileControls"
    Assembly="System.Web.Mobile" %>

<script language="c#" runat="server">

protected void Submit_OnClick(Object sender, EventArgs e)
{
   if (Page.IsValid)
   {
      ActiveForm = Form2;
   }
}

</script>

<mobile:Form id="Form1" runat="server">
   <mobile:Label runat="server">
      Please enter an integer from 1 through 23
   </mobile:Label>

   <mobile:TextBox id="number" runat="server"/>

   <mobile:RangeValidator ControlToValidate="number"
      Type="Integer"
      MaximumValue="23"
      MinimumValue="1"
      runat="server">
      Invalid number
   </mobile:RangeValidator>

   <mobile:RequiredFieldValidator ControlToValidate="number" 
      runat="server">
      A number is required
   </mobile:RequiredFieldValidator>

   <mobile:Command runat="server" OnClick="Submit_OnClick">
      Submit
   </mobile:Command>

</mobile:Form>

<mobile:Form id="Form2" runat="server">
   <mobile:Label runat="server">Number is submitted</mobile:Label>
</mobile:Form>

Voir aussi

RequiredFieldValidator, classe | RequiredFieldValidator, membres de classe | RequiredFieldValidator, contrôle

Partager via