Compartilhar via


Como detectar 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 tiver sido alterado.

Na classe code-behind do XAML que contém o controle TextBox que você deseja monitorar para alterações, insira um método que seja chamado sempre que o evento TextChanged for acionado. Esse método deve ter uma assinatura que corresponda ao 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.

Nota

Esse evento é acionado quando o controle TextBox é criado e inicialmente preenchido com texto.

Definir controle TextBox

Na XAML (Extensible Application Markup Language) que define o 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>

Monitorar as alterações no controle do TextBox

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

// 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.

Nota

Esse evento é acionado quando o controle TextBox é criado e inicialmente preenchido com texto.

Comentários

Consulte também