Como: Detetar quando o texto em uma caixa de texto foi alterado

Este exemplo mostra uma maneira de usar o evento TextChanged para executar um método sempre que o texto em um controle TextBox for alterado.

Na classe code-behind para o XAML que contém o controle TextBox que você deseja monitorar para alterações, insira um método para chamar sempre que o evento TextChanged for acionado. Este método deve ter uma assinatura que corresponda ao que é esperado pelo delegado TextChangedEventHandler.

O manipulador de eventos é chamado sempre que o conteúdo do controle TextBox é alterado, seja por um usuário ou programaticamente.

Definir controlo de caixa de texto

No Extensible Application Markup Language (XAML) que define seu controle TextBox, especifique o atributo TextChanged com um valor que corresponda ao nome do método do manipulador de eventos.

<TextBox  TextChanged="textChangedEventHandler">
  Here is the initial text in my TextBox.  Each time the contents of this TextBox are changed, 
  the TextChanged event  fires and textChangedEventHandler is called.
</TextBox>

Monitorizar as alterações no controlo TextBox

Na classe de código subjacente para o XAML que contém o controle TextBox que deseja monitorizar por alterações, insira um método para chamar sempre que o evento TextChanged for disparado. Este método deve ter uma assinatura que corresponda ao que é esperado pelo TextChangedEventHandler delegate.

// TextChangedEventHandler delegate method.
private void textChangedEventHandler(object sender, TextChangedEventArgs args)
{
    // Omitted Code: Insert code that does something whenever
    // the text changes...
} // end textChangedEventHandler

' TextChangedEventHandler delegate method.
Private Sub textChangedEventHandler(ByVal sender As Object, ByVal args As TextChangedEventArgs)
    ' Omitted Code: Insert code that does something whenever
    ' the text changes...
End Sub

O manipulador de eventos é chamado sempre que o conteúdo do controle TextBox é alterado, seja por um usuário ou programaticamente.

Observações

Ver também

• TextChangedEventArgs
• Visão geral do TextBox
• Visão geral do RichTextBox