Ler em inglês

Compartilhar via


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

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:

Pré-requisitos

Para concluir este passo a passo, você precisará de:

Criando um aplicativo do Windows

A primeira etapa é criar um Aplicativo do Windows.

Para criar o novo projeto do Windows

  1. No Visual Studio, no menu Arquivo, crie um novo Projeto.

  2. Nomeie o projeto DatasetWalkthrough.

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

  1. No menu Dados, clique em Mostrar Fontes de Dados.

  2. Na janela Fontes de Dados, clique em Adicionar Nova Fonte de Dados para iniciar o Assistente de Configuração de Fonte de Dados.

  3. Selecione Base de dados na página Escolher um Tipo de Fonte de Dados e, em seguida, clique em Próximo.

  4. 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 o Adicionar/Modificar conexão caixa de diálogo.

  5. Se o banco de dados exigir uma senha, selecione a opção para incluir dados confidenciais e, em seguida, clique em Próximo.

  6. Clique em Avançar na página Salvar cadeia de caracteres de conexão no arquivo de configuração do aplicativo.

  7. Expanda o nó Tabelas na página Escolher Objetos do Banco de Dados.

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

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

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

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

Consulte também

Conceitos

DataSets ADO.NET

Associando controles dos Windows Forms a dados no Visual Studio

Preparando o aplicativo para receber dados

Buscando dados no aplicativo

Associando controles a dados no Visual Studio

Editando dados no aplicativo

Validando dados

Salvando dados

Outros recursos

Instruções passo a passo de dados

Visão geral de aplicativos de dados no Visual Studio

Conectando a dados no Visual Studio