Instruções passo a passo: preenchendo um conjunto de dados com Dados

Artigo
08/17/2015

Este passo a passo cria um conjunto de dados com uma tabela de dados e o preenche com dados da tabela Customers no banco de dados de exemplo Northwind. O conjunto de dados é preenchido com dados chamando o método Fill de um TableAdapter.

Durante este passo a passo, você aprenderá a:

Criar um novo Aplicativo do Windows.
Criar e configurar um conjunto de dados com o Assistente para Configuração da Fonte de Dados.
Crie um DataGridView de associação de dados arrastando itens da janela Fontes de Dados para um 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 um aplicativo do Windows

A primeira etapa é criar um Aplicativo do Windows.

Para criar o novo projeto do Windows

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

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

Criando o NorthwindDataSet

Esta etapa cria um conjunto de dados usando o Assistente de Configuração de Fonte de Dados baseado 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 o conjunto de dados

No menu Dados, clique em Mostrar Fontes de Dados.
Na janela Fontes de Dados, clique em 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 a tabela Clientes e clique em Concluir.

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

Adicionando controles ao formulário

Você pode criar controles de associação de dados arrastando itens da janela Fontes de Dados para um formulário em seu aplicativo do Windows.

Para criar um DataGridView associado à tabela Clientes

Arraste o nó principal Clientes da janela Fontes de Dados para Form1.

Um controle DataGridView e uma faixa de ferramentas (BindingNavigator) para navegação em registros são exibidos no formulário. Um NorthwindDataSet, CustomersTableAdapter, BindingSource e BindingNavigator são exibidos na bandeja de componentes.

Inspecionando o código gerado que preenche o conjunto de dados

Arrastar itens da janela Fontes de Dados para um formulário adiciona automaticamente o código correto para preencher o conjunto de dados no manipulador de eventos Form1_Load.

Para carregar dados em um conjunto de dados

No Gerenciador de Soluções , selecione o Form1 e clique no botão Exibir Código.

Inspecione o manipulador de eventos Form1_Load. O método Fill do TableAdapter preenche o conjunto de dados com os dados.

Private Sub Form1_Load() Handles MyBase.Load

    'TODO: This line of code loads data into the 'NorthwindDataSet1.Customers' table.
    'You can move, or remove it, as needed.

    Me.CustomersTableAdapter1.Fill(Me.NorthwindDataSet1.Customers)
End Sub

private void Form1_Load(object sender, EventArgs e)
{
    // TODO: This line of code loads data into the 'northwindDataSet1.Customers' table.
    // You can move, or remove it, as needed.

    this.customersTableAdapter1.Fill(this.northwindDataSet1.Customers);
}

Se desejar, você pode copiar esse código para outras partes do seu aplicativo, para preencher o conjunto de dados.

Executando o aplicativo

Para executar o aplicativo

Pressione F5 para executar o aplicativo.
O conjunto de dados é preenchido com os dados e é exibido no DataGridView.

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. Agora adicione os controles que exibem dados relacionados, arrastando o nó Pedidos (abaixo da coluna Fax no dentro da tabela Clientes) para o formulário. Para obter mais informações, consulte Como exibir dados relacionados em um aplicativo dos Windows Forms.