Evento ContentControlBase.Validating
Ocorre quando o conteúdo do controle de conteúdo está sendo validado.
Namespace: Microsoft.Office.Tools.Word
Assembly: Microsoft.Office.Tools.Word (em Microsoft.Office.Tools.Word.dll)
Sintaxe
'Declaração
Event Validating As CancelEventHandler
event CancelEventHandler Validating
Comentários
O Validating evento é gerado quando o controle perde o foco. Lidar com o Validating evento para determinar se o texto no controle content é válido, de acordo com critérios que você escolher. Por exemplo, se você tiver um controle de conteúdo que contém um número de telefone, você pode verificar que ele contém apenas os caracteres apropriados (números, parênteses, hífens). Se o conteúdo não é válido, você pode cancelar o evento e retornar o foco para o controle definindo a Cancel propriedade da CancelEventArgs parâmetro do manipulador de eventos para true. O efeito prático é que o usuário não pode deixar o controle até que o texto é válido.
Para executar código após o controle de conteúdo foi validado com êxito, lidar com o Validated de evento.
Para obter mais informações sobre tratamento eventos, consulte Consumindo Eventos.
Exemplos
O exemplo de código a seguir demonstra os manipuladores de eventos para o Validating e Validated eventos. Depois que o usuário final altera o texto no conteúdo de controle, o manipulador de eventos para o Validating evento usa uma expressão regular para verificar se o texto não contêm números inteiros.
Este exemplo assume que o documento contém um PlainTextContentControl chamado plainTextContentControl1. Para usar esse código, colá-lo para o ThisDocument classe no projeto. Para C#, você também deve anexar os manipuladores de eventos para o Validated e Validating eventos de plainTextContentControl1.
Este exemplo é para uma personalização em nível de 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.");
}
Segurança do .NET Framework
- Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.