DataAdapter.Fill Método

Definição

Adiciona ou atualiza linhas no DataSet para correspondência na fonte de dados.

Sobrecargas

Fill(DataSet)

Adiciona ou atualiza linhas no DataSet para correspondência na fonte de dados.

Fill(DataTable, IDataReader)

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

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

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

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

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

Fill(DataSet)

Adiciona ou atualiza linhas no DataSet para correspondência na fonte de dados.

public:
 virtual int Fill(System::Data::DataSet ^ dataSet);
public:
 abstract int Fill(System::Data::DataSet ^ dataSet);
public virtual int Fill (System.Data.DataSet dataSet);
public abstract int Fill (System.Data.DataSet dataSet);
abstract member Fill : System.Data.DataSet -> int
override this.Fill : System.Data.DataSet -> int
abstract member Fill : System.Data.DataSet -> int
Public Overridable Function Fill (dataSet As DataSet) As Integer
Public MustOverride Function Fill (dataSet As DataSet) As Integer

Parâmetros

dataSet
DataSet

Um DataSet a ser preenchido com registros e, se necessário, esquema.

Retornos

Int32

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

Implementações

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 estar 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, caso a propriedade MissingSchemaAction seja definida como AddWithKey, as chaves primárias apropriadas e as restrições também sã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 popular 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. Os conjuntos de resultados adicionais são nomeados adicionando-se 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 popular os DataSet resultados retorna vários resultados, como um lote SQL instruções, se um dos resultados contiver um erro, todos os resultados subsequentes serão ignorados e não adicionados ao DataSet.

Você pode usar o Fill método várias vezes no mesmo DataTable. Caso haja uma chave primária, as linhas de entrada são mescladas com linhas correspondentes já existentes. Caso não haja nenhuma chave primária, as linhas de entrada são acrescentadas ao DataTable.

Observação

Ao lidar com instruções de SQL em lote que retornam vários resultados, a implementação do FillSchema .NET Framework Provedor de Dados 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

Aplica-se a

Fill(DataTable, IDataReader)

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

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

Um DataTable para preencher com registros.

dataReader
IDataReader

Uma instância de IDataReader.

Retornos

Int32

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

Comentários

Consulte os comentários para DataAdapter.Fill(DataSet) obter informações adicionais.

Confira também

Aplica-se a

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

Adiciona ou atualiza as linhas em um intervalo especificado na coleção de objetos DataTable para corresponder àquelas na fonte de 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 objetos DataTable 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 com êxito a ou atualizadas no DataTable. Isso não inclui linhas afetadas por instruções que não retornam linhas.

Comentários

Consulte os comentários para System.Data.Common.DataAdapter.Fill(System.Data.DataSet) obter informações adicionais.

Confira também

Aplica-se a

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

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

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

Um 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 com êxito a ou atualizadas no DataSet. Isso não inclui linhas afetadas por instruções que não retornam linhas.

Comentários

Consulte os comentários para System.Data.Common.DataAdapter.Fill(System.Data.DataSet) obter informações adicionais.

Confira também

Aplica-se a