Demonstra Passo a passo: Criando uma tabela de pesquisa

Artigo
08/25/2010

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 externa 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 Assistente de Configuração de Fonte de Dados.
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: conjunto o controle to be Created when Dragging from the dados Sources janela.
Criando controles com dados vinculados, arrastando itens da janela Data Sources em um formulário.
Configurando uma tabela de pesquisa soltando uma tabela relacionada em um controle vinculado por uma relação de chave externa.

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 exemplo.

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 Criando Aplicativos Baseados no Windows.

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 Conexão Caixa de diálogo Box (Geral).
Se seu banco de dados exigir uma senha, selecione a opção para incluir dados confidenciais, e clique Next.
Clique 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 vinculados a dados no formulário

Para criar controles vinculado 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: conjunto o controle to be Created when Dragging from the dados Sources janela.
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 vinculados 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 é somente para referência; as propriedades são definidas automaticamente durante o arraste do procedimento acima.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 string 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 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 seu aplicativo, há várias etapas que você pode querer executar após criar um formulário vinculado a 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 parametrizada a um formulário em um aplicativos do Windows.
Adicionar funcionalidade para enviar atualizações de volta para o banco de dados.Para obter mais informações, consulte Demonstra Passo a passo: Salvando dados a um banco de dados (Single tabela).
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 aplicativos do Windows.