DataAdapter.Fill Método

Definição

Namespace:

System.Data.Common

Assemblies:

netstandard.dll, System.Data.Common.dll

Adiciona ou atualiza linhas para DataSet corresponder àquelas na fonte de dados.

Sobrecargas

Nome	Description
Fill(DataSet)	Adiciona ou atualiza linhas para DataSet corresponder àquelas na fonte de dados.
Fill(DataTable, IDataReader)	Adiciona ou atualiza linhas para DataTable corresponder àquelas na fonte de dados usando o DataTable nome e o especificado IDataReader.
Fill(DataTable[], IDataReader, Int32, Int32)	Adiciona ou atualiza linhas em um intervalo especificado na coleção de objetos para corresponder às da fonte de DataTable dados.
Fill(DataSet, String, IDataReader, Int32, Int32)	Adiciona ou atualiza linhas em um intervalo especificado para corresponder àquelas DataSet na fonte de dados usando o nome e DataTable o DataSet nome.

Fill(DataSet)

Origem:

DataAdapter.cs

Adiciona ou atualiza linhas para DataSet corresponder àquelas na fonte de dados.

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

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

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

Public Overridable Function Fill (dataSet As DataSet) As Integer

Parâmetros

dataSet

DataSet

Um DataSet para preencher com registros e, se necessário, esquema.

Retornos

Int32

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

Implementações

Fill(DataSet)

Comentários

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

Em Fill seguida, a operação adiciona as linhas aos objetos de destino DataTable , DataSetcriando os DataTable objetos se eles ainda não existirem. Ao criar DataTable objetos, a Fill operação normalmente cria apenas metadados de nome de coluna. No entanto, se a MissingSchemaAction propriedade estiver definida como AddWithKey, as chaves primárias e as restrições apropriadas também serão criadas.

Se o SelectCommand retornar os resultados de um OUTER JOIN, o DataAdapter não definirá um valor de PrimaryKey para oDataTable resultante. Você deve definir explicitamente a chave primária para garantir que as linhas duplicadas sejam resolvidas corretamente. Para obter mais informações, consulte Definindo chaves primárias.

Se o adaptador de dados encontrar colunas duplicadas ao preencher uma DataTable, ele gerará nomes para as colunas subsequentes, usando o padrão "columnname1", "columnname2", "columnname3" e assim por diante. Se os dados de entrada contiverem colunas sem nome, eles serão colocados de acordo com o DataSet padrão "Column1", "Column2" e assim por diante. Quando vários conjuntos de resultados são adicionados a DataSet cada conjunto de resultados é colocado em uma tabela separada. Conjuntos de resultados adicionais são nomeados acrescentando valores integrais ao nome da tabela especificado (por exemplo, "Tabela", "Tabela1", "Tabela2" e assim por diante). Os aplicativos que usam nomes de coluna e tabela devem garantir que conflitos com esses padrões de nomenclatura não ocorram.

Quando a instrução SELECT usada para preencher os DataSet resultados retorna vários resultados, como instruções SQL em lote, se um dos resultados contiver um erro, todos os resultados subsequentes serão ignorados e não adicionados DataSetao .

Você pode usar o Fill método várias vezes no mesmo DataTable. Se existir uma chave primária, as linhas de entrada serão mescladas com linhas correspondentes que já existem. Se nenhuma chave primária existir, as linhas de entrada serão acrescentadas ao DataTable.

Observação

Ao manipular instruções SQL em lote que retornam vários resultados, a implementação do provedor de FillSchema dados do .NET Framework para OLE DB recupera informações de esquema apenas para o primeiro resultado. Para recuperar informações de esquema para vários resultados, use Fill com o MissingSchemaAction conjunto como AddWithKey.

Confira também

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

Fill(DataTable, IDataReader)

Origem:

DataAdapter.cs

Adiciona ou atualiza linhas para DataTable corresponder àquelas na fonte de dados usando o DataTable nome e o especificado IDataReader.

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

dataTable

DataTable

A DataTable para preencher com registros.

dataReader

IDataReader

Uma instância de IDataReader.

Retornos

Int32

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

Comentários

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

Confira também

• Visão geral do ADO.NET

Fill(DataTable[], IDataReader, Int32, Int32)

Origem:

DataAdapter.cs

Adiciona ou atualiza linhas em um intervalo especificado na coleção de objetos para corresponder às da fonte de DataTable dados.

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

dataTables

DataTable[]

Uma coleção de DataTable objetos a serem preenchidos com registros.

dataReader

IDataReader

Uma instância de IDataReader.

startRecord

Int32

O índice baseado em zero do registro inicial.

maxRecords

Int32

Um inteiro que indica o número máximo de registros.

Retornos

Int32

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

Comentários

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

Confira também

• Visão geral do ADO.NET

Fill(DataSet, String, IDataReader, Int32, Int32)

Origem:

DataAdapter.cs

Adiciona ou atualiza linhas em um intervalo especificado para corresponder àquelas DataSet na fonte de dados usando o nome e DataTable o DataSet nome.

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

dataSet

DataSet

A DataSet para preencher com registros.

srcTable

String

Uma cadeia de caracteres que indica o nome da tabela de origem.

dataReader

IDataReader

Uma instância de IDataReader.

startRecord

Int32

O índice baseado em zero do registro inicial.

maxRecords

Int32

Um inteiro que indica o número máximo de registros.

Retornos

Int32

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

Comentários

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

Confira também

• Visão geral do ADO.NET