Instruções passo a passo: exibindo dados em um Windows Form
Um dos cenários mais comuns no desenvolvimento de aplicativos é exibir dados de um formulário em um aplicativo baseado no Windows. Você pode exibir dados em um formulário ao arrastar itens do Janela Fontes de Dados para o formulário. Este passo a passo cria um formulário simples que exibe dados de uma única tabela em vários controles individuais. Este exemplo usa a tabela Customers do banco de dados de exemplo Northwind.
As tarefas ilustradas neste passo a passo incluem:
Criando um novo projeto de Aplicativo do Windows.
Criando e configurando um dataset 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 um controle de associação de dados ao arrastar itens da janela Fontes de Dados para seu formulário.
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 o aplicativo do Windows
A primeira etapa é criar um projeto de Aplicativo do Windows.
Para criar o novo projeto de Aplicativo do Windows
No menu Arquivo, crie um novo projeto.
Nomeie o projeto como DisplayingDataonaWindowsForm.
Selecione Aplicativo do Windows e clique em OK. Para obter mais informações, consulte Implementando aplicativos cliente com o .NET Framework.
O projeto DisplayingDataonaWindowsForm é criado e adicionado ao Gerenciador de Soluções.
Criando a Fonte de Dados
Esta etapa cria uma fonte de dados usando o Assistente de Configuração de Fonte de Dados com base na tabela Customers no banco de dados de exemplo Northwind. É preciso ter acesso ao banco de dados de exemplo Northwind para criar a conexão. Para obter informações sobre como configurar o banco de dados de exemplo Northwind, consulte Como instalar bancos de dados de exemplo.
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.
Sobre o Escolha sua conexão de dados página faça o seguinte:
Se uma conexão de dados no banco de dados de exemplo Northwind estiver disponível na lista suspensa, selecione-o.
-ou-
Selecione Nova Conexão para iniciar a caixa de diálogo 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 a tabela Clientes e clique em Concluir.
O NorthwindDataSet é adicionado ao projeto e a tabela Clientes aparece na janela Fontes de Dados.
Configurando os controles a serem criados
Para este passo a passo, os dados estarão em um layout Detalhes em que os dados são exibidos em controles individuais. (A abordagem alternativa é o layout Grade padrão em que os dados são exibidos em um controle DataGridView.)
Definir o tipo de remoção dos itens na Janela Fontes de Dados
Expanda o nó Clientes na janela Fontes de Dados.
Altere o descarte de tipo da tabela Clientes para Detalhes selecionando Detalhes na lista suspensa no nó Clientes. Para obter mais informações, consulte Como definir o controle a ser criado quando arrastado da janela Fontes de Dados.
Altere o tipo de descarte da coluna CustomerID para um rótulo selecionando Rótulo na lista de controle no nó CustomerID.
Criando o formulário
Crie controles de associação de dados arrastando itens da janela Fontes de Dados para seu formulário.
Para criar controles de associação de dados no formulário
Arraste o nó principal Clientes da janela Fontes de Dados para o formulário.
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.
Testando o aplicativo
Para executar o aplicativo
Pressione F5.
Navegue nos registros usando o controle BindingNavigator.
Próximas etapas
Dependendo dos requisitos do aplicativo, existem várias etapas que você talvez queira realizar após criar um Windows Form 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.
Adicionar 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 que exibem os dados relacionados ao arrastar o nó Pedidos (abaixo da coluna Fax dentro da tabela Clientes) para o formulário. Para obter mais informações, consulte Como exibir dados relacionados em um aplicativo dos Windows Forms.
Consulte também
Conceitos
Associando controles dos Windows Forms a dados no Visual Studio
Visão geral de fontes de dados