DataAdapter.Fill Metoda

Definicja

Przestrzeń nazw:

System.Data.Common

Zestaw:

System.Data.Common.dll

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

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

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

Zwraca

Int32

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

Fill(DataSet)

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ż

• FillSchema(DataSet, SchemaType)
• Omówienie ADO.NET

Fill(DataTable, IDataReader)

Ź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

Int32

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ż

• Omówienie ADO.NET

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

Ź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

Int32

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ż

• Omówienie ADO.NET

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

Ź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

Int32

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ż

• Omówienie ADO.NET