Passo a passo: Criando uma tabela de pesquisa em um aplicativo do Windows Forms

Artigo
02/25/2013

Uma tabela de pesquisa (lookup table) é usada para exibir informações de uma tabela de acordo com o valor de um campo de chave externo de outra tabela.Por exemplo, considere uma tabela de pedidos em um banco de dados de vendas.Cada registro na tabela Pedidos inclui um CódigoDoCliente indicando qual cliente colocou a ordem.O CódigoDoCliente é uma chave estrangeira apontando para um registro de cliente na tabela Clientes.Convém exibir o nome real dos clientes, em vez do CódigoDoCliente, quando apresentar uma lista de pedidos (da tabela Pedidos).Como o nome do cliente está na tabela Clientes, e você está apresentando dados da tabela Pedidos, você precisa criar uma tabela de pesquisa, que recebe o valor CódigoDoCliente da tabela Pedidos, e usa esse valor para navegar pelo relacionamento e retornar um valor mais palpável, o nome do cliente.Esse conceito é conhecido como uma tabela de pesquisa.

Tarefas ilustradas nesta explicação passo a passo incluem:

Criando um novo projeto Windows Application.
Criar e configurar um DataSet com o Data Source Configuration Wizard.
Selecionando o controle a ser criado no formulário ao arrastar itens a partir da janela Data Sources.Para obter mais informações, consulte Como: definir o controle a ser criado ao arrastar da janela Data Sources.
Criando controles associados a dados arrastando itens da janela Data Sources até um formulário.
Configurando uma tabela de pesquisa soltando uma tabela relacionada em um controle associado por uma relação de chave estrangeira.

Pré-requisitos

Para concluir esta explicação passo a passo, você precisa:

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

Criando um novo aplicativo Windows

Para criar o novo projeto do Windows Application

No menu File, crie um novo projeto.
Nomeie o projeto LookupTableWalkthrough.
Selecione Windows Application e clique em OK.Para obter mais informações, consulte Desenvolvendo aplicativos clientes.

O projeto LookupTableWalkthrough é criado e adicionado ao Solution Explorer.

Criando uma nova fonte de dados

Para criar o DataSet

No menu Data, clique em Show Data Sources.
Na janela Data Sources, selecione Add New Data Source para iniciar o Data Source Configuration Wizard.
Selecione Database na página Choose a Data Source Type, e clique Next.
Na página Choose your Data Connection siga um destes procedimentos:
- Se uma conexão de dados para o banco de dados de exemplo Northwind estiver disponível na lista drop-down, selecione-o.
  
  - ou -
- Selecione New Connection para iniciar a caixa Add/Modify Connection.Para obter mais informações, consulte Adicionar/modificar a caixa de diálogo de conexão (geral).
Se seu banco de dados exigir uma senha, selecione a opção para incluir dados confidenciais, e clique Next.
Clique em Next na página Save connection string to the Application Configuration file.
Expanda o nó Tables na página Choose your Database Objects.
Selecione as tabelas Customers e Orders, e clique Finish.

O NorthwindDataSet é adicionado ao seu projeto e as duas tabelas aparecem na janela Data Sources .

Criando controles associados a dados no formulário

Para criar controles associados a dados no formulário

Expanda o nó Customers na janela Data Sources.
Altere o drop type da tabela Orders relacionada para Details selecionando Details na lista de controles no nó Orders.Para obter mais informações, consulte Como: definir o controle a ser criado ao arrastar da janela Data Sources.
Expanda o nó Orders relacionado e altere o drop type da coluna CustomerID para a uma combo box selecionando ComboBox na lista de controles no nó CustomerID.
Arraste o nó Orders relacionado da janela Data Sources para o Form1.

Controles associados a dados com rótulos descritivos aparecem no formulário, juntamente com uma faixa de ferramenta (BindingNavigator) para navegação em registros.Um NorthwindDataSet,CustomersTableAdapter, BindingSource e BindingNavigator aparecem na bandeja de componentes.

Criando a tabela de pesquisa

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

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

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

Observação
A tabela a seguir é para referência; apenas as propriedades são definidas automaticamente durante a ação de arrastar no procedimento anterior.O designer define as propriedades a seguir conforme descrito abaixo em " Explicação das configurações ".Dependendo das estruturas da sua tabela, você talvez precise ajustar as propriedades para a sua tabela de pesquisa funcionar corretamente.

Propriedade	Explicação sobre configuração
Fonte de dados	Visual Studio define essa propriedade como o BindingSource criado para a tabela que você arrasta para o controle (em oposição ao BindingSource criado quando o controle foi criado). Se você precisar fazer um ajuste, defina essa propriedade como o BindingSource da tabela com a coluna que você deseja exibir.(CustomersBindingSource para essa explicação passo a passo.)
Exibir Membro	O Visual Studio define essa propriedade como a primeira coluna após a chave primária que tem um tipo de dados cadeia de caracteres para a tabela que você arrastar para o controle. Se você precisar fazer um ajuste, defina essa propriedade como o nome da coluna que você deseja exibir.
Membro de Valor	O Visual Studio define esta propriedade como a primeira coluna participante da chave primária, ou a primeira coluna na tabela se nenhuma chave estiver definida. Se você precisar fazer um ajuste, defina essa propriedade como a chave primária na tabela com a coluna que você deseja exibir.
Valor Selecionado	O Visual Studio define essa propriedade como a coluna original arrastada da janela Data Sources. Se você precisar fazer um ajuste, defina essa propriedade como a coluna de chave externa na tabela relacionada.(CustomerID na tabela de Orders para essa explicação passo a passo.)

Executando o aplicativo

Para executar o aplicativo

Pressione F5.
Navegue pelos pedidos e certifique-se de que a caixa de combinação CustomerID exibe o CompanyName para cada pedido da tabela Customers (em vez da coluna CustomerID na tabela Orders).

Próximas etapas

Dependendo dos requisitos do aplicativo, há várias etapas que convém executar depois de criar um formulário de associação de dados.Alguns aprimoramentos que você poderia fazer a essa explicação passo a passo incluem:

Adicionar funcionalidade de pesquisa ao formulário.Para obter mais informações, consulte Como: adicionar uma consulta com parâmetros para um aplicativo do Windows Forms.
Adicionar funcionalidade para enviar atualizações de volta para o banco de dados.Para obter mais informações, consulte Passo a passo: Salvando dados em um banco de dados (Single Table).
Adicionar a tabela Orders ao DataSet selecionando Configure DataSet with Wizard de dentro da janela Data Sources.Em seguida você pode adicionar controles que exibem dados relacionados arrastando o nó Orders (aquele abaixo da coluna Fax dentro da tabelaCustomers) para o formulário.Para obter mais informações, consulte Como: exibir dados relacionados em um aplicativo do Windows Forms.