Instruções passo a passo: exibindo dados relacionados em um Windows Form

 

Publicado: agosto de 2016

Em vários cenários de aplicativo, você deseja trabalhar com dados provenientes de mais de uma tabela e, geralmente, dados de tabelas relacionadas. Ou seja, você deseja trabalhar com um relacionamento pai-filho. Por exemplo, talvez você queira criar um formulário em que selecionar um registro do cliente exibe os pedidos desse cliente. Exibir os registros relacionados no formulário é possível ao configurar a propriedade DataSource do BindingSource filho para o BindingSource pai (não a tabela filha) e ao configurar a propriedade DataMember do BindingSource filho para a relação de dados que une as tabelas pai e filha.

As tarefas ilustradas neste passo a passo incluem:

• Criando um projeto de Aplicativo do Windows.

• Criando e configurando um conjunto de dados em seu aplicativo com base nas tabelas Customers e Orders no banco de dados Northwind usando o Assistente para Configuração da Fonte de Dados.

• Adicionando controles para exibir dados na tabela Customers.

• Adicionando controles para exibir os Orders com base no Customer selecionado.

• Testando o aplicativo ao selecionar clientes diferentes e verificar se os pedidos corretos são exibidos para o cliente selecionado.

Pré-requisitos

Para concluir este passo a passo, você precisará de:

• Acesso ao banco de dados de exemplo Northwind. Para configurar bancos de dados de exemplo, consulte Como instalar bancos de dados de exemplo.

Criando o Projeto

A primeira etapa é criar um Aplicativo do Windows.

Para criar o projeto de Aplicativo do Windows

1. No menu Arquivo, crie um novo projeto.

2. Nomeie o projeto como RelatedDataWalkthrough.

3. Selecione Aplicativo do Windows e clique em OK. Para obter mais informações, consulte Implementando aplicativos cliente com o .NET Framework.

   O projeto RelatedDataWalkthrough é criado e adicionado ao Gerenciador de Soluções.

Criando a Fonte de Dados

Esta etapa cria um conjunto de dados com base nas tabelas Customers e Orders do banco de dados de exemplo Northwind.

Para criar a fonte de dados

1. No menu Dados, clique em Mostrar Fontes de Dados.

2. Na janela Fontes de Dados, selecione Adicionar Nova Fonte de Dados para iniciar o Assistente de Configuração de Fonte de Dados.

3. Selecione Base de dados na página Escolher um Tipo de Fonte de Dados e, em seguida, clique em Próximo.

4. Na página Escolha a Conexão de Dados, faça o seguinte:

   • Se uma conexão de dados com o banco de dados de exemplo Northwind estiver disponível na lista suspensa, selecione-o.

     -ou-

   • Selecione Nova Conexão para iniciar a caixa Adicionar/Modificar Conexão.

5. Se o banco de dados exigir uma senha, selecione a opção para incluir dados confidenciais e, em seguida, clique em Próximo.

6. Clique em Avançar na página Salvar cadeia de caracteres de conexão no arquivo de configuração do aplicativo.

7. Expanda o nó Tabelas na página Escolher Objetos do Banco de Dados.

8. Selecione as tabelas Customers e Orders e, em seguida, clique em Finalizar.

   O NorthwindDataSet é adicionado ao projeto e a tabela Clientes aparece na janela Fontes de Dados.

Criando Controles para Exibir Dados com base na Tabela Customers

Para criar controles a fim de exibir os dados do cliente (registros pai)

1. Na janela Fontes de Dados, selecione a tabela Customers e, em seguida, clique na seta suspensa.

2. Escolha Detalhes no menu.

3. Arraste o nó principal Clientes da janela Fontes de Dados para a parte superior do Form1.

   Os controles de associação de dados com rótulos descritivos são exibidos no formulário, juntamente com uma faixa de ferramentas (BindingNavigator) para registros de navegação. Um NorthwindDataSet, CustomersTableAdapter, BindingSource e BindingNavigator são exibidos na bandeja de componentes.

Criando Controles para Exibir Dados da Tabela Orders

Para criar controles para exibir os pedidos de cada cliente (registros filho)

• Na janela Fontes de Dados, expanda o nó Clientes e selecione a última coluna na tabela Clientes, que é um nó expansível Pedidos e arraste-a para a parte inferior do Form1.

  Um DataGridView é adicionado ao formulário e um novo BindingSource (OrdersBindingSource) e um TableAdapter (OrdersTableAdapter) são adicionados à bandeja de componentes.

  Dica

  Abra a Janela Propriedades e selecione OrdersBindingSource.Inspecione as propriedades DataSource e DataMember para ver como a associação está configurada para exibir registros relacionados.O DataSource está configurado como CustomersBindingSource (o BindingSource da tabela pai), em vez da tabela Orders.A propriedade DataMember está configurada como FK_Orders_Customers, que é o nome do objeto DataRelation que relaciona as tabelas juntas.

Testando o aplicativo

Para testar o aplicativo

1. Pressione F5 para executar o aplicativo.

2. Selecione clientes diferentes usando o CustomersBindingNavigator para verificar se as ordens corretas são exibidas no DataGridView.

Próximas etapas

Dependendo dos requisitos de aplicativo, existem várias etapas que você talvez queira realizar após criar um formulário de detalhes mestre. Uma melhoria que você poderia fazer neste passo a passo é:

• Filtrar os registros de Customers adicionando parametrização à tabela Customers. Para fazer isso, selecione qualquer controle que exiba dados da tabela Customers, clique na marca inteligente e escolha Adicionar Consulta. Preencha a Caixa de diálogo Pesquisar Construtor de Critérios. Para obter mais informações, consulte Como adicionar uma consulta parametrizada a um aplicativo dos Windows Forms.

Consulte também

Instruções passo a passo de dados
Janela Fontes de Dados
Associar controles dos Windows Forms a dados no Visual Studio
Adicionar novas fontes de dados
Visão geral de TableAdapter
Como exibir dados relacionados em um Aplicativo do Windows Forms
Visão geral do componente BindingSource
Visão geral do controle BindingNavigator (Windows Forms)