DataAdapter.Fill Metoda

Definice

Obor názvů:

System.Data.Common

Sestavení:

netstandard.dll, System.Data.Common.dll

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

Přetížení

Name	Description
Fill(DataSet)	Přidá nebo aktualizuje řádky ve DataSet zdroji dat tak, aby odpovídaly řádkům ve zdroji dat.
Fill(DataTable, IDataReader)	Přidá nebo aktualizuje řádky tak DataTable , aby odpovídaly řádkům ve zdroji dat pomocí DataTable názvu a zadaného IDataReader.
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 tak DataSet , aby odpovídaly řádkům ve zdroji dat pomocí názvů DataSet a DataTable názvů.

Fill(DataSet)

Zdroj:

DataAdapter.cs

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

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

Parametry

dataSet

DataSet

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

Návraty

Int32

Počet řádků, které byly úspěšně přidány nebo aktualizovány v souboru DataSet. Nezahrnuje řádky ovlivněné příkazy, které nevrací řádky.

Implementuje

Fill(DataSet)

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 je připojení před zavolání zavřené Fill , otevře se pro načtení dat a zavře se. Pokud je připojení otevřené před Fill zavolání, zůstane otevřené.

Operace Fill pak přidá řádky do cílových DataTable objektů v DataSetobjektu , vytváření DataTable objektů, pokud ještě neexistují. Při vytváření DataTable objektů Fill obvykle operace vytváří pouze metadata názvu sloupce. Pokud je však MissingSchemaAction vlastnost nastavena na AddWithKey, jsou vytvořeny také příslušné primární klíče a omezení.

Pokud SelectCommand vrátí výsledky vnějšího spojení, DataAdapter nenastaví hodnotu PrimaryKey pro výsledný DataTable. Musíte explicitně definovat primární klíč, aby se zajistilo, že se správně přeloží duplicitní řádky. Další informace naleznete v tématu Definování primárních klíčů.

Pokud datový adaptér při naplnění narazí DataTablena duplicitní sloupce, vygeneruje názvy pro následující sloupce pomocí vzoru "columnname1", "columnname2", "columnname3" atd. Pokud příchozí data obsahují nepojmenované sloupce, umístí se do DataSet vzoru Column1, Column2 atd. Když do DataSet každé sady výsledků přidáte více sad výsledků, umístí se do samostatné tabulky. Další sady výsledků jsou pojmenovány 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 nedošlo ke konfliktu s těmito vzory pojmenování.

Pokud příkaz SELECT použitý k naplnění DataSet vrátí více výsledků, například dávkové příkazy SQL, pokud některý z výsledků obsahuje chybu, všechny následné výsledky se přeskočí a nepřidají 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 k němu DataTablepříchozí řádky .

Poznámka:

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

Viz také

• FillSchema(DataSet, SchemaType)
• Přehled ADO.NET

Fill(DataTable, IDataReader)

Zdroj:

DataAdapter.cs

Přidá nebo aktualizuje řádky tak DataTable , aby odpovídaly řádkům ve zdroji dat pomocí DataTable názvu a zadaného 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

Parametry

dataTable

DataTable

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

dataReader

IDataReader

Instance IDataReader.

Návraty

Int32

Počet řádků, které byly úspěšně přidány nebo aktualizovány v souboru DataTable. Nezahrnuje řádky ovlivněné příkazy, které nevrací řádky.

Poznámky

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

Viz také

• Přehled ADO.NET

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

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

Int32

Počet řádků, které byly úspěšně přidány nebo aktualizovány v souboru DataTable. Nezahrnuje řádky ovlivněné příkazy, které nevrací řádky.

Poznámky

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

Viz také

• Přehled ADO.NET

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

Zdroj:

DataAdapter.cs

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

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 k 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

Int32

Počet řádků, které byly úspěšně přidány nebo aktualizovány v souboru DataSet. Nezahrnuje řádky ovlivněné příkazy, které nevrací řádky.

Poznámky

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

Viz také

• Přehled ADO.NET