Control.Validated Événement

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Source:

Control.cs

Se produit quand le contrôle a terminé la validation.

C#

public event EventHandler? Validated;

Type d'événement

EventHandler

Exemples

L’exemple de code suivant utilise la classe TextBox dérivée et valide une adresse e-mail que l’utilisateur entre. Si l’adresse e-mail n’est pas au format standard (contenant « @ » et « ». ), la validation échoue, une ErrorProvider icône s’affiche et l’événement est annulé. Cet exemple nécessite qu’un TextBox contrôle et ErrorProvider ait été créé sur un formulaire.

C#

private void textBox1_Validating(object sender, 
                System.ComponentModel.CancelEventArgs e)
{
   string errorMsg;
   if(!ValidEmailAddress(textBox1.Text, out errorMsg))
   {
      // Cancel the event and select the text to be corrected by the user.
      e.Cancel = true;
      textBox1.Select(0, textBox1.Text.Length);

      // Set the ErrorProvider error with the text to display. 
      this.errorProvider1.SetError(textBox1, errorMsg);
   }
}

private void textBox1_Validated(object sender, System.EventArgs e)
{
   // If all conditions have been met, clear the ErrorProvider of errors.
   errorProvider1.SetError(textBox1, "");
}
public bool ValidEmailAddress(string emailAddress, out string errorMessage)
{
   // Confirm that the email address string is not empty.
   if(emailAddress.Length == 0)
   {
      errorMessage = "email address is required.";
         return false;
   }

   // Confirm that there is an "@" and a "." in the email address, and in the correct order.
   if(emailAddress.IndexOf("@") > -1)
   {
      if(emailAddress.IndexOf(".", emailAddress.IndexOf("@") ) > emailAddress.IndexOf("@") )
      {
         errorMessage = "";
         return true;
      }
   }
   
   errorMessage = "email address must be valid email address format.\n" +
      "For example 'someone@example.com' ";
      return false;
}

Remarques

Lorsque vous modifiez le focus à l’aide du clavier (TAB, MAJ+TAB, et ainsi de suite), en appelant les Select méthodes ou SelectNextControl ou en définissant la ContainerControl.ActiveControl propriété sur le formulaire actuel, les événements de focus se produisent dans l’ordre suivant :

1. Enter

2. GotFocus

3. Leave

4. Validating

5. Validated

6. LostFocus

Lorsque vous modifiez le focus à l’aide de la souris ou en appelant la Focus méthode, les événements de focus se produisent dans l’ordre suivant :

1. Enter

2. GotFocus

3. LostFocus

4. Leave

5. Validating

6. Validated

Si la CausesValidation propriété a la falsevaleur , les Validating événements et Validated sont supprimés.

Si la Cancel propriété de est CancelEventArgs définie sur dans le délégué de true l’événement Validating , tous les événements qui se produisent généralement après la suppression de l’événement Validating .

Précaution

N’essayez pas de définir le Enterfocus à partir des gestionnaires d’événements , GotFocusLeave, LostFocus, Validating, ou Validated . Cela peut entraîner l’arrêt de la réponse de votre application ou du système d’exploitation. Pour plus d’informations, consultez la rubrique WM_KILLFOCUS et la section « Interblocages de messages » de la rubrique À propos des messages et des files d’attente de messages .

Pour plus d'informations sur la gestion des événements, voir gestion et déclenchement d’événements.

S’applique à

Voir aussi

• OnValidated(EventArgs)
• CausesValidation
• Validating