Compartilhar via

Criar tabelas de pesquisa em aplicativos do WPF

  • Artigo

 

Publicado: abril de 2016

Você pode criar uma tabela de pesquisa arrastando o nó principal de uma tabela pai ou objeto de fontes de dados janela em um controle que já esteja associado a uma coluna ou propriedade em uma tabela filho relacionada. O termo tabela de pesquisa (às vezes chamado de um vinculação de pesquisa) descreve um controle que exibe informações de uma tabela de dados com base no valor de um campo de chave estrangeira em outra tabela.

Por exemplo, considere uma tabela de Orders em um banco de dados de venda. Cada registro de Orders tabela inclui um CustomerID que indica qual cliente fez o pedido. O CustomerID é uma chave estrangeira que aponta para um registro de cliente no Customers tabela. Quando você exibe uma lista de pedidos do Orders tabela, você talvez queira exibir o nome real do cliente em vez do CustomerID. Porque o nome do cliente está no Customers tabela, você precisa criar uma tabela de pesquisa para exibir o nome do cliente. Os usos da tabela de pesquisa a CustomerID valor o Orders registro para navegar pelo relacionamento e retornar o nome amigável do cliente.

Para criar uma tabela de pesquisa

  1. Adicione um dos seguintes tipos de fontes de dados com dados relacionados ao seu projeto:

    Dica

    Antes de criar uma tabela de pesquisa, duas tabelas relacionadas ou objetos devem existir como uma fonte de dados para o projeto.

  2. Abra o WPF Designer e certifique-se de que o designer contém um contêiner é um destino válido para itens no fontes de dados janela.

    Para obter mais informações sobre destinos depósitos válidos, consulte Associar controles WPF a dados no Visual Studio.

  3. Sobre o dados menu, clique em Show Data Sources para abrir o fontes de dados janela.

  4. Expanda os nós a fontes de dados janela até que você possa ver a tabela pai ou objeto e a tabela filho relacionada ou objeto.

    Dica

    A tabela filho relacionada ou o objeto é o nó que aparece como um nó filho expansível na tabela pai ou o objeto.

  5. Clique no menu suspenso para o nó filho e selecione detalhes.

  6. Expanda o nó filho.

  7. Sob o nó filho, clique no menu suspenso para o item que relaciona os dados pai e filho (no exemplo acima, isso seria o CustomerID nó). Selecione um dos seguintes tipos de controles que suportam associação de pesquisa:

  8. Arraste o nó filho do fontes de dados janela para um contêiner no WPF designer (no exemplo acima, o nó filho seria o pedidos nó).

    O Visual Studio gera XAML que cria novos controles ligados a dados para cada um dos itens que você arrasta. O XAML também adiciona um novo CollectionViewSource para a tabela filho ou o objeto para os recursos de destino de soltar. Para algumas fontes de dados, o Visual Studio também gera código para carregar dados para a tabela ou objeto. Para obter mais informações, consulte Associar controles WPF a dados no Visual Studio.

  9. Arraste o nó pai do fontes de dados janela para o controle de associação de pesquisa que você criou anteriormente (no exemplo acima, o nó pai seria o clientes nó).

    O Visual Studio define algumas propriedades do controle para configurar a associação de pesquisa. A tabela a seguir lista as propriedades que o Visual Studio modifica. Se necessário, você pode alterar essas propriedades no XAML ou de propriedades janela.

    Propriedade Explicação da configuração
    ItemsSource Esta propriedade especifica a coleção ou associação que é usada para obter os dados que são exibidos no controle. Visual Studio define essa propriedade para o CollectionViewSource para os dados pai que você arrastou para o controle.
    DisplayMemberPath Esta propriedade especifica o caminho do item de dados que é exibido no controle. Visual Studio define essa propriedade para a primeira coluna ou propriedade de dados pai, após a chave primária, que tem um tipo de dados de cadeia de caracteres.

    Se você quiser exibir uma coluna diferente ou a propriedade dos dados pai, altere essa propriedade para o caminho de uma propriedade diferente.
    SelectedValue Visual Studio vincula essa propriedade como a coluna ou propriedade de dados filho que você arrastou para o designer. Essa é a chave estrangeira para os dados pai.
    SelectedValuePath Visual Studio define essa propriedade para o caminho da coluna ou propriedade dos dados filho que é a chave estrangeira para os dados pai.

Consulte também

Associar controles WPF a dados no Visual Studio
Associar controles WPF a dados no Visual Studio
Exibir dados relacionados em aplicativos WPF
Instruções passo a passo: exibindo dados relacionados em um aplicativo WPF