Evento ContentControlBase.Validated
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.