Evento ContentControlBase.Validated

Articolo
08/11/2011

Si verifica in caso di esito positivo della convalida del controllo contenuto.

Spazio dei nomi: Microsoft.Office.Tools.Word
Assembly: Microsoft.Office.Tools.Word (in Microsoft.Office.Tools.Word.dll)

Sintassi

'Dichiarazione
Event Validated As EventHandler

event EventHandler Validated

Note

Per eseguire il codice dopo la corretta convalida del controllo contenuto, gestire l'evento Validated.

Per convalidare il controllo contenuto, gestire l'evento Validating. La convalida di un controllo contenuto verifica che il testo del controllo soddisfi determinate condizioni. Se ad esempio si dispone di un controllo contenuto che include un numero di telefono, è possibile verificare che contenga soltanto i caratteri appropriati, quali numeri, parentesi, trattini e così via.

Per ulteriori informazioni sulla gestione degli eventi, vedere Utilizzo degli eventi.

Esempi

Nell'esempio di codice riportato di seguito vengono illustrati i gestori eventi per gli eventi Validated e Validating. Una volta convalidato il valore del controllo del contenuto, attraverso il gestore per l'evento Validated viene visualizzata una finestra di messaggio all'utente finale.

In questo esempio si presuppone che nel documento sia contenuto un oggetto PlainTextContentControl denominato plainTextContentControl1. Per utilizzare il codice, incollarlo nella classe ThisDocument del progetto. In C# è inoltre necessario collegare i gestori eventi agli eventi Validated e Validating di plainTextContentControl1.

Questo esempio è valido per una personalizzazione a livello di documento.

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.");
}

Sicurezza di .NET Framework

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.

Vedere anche

Riferimenti

ContentControlBase Interfaccia

Spazio dei nomi Microsoft.Office.Tools.Word

Condividi tramite