ContentControlBase.Validated, événement

Article
08/10/2011

Se produit lorsque le contrôle de contenu a été validé.

Espace de noms : Microsoft.Office.Tools.Word
Assembly : Microsoft.Office.Tools.Word (dans Microsoft.Office.Tools.Word.dll)

Syntaxe

'Déclaration
Event Validated As EventHandler

event EventHandler Validated

Notes

Gérez l'événement Validated pour exécuter le code après la validation du contrôle de contenu.

Pour valider le contrôle de contenu, gérez l'événement Validating. Lorsque vous validez un contrôle de contenu, vous vous assurez que le texte dans le contrôle répond à certaines conditions. Par exemple, si vous disposez d'un contrôle de contenu qui contient un numéro de téléphone, vous pouvez vérifier qu'il contient uniquement les caractères appropriés (nombres, parenthèses, traits d'union).

Pour plus d'informations sur la gestion d'événements, consultez Consommation d'événements.

Exemples

L'exemple de code suivant illustre les gestionnaires des événements Validated et Validating. Une fois la valeur du contrôle de contenu validée, le gestionnaire d'événements de l'événement Validated affiche un message destiné à l'utilisateur final.

Cet exemple suppose que le document contient un PlainTextContentControl nommé plainTextContentControl1. Pour utiliser ce code, collez-le dans la classe ThisDocument de votre projet. En C#, vous devez également attacher les gestionnaires d'événements aux événements Validated et Validating de plainTextContentControl1.

Cet exemple illustre une personnalisation au niveau du document.

Private Sub plainTextContentControl1_Validating(ByVal sender As Object, _
    ByVal e As System.ComponentModel.CancelEventArgs) _
    Handles PlainTextContentControl1.Validating

    Dim control As Microsoft.Office.Tools.Word.PlainTextContentControl = _
        TryCast(sender, Microsoft.Office.Tools.Word.PlainTextContentControl)

    If control IsNot Nothing Then
        Dim regex As New System.Text.RegularExpressions.Regex("\d")
        If regex.IsMatch(control.Text) Then
            MessageBox.Show("Invalid name. Names cannot contain integers.")
            e.Cancel = True
        End If
    End If
End Sub

Private Sub plainTextContentControl1_Validated(ByVal sender As Object, ByVal e As System.EventArgs) _
    Handles PlainTextContentControl1.Validated

    MessageBox.Show("The name is valid.")
End Sub

void plainTextContentControl1_Validating(object sender, System.ComponentModel.CancelEventArgs e)
{
    Microsoft.Office.Tools.Word.PlainTextContentControl control =
        sender as Microsoft.Office.Tools.Word.PlainTextContentControl;

    if (control != null)
    {
        System.Text.RegularExpressions.Regex regex = new System.Text.RegularExpressions.Regex(@"\d");
        if (regex.IsMatch(control.Text))
        {
            MessageBox.Show("Invalid name. Names cannot contain integers.");
            e.Cancel = true;
        }
    }
}

void plainTextContentControl1_Validated(object sender, EventArgs e)
{
    MessageBox.Show("The name is valid.");
}

Sécurité .NET Framework

Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, consultez Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.

Voir aussi

Référence

ContentControlBase Interface

Microsoft.Office.Tools.Word, espace de noms

Share via