Como: Preencher um DataSet com dados

Artigo
08/25/2010

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 Assistente de Configuração de Fonte de Dados, 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.Para obter mais informações, consulte Introdução a adaptadores de dados.

Observação:
Ao arrastar itens a partir do Janela Fontes de Dados em um formulário, o código para preencher a tabela de dados com dados será automaticamente adicionado para o Form_Load manipulador de eventos. 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.

Ao arrastar itens a partir do Janela Fontes de Dados em um formulário, o código para preencher a tabela de dados com dados será automaticamente adicionado para o Form_Load manipulador de eventos. 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çã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 acrescentar os resultados com a configuração do TableAdapter ClearBeforeFill propriedade para false.

Para preencher um DataSet com dados usando um TableAdapter

Abra seu formulário ou componente no Code Editor.
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);
```

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 Preenchendo um DataSet de um DataAdapter.