Freigeben über

DataAdapter.Fill Methode

Definition

Namespace:
System.Data.Common
Assemblys:
netstandard.dll, System.Data.Common.dll
Assembly:
System.Data.Common.dll
Assembly:
System.Data.dll
Assembly:
netstandard.dll

Fügt Zeilen in der DataSet Datenquelle hinzu oder aktualisiert sie, um den Zeilen in der Datenquelle zu entsprechen.

Überlädt

Name Beschreibung
Fill(DataSet)

Fügt Zeilen in der DataSet Datenquelle hinzu oder aktualisiert sie, um den Zeilen in der Datenquelle zu entsprechen.
Fill(DataTable, IDataReader)

Fügt Zeilen in der DataTable Datenquelle mit dem DataTable Namen und dem angegebenen IDataReaderNamen hinzu oder aktualisiert sie, um zeilen in der Datenquelle abzugleichen.
Fill(DataTable[], IDataReader, Int32, Int32)

Fügt Zeilen in einem angegebenen Bereich in der Auflistung von DataTable Objekten hinzu oder aktualisiert sie, um mit denen in der Datenquelle übereinzustimmen.
Fill(DataSet, String, IDataReader, Int32, Int32)

Fügt Zeilen in einem angegebenen Bereich in DataSet einem angegebenen Bereich hinzu oder aktualisiert sie, um mit den Zeilen in der Datenquelle mit den Namen und DataTable den DataSet Zeilen in der Datenquelle übereinzustimmen.

Fill(DataSet)

Quelle:
DataAdapter.cs
Quelle:
DataAdapter.cs
Quelle:
DataAdapter.cs
Quelle:
DataAdapter.cs
Quelle:
DataAdapter.cs

Fügt Zeilen in der DataSet Datenquelle hinzu oder aktualisiert sie, um den Zeilen in der Datenquelle zu entsprechen.

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

Parameter

dataSet
DataSet

A DataSet zum Ausfüllen von Datensätzen und bei Bedarf schema.

Gibt zurück

Int32

Die Anzahl der Zeilen wurde erfolgreich hinzugefügt oder aktualisiert in der DataSet. Dies schließt keine Zeilen ein, die von Anweisungen betroffen sind, die keine Zeilen zurückgeben.

Implementiert

Fill(DataSet)

Hinweise

Die Fill Methode ruft Zeilen aus der Datenquelle mithilfe der SELECT-Anweisung ab, die durch eine zugeordnete SelectCommand Eigenschaft angegeben wird. Das mit der SELECT-Anweisung verknüpfte Verbindungsobjekt muss gültig sein, muss aber nicht geöffnet sein. Wenn die Verbindung vor dem Fill Aufruf geschlossen wird, wird sie geöffnet, um Daten abzurufen, und dann geschlossen. Wenn die Verbindung geöffnet ist, bevor Fill sie aufgerufen wird, bleibt sie geöffnet.

Der Fill Vorgang fügt dann die Zeilen zu Zielobjekten DataTable im DataSetObjekt hinzu, wodurch die DataTable Objekte erstellt werden, sofern sie noch nicht vorhanden sind. Beim Erstellen von DataTable Objekten erstellt der Fill Vorgang normalerweise nur Spaltennamenmetadaten. Wenn die MissingSchemaAction Eigenschaft jedoch auf AddWithKey festgelegt ist, werden auch geeignete Primärschlüssel und Einschränkungen erstellt.

Wenn vom SelectCommand die Ergebnisse eines OUTER JOIN zurückgegeben werden, wird vom DataAdapter kein PrimaryKey -Wert für die resultierende DataTablefestgelegt. Sie müssen den Primärschlüssel explizit definieren, um sicherzustellen, dass doppelte Zeilen ordnungsgemäß aufgelöst werden. Weitere Informationen finden Sie unter Definieren von Primärschlüsseln.

Wenn der Datenadapter beim Auffüllen doppelter DataTableSpalten auftritt, generiert er Namen für die nachfolgenden Spalten, wobei das Muster "Columnname1", "columnname2", "columnname3" usw. verwendet wird. Wenn die eingehenden Daten unbenannte Spalten enthalten, werden sie gemäß dem DataSet Muster "Spalte1", "Spalte2" usw. in das Muster eingefügt. Wenn dem resultset mehrere Resultsets hinzugefügt DataSet werden, wird in einer separaten Tabelle platziert. Zusätzliche Resultsets werden durch Anfügen integraler Werte an den angegebenen Tabellennamen benannt (z. B. "Tabelle", "Tabelle1", "Tabelle2" usw.). Anwendungen, die Spalten- und Tabellennamen verwenden, sollten sicherstellen, dass Konflikte mit diesen Benennungsmustern nicht auftreten.

