DataAdapter.Fill Método

public:
 abstract int Fill(System::Data::DataSet ^ dataSet);

public:
 virtual int Fill(System::Data::DataSet ^ dataSet);

public abstract int Fill(System.Data.DataSet dataSet);

public virtual int Fill(System.Data.DataSet dataSet);

abstract member Fill : System.Data.DataSet -> int

abstract member Fill : System.Data.DataSet -> int
override this.Fill : System.Data.DataSet -> int

Public MustOverride Function Fill (dataSet As DataSet) As Integer

Public Overridable Function Fill (dataSet As DataSet) As Integer

Parâmetros

Devoluções

O número de linhas adicionadas ou atualizadas com sucesso no DataSet. Isto não inclui linhas afetadas por instruções que não retornam linhas.

Implementações

Observações

O Fill método recupera linhas da fonte de dados usando a instrução SELECT especificada por uma propriedade associada SelectCommand . O objeto connection associado à instrução SELECT deve ser válido, mas não precisa de ser aberto. Se a ligação for fechada antes Fill de ser chamada, é aberta para recuperar dados e depois fechada. Se a ligação estiver aberta antes Fill de ser chamada, permanece aberta.

A Fill operação adiciona então as linhas aos objetos de destino DataTable no DataSet, criando os DataTable objetos se ainda não existirem. Ao criar DataTable objetos, a Fill operação normalmente cria apenas metadados do nome das colunas. No entanto, se a MissingSchemaAction propriedade for definida para AddWithKey, também são criadas chaves primárias e restrições apropriadas.

Se o SelectCommand retorna os resultados de um OUTER JOIN, o DataAdapter não define um PrimaryKey valor para o resultado DataTable. Deve definir explicitamente a chave primária para garantir que as linhas duplicadas são resolvidas corretamente. Para obter mais informações, consulte Definindo chaves primárias.

Se o adaptador de dados encontrar colunas duplicadas ao preencher um DataTable, gera nomes para as colunas seguintes, usando o padrão "nomecoluna1", "nomecoluna2", "nomecoluna3", e assim sucessivamente. Se os dados recebidos contêm colunas sem nome, são colocadas segundo DataSet o padrão "Coluna 1", "Coluna 2", e assim sucessivamente. Quando vários conjuntos de resultados são adicionados, DataSet cada conjunto de resultados é colocado numa tabela separada. Conjuntos de resultados adicionais são nomeados adicionando valores integrais ao nome da tabela especificado (por exemplo, "Table", "Table1", "Table2", entre outros). Aplicações que utilizam nomes de colunas e tabelas devem garantir que não ocorrem conflitos com estes padrões de nomenclatura.

Quando a instrução SELECT usada para preencher os DataSet devolve múltiplos resultados, como instruções SQL em lote, se um dos resultados contiver um erro, todos os resultados subsequentes são ignorados e não adicionados ao DataSet.

Pode usar o Fill método várias vezes no mesmo DataTable. Se existir uma chave primária, as linhas de entrada são fundidas com as linhas correspondentes que já existem. Se não existir uma chave primária, as linhas de entrada são adicionadas ao DataTable.

Ver também

• FillSchema(DataSet, SchemaType)
• Visão geral ADO.NET

protected:
 virtual int Fill(System::Data::DataTable ^ dataTable, System::Data::IDataReader ^ dataReader);

protected virtual int Fill(System.Data.DataTable dataTable, System.Data.IDataReader dataReader);

abstract member Fill : System.Data.DataTable * System.Data.IDataReader -> int
override this.Fill : System.Data.DataTable * System.Data.IDataReader -> int

Protected Overridable Function Fill (dataTable As DataTable, dataReader As IDataReader) As Integer

Parâmetros

Devoluções

O número de linhas adicionadas ou atualizadas com sucesso no DataTable. Isto não inclui linhas afetadas por instruções que não retornam linhas.

Observações

Consulte as observações para DataAdapter.Fill(DataSet) mais informações.

Ver também

• Visão geral ADO.NET

protected:
 virtual int Fill(cli::array <System::Data::DataTable ^> ^ dataTables, System::Data::IDataReader ^ dataReader, int startRecord, int maxRecords);

protected virtual int Fill(System.Data.DataTable[] dataTables, System.Data.IDataReader dataReader, int startRecord, int maxRecords);

abstract member Fill : System.Data.DataTable[] * System.Data.IDataReader * int * int -> int
override this.Fill : System.Data.DataTable[] * System.Data.IDataReader * int * int -> int

Protected Overridable Function Fill (dataTables As DataTable(), dataReader As IDataReader, startRecord As Integer, maxRecords As Integer) As Integer

Parâmetros

Devoluções

O número de linhas adicionadas ou atualizadas com sucesso no DataTable. Isto não inclui linhas afetadas por instruções que não retornam linhas.

Observações

Consulte as observações para System.Data.Common.DataAdapter.Fill(System.Data.DataSet) mais informações.

Ver também

• Visão geral ADO.NET

protected:
 virtual int Fill(System::Data::DataSet ^ dataSet, System::String ^ srcTable, System::Data::IDataReader ^ dataReader, int startRecord, int maxRecords);

protected virtual int Fill(System.Data.DataSet dataSet, string srcTable, System.Data.IDataReader dataReader, int startRecord, int maxRecords);

abstract member Fill : System.Data.DataSet * string * System.Data.IDataReader * int * int -> int
override this.Fill : System.Data.DataSet * string * System.Data.IDataReader * int * int -> int

Protected Overridable Function Fill (dataSet As DataSet, srcTable As String, dataReader As IDataReader, startRecord As Integer, maxRecords As Integer) As Integer

Parâmetros

Devoluções

O número de linhas adicionadas ou atualizadas com sucesso no DataSet. Isto não inclui linhas afetadas por instruções que não retornam linhas.

Observações

Consulte as observações para System.Data.Common.DataAdapter.Fill(System.Data.DataSet) mais informações.

Ver também

• Visão geral ADO.NET