Compartilhar via


Demonstra Passo a passo: Preenchendo um Dataset com dados

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:

Pré-requisitos

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

Criando um Aplicativo Windows

A primeira etapa é criar um Windows Application.

Para criar o novo projeto Windows

  1. No Visual Studio, a partir do menu File, crie um novo Project.

  2. Nomeie o projeto como DatasetWalkthrough.

  3. Selecione Windows Application e clique em OK. Para obter mais informações, consulte Criando Aplicativos Baseados no Windows.

    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

  1. No menu Data, clique em Show Data Sources.

  2. Na janela Data Sources, clique em Add New Data Source para iniciar o Data Source Configuration Wizard.

  3. Selecione Database na página Choose a Data Source Type, e clique Next.

  4. 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).

  5. Se seu banco de dados exigir uma senha, selecione a opção para incluir dados confidenciais, e clique Next.

  6. Clique Next na página Save connection string to the Application Configuration file.

  7. Expanda o nó Tables na página Choose your Database Objects.

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

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

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

  2. 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);
    }
    
  3. 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:

Consulte também

Conceitos

ADO.NET DataSets

Vinculação de controles do Windows Forms a dados em Visual Studio

Controles de vinculação de dados de Visual Studio

Outros recursos

Explicações Passo a passo sobre Dados

Visão geral dos aplicativos de dados em Visual Studio

Conectando-se a Dados no Visual Studio

Preparando seu aplicativo para receber dados

Buscando dados em seu aplicativo

Editar dados no seu aplicativo

Validando Dados

Salvando dados