Instruções passo a passo: criando uma tabela de pesquisa em um aplicativo dos Windows Forms

Artigo
08/17/2015

Uma tabela de pesquisa é usada para exibir informações de uma tabela com base no valor de um campo de chave estrangeira em outra tabela. Por exemplo, considere uma tabela de Pedidos em um banco de dados de vendas. Cada registro na tabela Pedidos inclui um CustomerID indicando qual cliente fez o pedido. O CustomerID é uma chave estrangeira apontando para um registro de cliente na tabela Clientes. Ao apresentar uma lista de Pedidos (da tabela Pedidos), você pode exibir o nome do cliente real, em vez de CustomerID. Como o nome dos clientes está na tabela de clientes e você está apresentando dados da tabela Pedidos, é necessário criar uma tabela de pesquisa, a qual obtém o valor CustomerID do registro Pedidos e usa esse valor para navegar pela relação e para retornar o nome do cliente mais legível. Esse conceito é conhecido como tabela de pesquisa.

As tarefas ilustradas neste passo a passo incluem:

Criando um novo projeto de Aplicativo do Windows.
Criando e configurando um conjunto de dados com o Assistente para Configuração da Fonte de Dados.
Selecionando o controle a ser criado no formulário ao arrastar itens da janela Fontes de Dados. Para obter mais informações, consulte Como definir o controle a ser criado quando arrastado da janela Fontes de Dados.
Criando controles de associação de dados ao arrastar itens da janela Fontes de Dados para um formulário.
Configurando uma tabela de pesquisa ao soltar uma tabela relacionada em um controle associado por meio de uma relação de chave estrangeira.

Pré-requisitos

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

Acesso ao banco de dados de exemplo Northwind. Para obter mais informações, consulte Como instalar bancos de dados de exemplo.

Criando um novo Aplicativo do Windows

Para criar o novo projeto de Aplicativo do Windows

No menu Arquivo, crie um novo projeto.
Nomeie o projeto como LookupTableWalkthrough.
Selecione Aplicativo do Windows e clique em OK. Para obter mais informações, consulte Implementando aplicativos cliente com o .NET Framework.

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

Criando uma nova fonte de dados

Para criar a fonte de dados

No menu Dados, clique em Mostrar Fontes de Dados.
Na janela Fontes de Dados, selecione Adicionar Nova Fonte de Dados para iniciar o Assistente de Configuração de Fonte de Dados.
Selecione Base de dados na página Escolher um Tipo de Fonte de Dados e, em seguida, clique em Próximo.
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.
Se o banco de dados exigir uma senha, selecione a opção para incluir dados confidenciais e, em seguida, clique em Próximo.
Clique em Avançar na página Salvar cadeia de caracteres de conexão no arquivo de configuração do aplicativo.
Expanda o nó Tabelas na página Escolher Objetos do Banco de Dados.
Selecione as tabelas Customers e Orders e, em seguida, clique em Finalizar.

O NorthwindDataSet é adicionado ao projeto e as duas tabelas aparecem na janela Fontes de Dados.

Criando controles de associação de dados no formulário

Para criar controles de associação de dados no formulário

Expanda o nó Clientes na janela Fontes de Dados.
Altere o tipo de descarte da tabela Pedido relacionada a Detalhes ao escolher Detalhes na lista de controle do nó Pedidos. Para obter mais informações, consulte Como definir o controle a ser criado quando arrastado da janela Fontes de Dados.
Expanda o nó relacionado de Pedidos e altere o tipo de descarte da coluna CustomerID para uma caixa de combinação, escolhendo ComboBox na lista de controle do nó CustomerID.
Arraste o nó Ordens relacionado da janela Fontes de Dados para 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 a tabela de pesquisa

Você estabelece a tabela de pesquisa ao definir as propriedades na caixa de combinação CustomerID:

Para criar a funcionalidade de tabela de pesquisa no formulário

Arraste o nó principal Customers da janela Fontes de Dados diretamente para a caixa de combinação CustomerID no Form1.

Dica

A tabela que segue é apenas para referência; as propriedades são definidas automaticamente durante a ação de arrastar no procedimento acima.O designer define as seguintes propriedades, como descrito na "Explicação da configuração" abaixo.Dependendo das estruturas de sua tabela, pode ser preciso ajustar as propriedades para que a tabela de pesquisa funcione corretamente.

Propriedade	Explicação da configuração
DataSource	O Visual Studio define esta propriedade para o BindingSource criado para a tabela que você arrasta para o controle (em oposição ao BindingSource criado quando o controle foi criado). Se for necessário fazer um ajuste, defina essa propriedade para o BindingSource da tabela com a coluna que você deseja exibir. (CustomersBindingSource para este passo a passo.)
DisplayMember	O Visual Studio define essa propriedade para a primeira coluna após a chave primária que tem um tipo de dado de cadeia da tabela que você arrasta para o controle. Se for necessário fazer um ajuste, defina essa propriedade para o nome da coluna que você deseja exibir.
ValueMember	O Visual Studio define essa propriedade para a primeira coluna participante da chave primária, ou a primeira coluna na tabela, se nenhuma chave for definida. Se for necessário fazer um ajuste, defina essa propriedade para a chave primária na tabela com a coluna que você deseja exibir.
SelectedValue	O Visual Studio define essa propriedade para a coluna original arrastada da janela Fontes de Dados. Se for necessário fazer um ajuste, defina essa propriedade para a coluna de chave estrangeira na tabela relacionada. (CustomerID na tabela Orders para este passo a passo.)

Executando o aplicativo

Para executar o aplicativo

Pressione F5.
Navegue pelos pedidos e verifique se a caixa de combinação CustomerID exibe o CompanyName de cada pedido da tabela Customers (em oposição à coluna CustomerID na tabela Orders).

Próximas etapas

Dependendo dos requisitos do aplicativo, existem várias etapas que você talvez queira realizar após criar um formulário de associação de dados. Entre algumas das melhorias que você poderia fazer nessa explicação passo a passo estão:

Adicionando funcionalidade de busca ao formulário. Para obter mais informações, consulte Como adicionar uma consulta parametrizada a um aplicativo dos Windows Forms.
Adicionando a funcionalidade para enviar atualizações de volta ao banco de dados. Para obter mais informações, consulte Instruções passo a passo: salvando dados em um banco de dados (tabela única).
Adicionar a tabela Orders ao conjunto de dados, selecionando Configurar DataSet com Assistente na janela Fontes de Dados. Em seguida, você pode adicionar controles para exibir os dados relacionados ao arrastar o nó relacionado Orders (abaixo da coluna Fax na tabela Clientes) para o formulário. Para obter mais informações, consulte Como exibir dados relacionados em um aplicativo dos Windows Forms.