Udostępnij za pośrednictwem


DataAdapter.Fill Metoda

Definicja

Dodaje lub odświeża wiersze w DataSet obiekcie w celu dopasowania ich do wierszy w źródle danych.

Przeciążenia

Fill(DataSet)

Dodaje lub odświeża wiersze w DataSet obiekcie w celu dopasowania ich do wierszy w źródle danych.

Fill(DataTable, IDataReader)

Dodaje lub odświeża wiersze w DataTable obiekcie w celu dopasowania ich do tych 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 wierszy w źródle danych.

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

Dodaje lub odświeża wiersze w określonym zakresie w DataSet obiekcie w celu dopasowania ich do tych w źródle danych przy użyciu DataSet nazw i DataTable .

Fill(DataSet)

Źródło:
DataAdapter.cs
Źródło:
DataAdapter.cs
Źródło:
DataAdapter.cs

Dodaje lub odświeża wiersze w DataSet obiekcie w celu dopasowania ich do wierszy 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 DataSet do wypełnienia rekordami i, w razie potrzeby, schemat.

Zwraca

Liczba wierszy pomyślnie dodanych do lub odświeżonych w pliku DataSet. Nie obejmuje to wierszy, których dotyczą instrukcje, które nie zwracają wierszy.

Implementuje

Uwagi

Metoda Fill pobiera wiersze ze źródła danych przy użyciu instrukcji SELECT określonej przez skojarzona 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 DataSetobiekcie , 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.

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

Jeśli karta danych napotka zduplikowane kolumny podczas wypełniania DataTableelementu , 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" itd. Gdy do każdego zestawu wyników jest dodawanych wiele zestawów wyników, należy umieścić DataSet w oddzielnej tabeli. Dodatkowe zestawy wyników są nazwane przez dołączenie wartości całkowitych do określonej nazwy tabeli (na przykład "Tabela", "Tabela1", "Tabela2" itd.). Aplikacje używające nazw kolumn i tabel powinny mieć pewność, że nie występują konflikty z tymi wzorcami nazewnictwa.

Gdy instrukcja SELECT użyta do wypełnienia 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 .DataSet

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

Uwaga

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

Zobacz też

Dotyczy

Fill(DataTable, IDataReader)

Źródło:
DataAdapter.cs
Źródło:
DataAdapter.cs
Źródło:
DataAdapter.cs

Dodaje lub odświeża wiersze w DataTable obiekcie w celu dopasowania ich do tych 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 DataTable do wypełnienia rekordami.

dataReader
IDataReader

Wystąpienie elementu IDataReader.

Zwraca

Liczba wierszy pomyślnie dodanych do lub odświeżonych w pliku DataTable. Nie obejmuje to wierszy, których dotyczą instrukcje, które nie zwracają wierszy.

Uwagi

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

Zobacz też

Dotyczy

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

Źródło:
DataAdapter.cs
Źródło:
DataAdapter.cs
Źródło:
DataAdapter.cs

Dodaje lub odświeża wiersze w określonym zakresie w kolekcji DataTable obiektów w celu dopasowania ich do wierszy 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 zaczynający się od zera.

maxRecords
Int32

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

Zwraca

Liczba wierszy pomyślnie dodanych do lub odświeżonych w pliku DataTable. Nie obejmuje to wierszy, których dotyczą instrukcje, które nie zwracają wierszy.

Uwagi

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

Zobacz też

Dotyczy

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

Źródło:
DataAdapter.cs
Źródło:
DataAdapter.cs
Źródło:
DataAdapter.cs

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

srcTable
String

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

dataReader
IDataReader

Wystąpienie elementu IDataReader.

startRecord
Int32

Indeks zaczynający się od zera.

maxRecords
Int32

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

Zwraca

Liczba wierszy pomyślnie dodanych do lub odświeżonych w pliku DataSet. Nie obejmuje to wierszy, których dotyczą instrukcje, które nie zwracają wierszy.

Uwagi

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

Zobacz też

Dotyczy