Evento ContentControlBase.Validating

Artigo
08/01/2011

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.

Consulte também

Referência

ContentControlBase Interface

Namespace Microsoft.Office.Tools.Word

Compartilhar via