Sdílet prostřednictvím


DataAdapter.Fill Metoda

Definice

Přidá nebo aktualizuje řádky v objektu tak DataSet , aby odpovídaly řádkům ve zdroji dat.

Přetížení

Fill(DataSet)

Přidá nebo aktualizuje řádky v objektu tak DataSet , aby odpovídaly řádkům ve zdroji dat.

Fill(DataTable, IDataReader)

Přidá nebo aktualizuje řádky v objektu tak DataTable , aby odpovídaly řádkům ve zdroji dat pomocí DataTable názvu a zadaného IDataReaderobjektu .

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

Přidá nebo aktualizuje řádky v zadané oblasti v kolekci DataTable objektů tak, aby odpovídaly řádkům ve zdroji dat.

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

Přidá nebo aktualizuje řádky v zadané oblasti v objektu , DataSet aby odpovídaly řádkům ve zdroji dat pomocí DataSet názvů a DataTable .

Fill(DataSet)

Zdroj:
DataAdapter.cs
Zdroj:
DataAdapter.cs
Zdroj:
DataAdapter.cs

Přidá nebo aktualizuje řádky v objektu tak DataSet , aby odpovídaly řádkům ve zdroji dat.

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

Parametry

dataSet
DataSet

A DataSet pro vyplnění záznamů a v případě potřeby schématu.

Návraty

Počet řádků, které byly úspěšně přidány do nebo aktualizovány v objektu DataSet. To nezahrnuje řádky ovlivněné příkazy, které nevracejí řádky.

Implementuje

Poznámky

Metoda Fill načte řádky ze zdroje dat pomocí příkazu SELECT určeného přidruženou SelectCommand vlastností. Objekt připojení přidružený k příkazu SELECT musí být platný, ale nemusí být otevřený. Pokud se připojení před Fill zavolání ukončí, otevře se za účelem načtení dat a pak se ukončí. Pokud je připojení před Fill zavolání otevřené, zůstane otevřené.

Operace Fill pak přidá řádky do cílových DataTable objektů v objektu DataSeta vytvoří DataTable objekty, pokud ještě neexistují. Při vytváření DataTable objektů Fill operace obvykle vytváří pouze metadata názvů sloupců. Pokud je ale vlastnost nastavená MissingSchemaAction na AddWithKey, vytvoří se také odpovídající primární klíče a omezení.

Pokud objekt SelectCommand vrátí výsledky VNĚJŠÍHO SPOJENÍ, DataAdapter nenastaví PrimaryKey hodnotu pro výsledný DataTableobjekt . Abyste zajistili správné překladu duplicitních řádků, musíte explicitně definovat primární klíč. Další informace najdete v tématu Definování primárních klíčů.

Pokud datový adaptér při vyplňování DataTablenarazí na duplicitní sloupce, vygeneruje názvy pro následující sloupce pomocí vzoru "název_sloupce1", "název_sloupce2", "název_sloupce3" atd. Pokud příchozí data obsahují nepojmenované sloupce, umisťují DataSet se do sloupců podle vzoru "Column1", "Column2" atd. Při přidání více sad výsledků dotazu se DataSet každá sada výsledků dotazu umístí do samostatné tabulky. Další sady výsledků se nazývají připojením integrálních hodnot k zadanému názvu tabulky (například "Tabulka", "Tabulka1", "Tabulka2" atd.). Aplikace používající názvy sloupců a tabulek by měly zajistit, aby nedocházelo ke konfliktům s těmito vzory pojmenování.

Když příkaz SELECT použitý k naplnění DataSet vrátí více výsledků, například dávkové příkazy SQL, pokud jeden z výsledků obsahuje chybu, všechny následné výsledky se přeskočí a nepřidají se do DataSet.

Metodu Fill můžete použít vícekrát na stejném DataTable. Pokud existuje primární klíč, příchozí řádky se sloučí s odpovídajícími řádky, které už existují. Pokud neexistuje žádný primární klíč, připojí se příchozí řádky k objektu DataTable.

Poznámka

Při zpracování dávkových příkazů SQL, které vrací více výsledků, implementace FillSchema pro zprostředkovatele dat rozhraní .NET Framework pro OLE DB načte informace o schématu pouze pro první výsledek. Pokud chcete načíst informace o schématu pro více výsledků, použijte Fill příkaz s nastavenou MissingSchemaAction na AddWithKey.

Viz také

Platí pro

Fill(DataTable, IDataReader)

Zdroj:
DataAdapter.cs
Zdroj:
DataAdapter.cs
Zdroj:
DataAdapter.cs

Přidá nebo aktualizuje řádky v objektu tak DataTable , aby odpovídaly řádkům ve zdroji dat pomocí DataTable názvu a zadaného IDataReaderobjektu .

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

Parametry

dataTable
DataTable

A DataTable pro vyplnění záznamů.

dataReader
IDataReader

Instance .IDataReader

Návraty

Počet řádků, které byly úspěšně přidány do nebo aktualizovány v objektu DataTable. To nezahrnuje řádky ovlivněné příkazy, které nevracejí řádky.

Poznámky

Další informace najdete v poznámkách DataAdapter.Fill(DataSet) k tématu .

Viz také

Platí pro

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

Zdroj:
DataAdapter.cs
Zdroj:
DataAdapter.cs
Zdroj:
DataAdapter.cs

Přidá nebo aktualizuje řádky v zadané oblasti v kolekci DataTable objektů tak, aby odpovídaly řádkům ve zdroji dat.

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

Parametry

dataTables
DataTable[]

Kolekce DataTable objektů, které se mají vyplnit záznamy.

dataReader
IDataReader

Instance .IDataReader

startRecord
Int32

Index počátečního záznamu založený na nule.

maxRecords
Int32

Celé číslo označující maximální počet záznamů.

Návraty

Počet řádků, které byly úspěšně přidány do nebo aktualizovány v objektu DataTable. To nezahrnuje řádky ovlivněné příkazy, které nevracejí řádky.

Poznámky

Další informace najdete v poznámkách System.Data.Common.DataAdapter.Fill(System.Data.DataSet) k tématu .

Viz také

Platí pro

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

Zdroj:
DataAdapter.cs
Zdroj:
DataAdapter.cs
Zdroj:
DataAdapter.cs

Přidá nebo aktualizuje řádky v zadané oblasti v objektu , DataSet aby odpovídaly řádkům ve zdroji dat pomocí DataSet názvů a 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

Parametry

dataSet
DataSet

A DataSet pro vyplnění záznamů.

srcTable
String

Řetězec označující název zdrojové tabulky.

dataReader
IDataReader

Instance .IDataReader

startRecord
Int32

Index počátečního záznamu založený na nule.

maxRecords
Int32

Celé číslo označující maximální počet záznamů.

Návraty

Počet řádků, které byly úspěšně přidány do nebo aktualizovány v objektu DataSet. To nezahrnuje řádky ovlivněné příkazy, které nevracejí řádky.

Poznámky

Další informace najdete v poznámkách System.Data.Common.DataAdapter.Fill(System.Data.DataSet) k tématu .

Viz také

Platí pro