Wenn die SELECT-Anweisung verwendet wird, um die DataSet zurückgegebenen ergebnisse zu füllen, z. B. eine SQL-Batch-Anweisung, wenn eines der Ergebnisse einen Fehler enthält, werden alle nachfolgenden Ergebnisse übersprungen und nicht hinzugefügt DataSet.

Sie können die Fill Methode mehrmals auf demselben DataTableVerwenden. Wenn ein Primärschlüssel vorhanden ist, werden eingehende Zeilen mit übereinstimmenden Zeilen zusammengeführt, die bereits vorhanden sind. Wenn kein Primärschlüssel vorhanden ist, werden eingehende Zeilen an die DataTable.

Hinweis

Bei der Verarbeitung von SQL-Batchanweisungen, die mehrere Ergebnisse zurückgeben, ruft die Implementierung FillSchema des .NET Framework-Datenanbieters für OLE DB Schemainformationen nur für das erste Ergebnis ab. Verwenden Sie Fill zum Abrufen von Schemainformationen für mehrere Ergebnisse den MissingSchemaAction Satz auf AddWithKey.

Weitere Informationen

Gilt für:

Fill(DataTable, IDataReader)

Quelle:
DataAdapter.cs
Quelle:
DataAdapter.cs
Quelle:
DataAdapter.cs
Quelle:
DataAdapter.cs
Quelle:
DataAdapter.cs

Fügt Zeilen in der DataTable Datenquelle mit dem DataTable Namen und dem angegebenen IDataReaderNamen hinzu oder aktualisiert sie, um zeilen in der Datenquelle abzugleichen.

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

Parameter

dataTable
DataTable

A DataTable zum Ausfüllen von Datensätzen.

dataReader
IDataReader

Eine Instanz von IDataReader.

Gibt zurück

Int32

Die Anzahl der Zeilen wurde erfolgreich hinzugefügt oder aktualisiert in der DataTable. Dies schließt keine Zeilen ein, die von Anweisungen betroffen sind, die keine Zeilen zurückgeben.

Hinweise

Weitere Informationen finden Sie in den Hinweisen DataAdapter.Fill(DataSet) .

Weitere Informationen

Gilt für:

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

Quelle:
DataAdapter.cs
Quelle:
DataAdapter.cs
Quelle:
DataAdapter.cs
Quelle:
DataAdapter.cs
Quelle:
DataAdapter.cs

Fügt Zeilen in einem angegebenen Bereich in der Auflistung von DataTable Objekten hinzu oder aktualisiert sie, um mit denen in der Datenquelle übereinzustimmen.

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

Parameter

dataTables
DataTable[]

Eine Auflistung von DataTable Objekten, die mit Datensätzen gefüllt werden sollen.

dataReader
IDataReader

Eine Instanz von IDataReader.

startRecord
Int32

Der nullbasierte Index des Startdatensatzes.

maxRecords
Int32

Eine ganze Zahl, die die maximale Anzahl von Datensätzen angibt.

Gibt zurück

Int32

Die Anzahl der Zeilen wurde erfolgreich hinzugefügt oder aktualisiert in der DataTable. Dies schließt keine Zeilen ein, die von Anweisungen betroffen sind, die keine Zeilen zurückgeben.

Hinweise

Weitere Informationen finden Sie in den Hinweisen System.Data.Common.DataAdapter.Fill(System.Data.DataSet) .

Weitere Informationen

Gilt für:

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

Quelle:
DataAdapter.cs
Quelle:
DataAdapter.cs
Quelle:
DataAdapter.cs
Quelle:
DataAdapter.cs
Quelle:
DataAdapter.cs

Fügt Zeilen in einem angegebenen Bereich in DataSet einem angegebenen Bereich hinzu oder aktualisiert sie, um mit den Zeilen in der Datenquelle mit den Namen und DataTable den DataSet Zeilen in der Datenquelle übereinzustimmen.

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

Parameter

dataSet
DataSet

A DataSet zum Ausfüllen von Datensätzen.

srcTable
String

Eine Zeichenfolge, die den Namen der Quelltabelle angibt.

dataReader
IDataReader

Eine Instanz von IDataReader.

startRecord
Int32

Der nullbasierte Index des Startdatensatzes.

maxRecords
Int32

Eine ganze Zahl, die die maximale Anzahl von Datensätzen angibt.

Gibt zurück

Int32

Die Anzahl der Zeilen wurde erfolgreich hinzugefügt oder aktualisiert in der DataSet. Dies schließt keine Zeilen ein, die von Anweisungen betroffen sind, die keine Zeilen zurückgeben.

Hinweise

Weitere Informationen finden Sie in den Hinweisen System.Data.Common.DataAdapter.Fill(System.Data.DataSet) .

Weitere Informationen

Gilt für: