Passo a passo: Preenchendo um Dataset com dados

Artigo
02/25/2013

Esta explicação passo a passo cria um DataSet com uma tabela de dados e a preenche com dados da tabela Customers no banco de dados de exemplo Northwind.O DataSet é preenchido com dados chamando o método Fill de um TableAdapter.

Durante este explicação passo a passo, você aprenderá como:

Criar um novo Windows Application.
Criar e configurar um DataSet com o Data Source Configuration Wizard.
Criar um DataGridView vinculado a dados arrastando da janela Data Sources para um formulário.

Pré-requisitos

A fim de concluir este explicação passo a passo, será necessário:

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

Criando um Aplicativo Windows

A primeira etapa é criar um Windows Application.

Para criar o novo projeto Windows

No Visual Studio, a partir do menu File, crie um novo Project.
Nomeie o projeto como DatasetWalkthrough.
Selecione Windows Application e clique em OK.Para obter mais informações, consulte Desenvolvendo aplicativos clientes.

O projeto DatasetWalkthrough é criado e adicionado ao Solution Explorer.

Criando o NorthwindDataSet

Esta etapa cria um dataset usando o Data Source Configuration Wizard baseado na tabela Customers no banco de dados de exemplo Northwind.Você deve ter acesso ao banco de dados de exemplos 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 amostra.

Para criar o dataset

No menu Data, clique em Show Data Sources.
Na janela Data Sources, clique em 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 Next na página Save connection string to the Application Configuration file.
Expanda o nó Tables na página Choose your Database Objects.
Selecione a tabela Customers, e clique Finish.

O NorthwindDataSet é adicionado ao seu projeto e a tabela Customers aparece na janela Data Sources.

Adicionar os controles ao formulário

Você pode criar controles com dados vinculados, arrastando itens da janela Data Sources para um formulário no seu aplicativo do Windows.

Para criar um DataGridView acoplado à tabela Customers

Arraste o nó principal Customers da janela Data Sources no Form1.

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

Inspecionando o Código Gerado que Preenche o Dataset com Dados

Arrastando itens da janela Data Sources para um formulário adiciona automaticamente o código correto para preencher o dataset no manipulador de eventos Form1_Load.

Para carregar dados em um dataset

No Solution Explorer, selecione o Form1, e clique no botão View Code.

Inspecione o manipulador de eventos Form1_Load.O método Fill do TableAdapter preenche o dataset com 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);
}

Opcionalmente, você pode copiar este código para outras partes do seu aplicativo onde você precisar preencher o dataset.

Executando o aplicativo

Para executar o aplicativo

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

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 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.Então adicione controles que exibem dados relacionados, arrastando o nó Orders (aquele abaixo da coluna Fax dentro da tabela Customers) para o formulário.Para obter mais informações, consulte Como: exibir dados relacionados em um aplicativo do Windows Forms.