DataAdapter.Fill Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Data.Common

Zestaw:: System.Data.Common.dll

Zestaw:: System.Data.dll

Zestaw:: netstandard.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Dodaje lub odświeża wiersze w obiekcie DataSet , aby dopasować je do tych w źródle danych.

Przeciążenia

Fill(DataSet)	Dodaje lub odświeża wiersze w obiekcie DataSet , aby dopasować je do tych w źródle danych.
Fill(DataTable, IDataReader)	Dodaje lub odświeża wiersze w obiekcie, DataTable aby były zgodne z tymi w źródle danych przy użyciu DataTable nazwy i określonej wartości IDataReader.
Fill(DataTable[], IDataReader, Int32, Int32)	Dodaje lub odświeża wiersze w określonym zakresie w kolekcji DataTable obiektów w celu dopasowania ich do tych w źródle danych.
Fill(DataSet, String, IDataReader, Int32, Int32)	Dodaje lub odświeża wiersze w określonym zakresie w DataSet celu dopasowania ich do tych w źródle danych przy użyciu nazw DataSet i .DataTable

Fill(DataSet)

Dodaje lub odświeża wiersze w obiekcie DataSet , aby dopasować je do tych w źródle danych.

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

Element do DataSet wypełnienia rekordami i, w razie potrzeby, schemat.

Zwraca

Int32

Liczba wierszy, które zostały pomyślnie dodane lub odświeżone w obiekcie DataSet. Nie obejmuje to wierszy, których dotyczą instrukcje, które nie zwracają wierszy.

Implementuje

Fill(DataSet)

Uwagi

Metoda Fill pobiera wiersze ze źródła danych przy użyciu instrukcji SELECT określonej przez skojarzą SelectCommand właściwość. Obiekt połączenia skojarzony z instrukcją SELECT musi być prawidłowy, ale nie musi być otwarty. Jeśli połączenie zostanie zamknięte przed Fill wywołaniem, zostanie otwarte w celu pobrania danych, a następnie zamknięte. Jeśli połączenie jest otwarte przed Fill wywołaniem, pozostaje otwarte.

Następnie Fill operacja dodaje wiersze do obiektów docelowych DataTable w obiekcie DataSet, tworząc DataTable obiekty, jeśli jeszcze nie istnieją. Podczas tworzenia DataTable obiektów Fill operacja zwykle tworzy tylko metadane nazwy kolumny. Jeśli jednak właściwość jest ustawiona MissingSchemaAction na AddWithKey, tworzone są również odpowiednie klucze podstawowe i ograniczenia.

Jeśli funkcja SelectCommand zwraca wyniki zewnętrznego sprzężenia, DataAdapter wartość nie ustawia PrimaryKey wartości wynikowej DataTable. Należy jawnie zdefiniować klucz podstawowy, aby upewnić się, że zduplikowane wiersze są poprawnie rozpoznawane. Aby uzyskać więcej informacji, zobacz Definiowanie kluczy podstawowych.

Jeśli karta danych napotka zduplikowane kolumny podczas wypełniania DataTablewartości , generuje nazwy kolejnych kolumn przy użyciu wzorca "columnname1", "columnname2", "columnname3" itd. Jeśli dane przychodzące zawierają nienazwane kolumny, są one umieszczane w DataSet zależności od wzorca "Column1", "Column2" i tak dalej. Po dodaniu wielu zestawów wyników do DataSet każdego zestawu wyników znajduje się oddzielna tabela. Dodatkowe zestawy wyników są nazwane przez dołączenie wartości całkowitych do określonej nazwy tabeli (na przykład "Tabela", "Tabela1", "Table2" itd.). Aplikacje korzystające z nazw kolumn i tabel powinny zapewnić, że nie występują konflikty z tymi wzorcami nazewnictwa.

Gdy instrukcja SELECT używana do wypełniania DataSet zwraca wiele wyników, takich jak instrukcje batch SQL, jeśli jeden z wyników zawiera błąd, wszystkie kolejne wyniki zostaną pominięte i nie zostaną dodane do obiektu DataSet.

Można użyć Fill metody wiele razy w tym samym DataTableobiekcie . Jeśli klucz podstawowy istnieje, wiersze przychodzące są scalane z pasującymi wierszami, które już istnieją. Jeśli klucz podstawowy nie istnieje, wiersze przychodzące są dołączane do elementu DataTable.

Uwaga

Podczas obsługi instrukcji SQL wsadowych, które zwracają wiele wyników, implementacja FillSchema .NET Framework Dostawca danych dla OLE DB pobiera informacje o schemacie tylko dla pierwszego wyniku. Aby pobrać informacje o schemacie dla wielu wyników, użyj Fill polecenia z zestawem MissingSchemaAction .AddWithKey

Zobacz też

Dotyczy

Fill(DataTable, IDataReader)

Dodaje lub odświeża wiersze w obiekcie, DataTable aby były zgodne z tymi w źródle danych przy użyciu DataTable nazwy i określonej wartości 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

Element do DataTable wypełnienia rekordami.

dataReader: IDataReader

Wystąpienie elementu IDataReader.

Zwraca

Int32

Liczba wierszy, które zostały pomyślnie dodane lub odświeżone w obiekcie DataTable. Nie obejmuje to wierszy, których dotyczą instrukcje, które nie zwracają wierszy.

Uwagi

Aby uzyskać DataAdapter.Fill(DataSet) dodatkowe informacje, zobacz uwagi.

Zobacz też

Omówienie ADO.NET

Dotyczy

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

Dodaje lub odświeża wiersze w określonym zakresie w kolekcji DataTable obiektów w celu dopasowania ich do tych w źródle danych.

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[]

Kolekcja DataTable obiektów do wypełnienia rekordami.

dataReader: IDataReader

Wystąpienie elementu IDataReader.

startRecord: Int32

Indeks zerowy rekordu początkowego.

maxRecords: Int32

Liczba całkowita wskazująca maksymalną liczbę rekordów.

Zwraca

Int32

Liczba wierszy, które zostały pomyślnie dodane lub odświeżone w obiekcie DataTable. Nie obejmuje to wierszy, których dotyczą instrukcje, które nie zwracają wierszy.

Uwagi

Aby uzyskać System.Data.Common.DataAdapter.Fill(System.Data.DataSet) dodatkowe informacje, zobacz uwagi.

Zobacz też

Omówienie ADO.NET

Dotyczy

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

Dodaje lub odświeża wiersze w określonym zakresie w DataSet celu dopasowania ich do tych w źródle danych przy użyciu nazw DataSet i .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

Element do DataSet wypełnienia rekordami.

srcTable: String

Ciąg wskazujący nazwę tabeli źródłowej.

dataReader: IDataReader

Wystąpienie elementu IDataReader.

startRecord: Int32

Indeks zerowy rekordu początkowego.

maxRecords: Int32

Liczba całkowita wskazująca maksymalną liczbę rekordów.

Zwraca

Int32

Liczba wierszy, które zostały pomyślnie dodane lub odświeżone w obiekcie DataSet. Nie obejmuje to wierszy, których dotyczą instrukcje, które nie zwracają wierszy.

Uwagi

Aby uzyskać System.Data.Common.DataAdapter.Fill(System.Data.DataSet) dodatkowe informacje, zobacz uwagi.

Zobacz też

Omówienie ADO.NET

Dotyczy