ContentControlBase.Validated-Ereignis (2007 System)
Aktualisiert: November 2007
Tritt ein, wenn das Inhaltssteuerelement erfolgreich überprüft wurde.
Namespace: Microsoft.Office.Tools.Word
Assembly: Microsoft.Office.Tools.Word.v9.0 (in Microsoft.Office.Tools.Word.v9.0.dll)
Syntax
Public Event Validated As EventHandler
Dim instance As ContentControlBase
Dim handler As EventHandler
AddHandler instance.Validated, handler
public event EventHandler Validated
Hinweise
Behandeln Sie das Validated-Ereignis, um Code auszuführen, nachdem das Inhaltssteuerelement erfolgreich überprüft wurde.
Um das Inhaltssteuerelement zu überprüfen, behandeln Sie das Validating-Ereignis. Stellen Sie beim Validieren eines Inhaltssteuerelements sicher, dass der Text im Steuerelement bestimmte Bedingungen erfüllt. Wenn das Formular beispielsweise ein Inhaltssteuerelement mit einer Telefonnummer enthält, können Sie überprüfen, ob es tatsächlich nur entsprechende Zeichen enthält (Zahlen, Klammern, Bindestriche).
Weitere Informationen zur Ereignisbehandlung finden Sie unter Behandeln von Ereignissen.
Beispiele
Im folgenden Codebeispiel werden Ereignishandler für das Validated-Ereignis und das Validating-Ereignis dargestellt. Nachdem der Wert des Inhaltssteuerelements überprüft wurde, zeigt der Ereignishandler dem Benutzer ein Meldungsfeld für das Validated-Ereignis an.
In diesem Beispiel wird davon ausgegangen, dass das Dokument ein PlainTextContentControl mit dem Namen plainTextContentControl1 enthält. Wenn Sie diesen Code verwenden möchten, fügen Sie ihn in der ThisDocument-Klasse im Projekt ein. In C# müssen Sie außerdem die Ereignishandler an das Validated-Ereignis und das Validating-Ereignis von plainTextContentControl1 anfügen.
Dieses Beispiel bezieht sich auf eine Anpassung auf Dokumentebene.
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.");
}
Berechtigungen
- Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.