Partilhar via


Como: preencher um Dataset com dados

A frase "preenchendo um dataset com dados" se refere a carregar dados para os objetos individuais DataTable que compõem o DataSet.Você preenche as tabelas de dados executando consultas do TableAdapter ou executando comandos do adaptador de dados (por exemplo, SqlDataAdapter) .

Se você deve usar TableAdapters ou adaptadores de dados depende de como você criou o DataSet.Se você usou as ferramentas de design no Visual Studio, como o Data Source Configuration Wizard, seu dataset contém TableAdapters.Para obter mais informações sobre TableAdapters, consulte Visão geral do TableAdapter.Se você criou o DataSet programaticamente, será necessário criar adaptadores de dados para carregar dados nas tabelas de dados.

ObservaçãoObservação

Ao arrastar itens da Janela fontes de dados para um formulário, o código para preencher a tabela de dados com dados é adicionado automaticamente para o manipulador de eventos Form_Load.Abra o formulário no code editor para ver a sintaxe exata para preencher as suas tabelas específicas.Se você não desejar preencher a tabela quando o formulário é carregado, mova este código para algum outro método, ou remova-o totalmente.

Preenchendo um DataSet usando um TableAdapter

Você pode chamar uma consulta no TableAdapter para carregar dados em tabelas de dados em um DataSet.Passe o DataTable que você deseja preencher para a consulta do TableAdapter.Se sua consulta usa parâmetros, passe-os para o método.Se o DataSet conter várias tabelas, você deve ter TableAdapters separados para cada tabela e portanto deve preencher cada tabela separadamente.

ObservaçãoObservação

Por padrão, sempre que você executa uma consulta do TableAdapter, os dados na tabela são desmarcados antes dos resultados da consulta que está sendo carregado na tabela.Você pode manter os dados existentes na tabela e anexar os resultados configurando a propriedade ClearBeforeFill do TableAdapter para false.

Para preencher um DataSet com dados usando um TableAdapter

  1. Abra seu formulário ou componente no Code Editor.

  2. Adicione código em qualquer lugar em seu aplicativo onde você precisa carregar uma tabela de dados com dados.Se sua consulta não aceita parâmetros, passe na DataTable que você deseja preencher.O código deve ser semelhante ao seguinte:

    Me.CustomersTableAdapter.Fill(Me.NorthwindDataSet.Customers)
    
    this.customersTableAdapter.Fill(this.northwindDataSet.Customers);
    
  3. Se sua consulta usa parâmetros, passe a DataTable que você deseja preencher e os parâmetros esperados pela consulta.Dependendo dos parâmetros atuais em sua consulta, o código deve ser semelhante aos exemplos a seguir:

    CustomersTableAdapter.FillByCity(NorthwindDataSet.Customers, "Seattle")
    CustomersTableAdapter.FillByCityAndState(NorthwindDataSet.Customers, "Seattle", "WA")
    
    customersTableAdapter.FillByCity(northwindDataSet.Customers, "Seattle");
    customersTableAdapter.FillByCityAndState(northwindDataSet.Customers, "Seattle", "WA");
    

Preenchendo um DataSet usando um DataAdapter

Você chama o método Fill do adaptador de dados.Isso faz com que o adaptador execute a instrução SQL ou o procedimento armazenado referenciado na sua propriedade SelectCommand e coloca os resultados em uma tabela no DataSet.Se o DataSet contém várias tabelas, você deve ter adaptadores de dados separados para cada tabela e portanto deve preencher cada tabela separadamente.

Para preencher um DataSet com dados usando um DataAdapter

  • Chame o método Fill do DataAdapter, passando o DataSet ou a DataTable para carregar os dados.Por exemplo:

    sqlDataAdapter1.Fill(dataset1.Tables("Customers"))
    
    sqlDataAdapter1.Fill(dataset1.Tables["Customers"]);
    

    Geralmente você deve fornecer o nome da DataTable para carregar os dados.Se você passar o nome de um DataSet em vez de uma tabela de dados específica, uma DataTable denominada Table1 é adicionada ao dataset e carregada com os resultados do banco de dados (em oposição a carregar os dados em um DataTable existente no dataset).Para obter mais informações, consulte Populating a DataSet from a DataAdapter.

Consulte também

Conceitos

Preencher Datasets com dados

Buscando dados em seu aplicativo.

Preparando seu aplicativo para receber dados

Controles de vinculação de dados de Visual Studio

Edição de dados em seu aplicativo.

Validação de dados

Salvar dados