Como: Localizar um elemento pelo seu nome

Este exemplo descreve como usar o método FindName para localizar um elemento por seu valor Name.

Exemplo

Neste exemplo, o método para localizar um elemento específico por seu nome é escrito como o manipulador de eventos de um botão. stackPanel é a Name do FrameworkElement raiz que está a ser pesquisado, e o método de exemplo indica visualmente o elemento encontrado convertendo-o para TextBlock e alterando uma das propriedades TextBlock visíveis da interface do utilizador.

void Find(object sender, RoutedEventArgs e)
{
    object wantedNode = stackPanel.FindName("dog");
    if (wantedNode is TextBlock)
    {
        // Following executed if Text element was found.
        TextBlock wantedChild = wantedNode as TextBlock;
        wantedChild.Foreground = Brushes.Blue;
    }
}

Private Sub Find(ByVal sender As Object, ByVal e As RoutedEventArgs)
    Dim wantedNode As Object = stackPanel.FindName("dog")
    If TypeOf wantedNode Is TextBlock Then
        ' Following executed if Text element was found.
        Dim wantedChild As TextBlock = TryCast(wantedNode, TextBlock)
        wantedChild.Foreground = Brushes.Blue
    End If
End Sub

Observação

O FindName método só localiza elementos que fazem parte do namescope XAML. Se um elemento for adicionado à árvore de objetos programaticamente depois que o XAML for carregado, o valor Name ou x:Name do elemento não será registrado automaticamente no namescope XAML. Para tornar um elemento adicionado dinamicamente localizável pelo nome, chame RegisterName no namescope XAML (normalmente a raiz da página ou da janela) antes de adicionar o elemento ao contêiner pai. Para obter mais informações, consulte Namescopes XAML.