DataAdapter.Fill DataAdapter.Fill DataAdapter.Fill DataAdapter.Fill Method

Definition

Fügt dem DataSet Zeilen hinzu oder aktualisiert diese, um Übereinstimmung mit den Zeilen in der Datenquelle herzustellen. Adds or refreshes rows in the DataSet to match those in the data source.

Überlädt

Fill(DataSet) Fill(DataSet) Fill(DataSet)

Fügt dem DataSet Zeilen hinzu oder aktualisiert diese, um Übereinstimmung mit den Zeilen in der Datenquelle herzustellen. Adds or refreshes rows in the DataSet to match those in the data source.

Fill(DataTable, IDataReader) Fill(DataTable, IDataReader) Fill(DataTable, IDataReader)

Fügt der DataTable unter Verwendung des DataTable-Namens und des angegebenen IDataReader Zeilen hinzu bzw. aktualisiert diese, um Übereinstimmung mit den Zeilen in der Datenquelle herzustellen. Adds or refreshes rows in the DataTable to match those in the data source using the DataTable name and the specified IDataReader.

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

Aktualisiert Zeilen in einem angegebenen Bereich in der Auflistung der DataTable-Objekte oder fügt Zeilen hinzu, um Übereinstimmung mit den Zeilen in der Datenquelle herzustellen. Adds or refreshes rows in a specified range in the collection of DataTable objects to match those in the data source.

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

Aktualisiert Zeilen in einem angegebenen Bereich des DataSet oder fügt Zeilen hinzu, um Übereinstimmung mit den Zeilen in der Datenquelle herzustellen, die den Namen des DataSet und den Namen der DataTable verwenden. Adds or refreshes rows in a specified range in the DataSet to match those in the data source using the DataSet and DataTable names.

Fill(DataSet) Fill(DataSet) Fill(DataSet)

Fügt dem DataSet Zeilen hinzu oder aktualisiert diese, um Übereinstimmung mit den Zeilen in der Datenquelle herzustellen. Adds or refreshes rows in the DataSet to match those in the data source.

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

Parameter

dataSet
DataSet DataSet DataSet DataSet

Ein DataSet, das mit Datensätzen und bei Bedarf mit einem Schema gefüllt wird. A DataSet to fill with records and, if necessary, schema.

Gibt zurück

Die Anzahl der Zeilen, die dem DataSet erfolgreich hinzufügt bzw. darin aktualisiert wurden. The number of rows successfully added to or refreshed in the DataSet. Dies schließt keine Zeilen ein, die von Anweisungen betroffen sind, die keine Zeilen zurückgeben. This does not include rows affected by statements that do not return rows.

Implementiert

Hinweise

Die Fill Methode ruft Zeilen ab, aus der Datenquelle, die mithilfe der SELECT-Anweisung angegeben, die von einem zugeordneten SelectCommand Eigenschaft.The Fill method retrieves rows from the data source using the SELECT statement specified by an associated SelectCommand property. Das Verbindungsobjekt, das mit der SELECT-Anweisung verknüpft ist, muss gültig sein, aber es muss nicht geöffnet werden.The connection object associated with the SELECT statement must be valid, but it does not need to be open. Wenn die Verbindung geschlossen wird, bevor Sie Fill wird aufgerufen, es wird geöffnet, um Daten abzurufen und anschließend geschlossen.If the connection is closed before Fill is called, it is opened to retrieve data, then closed. Wenn die Verbindung vor dem Öffnen wird Fill ist aufgerufen wird, bleibt es geöffnet.If the connection is open before Fill is called, it remains open.

Die Fill Vorgang dann fügt die Zeilen, in Ziel DataTable Objekte in der DataSet, wodurch die DataTable Objekte an, wenn sie nicht bereits vorhanden sind.The Fill operation then adds the rows to destination DataTable objects in the DataSet, creating the DataTable objects if they do not already exist. Beim Erstellen von DataTable Objekte, die Fill -Vorgang wird normalerweise nur Spaltennamen-Metadaten erstellt.When creating DataTable objects, the Fill operation normally creates only column name metadata. Aber wenn die MissingSchemaAction -Eigenschaftensatz auf AddWithKey, entsprechenden primären Schlüsseln und Einschränkungen werden auch erstellt.However, if the MissingSchemaAction property is set to AddWithKey, appropriate primary keys and constraints are also created.

Wenn vom SelectCommand die Ergebnisse eines OUTER JOIN zurückgegeben werden, wird vom DataAdapter kein PrimaryKey -Wert für die resultierende DataTablefestgelegt.If the SelectCommand returns the results of an OUTER JOIN, the DataAdapter does not set a PrimaryKey value for the resulting DataTable. Sie müssen explizit definieren, dass den Primärschlüssel, um sicherzustellen, dass doppelte Zeilen ordnungsgemäß aufgelöst werden.You must explicitly define the primary key to ensure that duplicate rows are resolved correctly. Weitere Informationen finden Sie unter Definieren von Primärschlüsseln.For more information, see Defining Primary Keys.

Wenn der Datenadapter doppelte Spalten beim Auffüllen des findet eine DataTable, generiert er Namen für die nachfolgenden Spalten, die mit dem Muster "columnname1", "columnname2", "Spaltenname3" und So weiter.If the data adapter encounters duplicate columns while populating a DataTable, it generates names for the subsequent columns, using the pattern "columnname1", "columnname2", "columnname3", and so on. Wenn die eingehenden Daten unbenannte Spalten enthalten, werden sie platziert, der DataSet gemäß dem Muster "Column1", "Column2" usw.If the incoming data contains unnamed columns, they are placed in the DataSet according to the pattern "Column1", "Column2", and so on. Wenn mehrere Resultsets hinzugefügt werden, um die DataSet jedes Resultset in einer separaten Tabelle platziert wird.When multiple result sets are added to the DataSet each result set is placed in a separate table. Zusätzliche Resultsets werden mit dem Namen durch Anhängen von ganzzahligen Werten auf dem angegebenen Tabellennamen (beispielsweise "Table", "Table1", "Table2" und So weiter).Additional result sets are named by appending integral values to the specified table name (for example, "Table", "Table1", "Table2", and so on). Anwendungen mithilfe von Spalten- und Tabellennamen sorgen dafür, dass verursacht einen Konflikt mit dem folgenden Benennungsmuster erfolgt nicht.Applications using column and table names should ensure that conflicts with these naming patterns does not occur.

Wenn die SELECT-Anweisung zum Füllen der DataSet mehrere Ergebnisse zurückgibt, z. B. eine SQL-Anweisungen, wenn ein Ergebnis einen Fehler enthält alle nachfolgenden Ergebnisse werden übersprungen, und nicht hinzugefügt, die DataSet.When the SELECT statement used to populate the DataSet returns multiple results, such as a batch SQL statements, if one of the results contains an error, all subsequent results are skipped and not added to the DataSet.

Sie können die Fill -Methode mehrere Male auf der gleichen DataTable.You can use the Fill method multiple times on the same DataTable. Wenn ein Primärschlüssel vorhanden ist, werden die eingehende Zeilen mit übereinstimmenden Zeilen zusammengeführt, die bereits vorhanden.If a primary key exists, incoming rows are merged with matching rows that already exist. Wenn kein Primärschlüssel vorhanden ist, werden eingehende Zeilen an angehängt der DataTable.If no primary key exists, incoming rows are appended to the DataTable.

Hinweis

Bei der Behandlung von SQL-Anweisungen, die mehrere Ergebnisse, die Implementierung von zurückgeben FillSchema für die .NET Framework-Datenanbieter für OLE DB Schemainformationen für nur das erste Ergebnis ab.When handling batch SQL statements that return multiple results, the implementation of FillSchema for the .NET Framework Data Provider for OLE DB retrieves schema information for only the first result. Verwenden Sie zum Abrufen von Schemainformationen für mehrere Ergebnisse Fill mit der MissingSchemaAction festgelegt AddWithKey.To retrieve schema information for multiple results, use Fill with the MissingSchemaAction set to AddWithKey.

Siehe auch

Fill(DataTable, IDataReader) Fill(DataTable, IDataReader) Fill(DataTable, IDataReader)

Fügt der DataTable unter Verwendung des DataTable-Namens und des angegebenen IDataReader Zeilen hinzu bzw. aktualisiert diese, um Übereinstimmung mit den Zeilen in der Datenquelle herzustellen. Adds or refreshes rows in the DataTable to match those in the data source using the DataTable name and the specified 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

Parameter

dataTable
DataTable DataTable DataTable DataTable

Eine DataTable, die mit Datensätzen aufgefüllt werden soll. A DataTable to fill with records.

dataReader
IDataReader IDataReader IDataReader IDataReader

Eine Instanz von IDataReader. An instance of IDataReader.

Gibt zurück

Die Anzahl der Zeilen, die dem DataTable erfolgreich hinzufügt bzw. darin aktualisiert wurden. The number of rows successfully added to or refreshed in the DataTable. Dies schließt keine Zeilen ein, die von Anweisungen betroffen sind, die keine Zeilen zurückgeben. This does not include rows affected by statements that do not return rows.

Hinweise

Finden Sie unter den Hinweisen zu System.Data.Common.DataAdapter.Fill(System.Data.DataSet) für zusätzliche Informationen.See the remarks for System.Data.Common.DataAdapter.Fill(System.Data.DataSet) for additional information.

Siehe auch

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

Aktualisiert Zeilen in einem angegebenen Bereich in der Auflistung der DataTable-Objekte oder fügt Zeilen hinzu, um Übereinstimmung mit den Zeilen in der Datenquelle herzustellen. Adds or refreshes rows in a specified range in the collection of DataTable objects to match those in the data source.

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 Datensätzen aufgefüllt werden soll A collection of DataTable objects to fill with records.

dataReader
IDataReader IDataReader IDataReader IDataReader

Eine Instanz von IDataReader. An instance of IDataReader.

startRecord
Int32 Int32 Int32 Int32

Der nullbasierte Startindex für die Startdatensatz. The zero-based index of the starting record.

maxRecords
Int32 Int32 Int32 Int32

Eine ganze Zahl, die die maximale Anzahl von Datensätzen angibt. An integer indicating the maximum number of records.

Gibt zurück

Die Anzahl der Zeilen, die dem DataTable erfolgreich hinzufügt bzw. darin aktualisiert wurden. The number of rows successfully added to or refreshed in the DataTable. Dies schließt keine Zeilen ein, die von Anweisungen betroffen sind, die keine Zeilen zurückgeben. This does not include rows affected by statements that do not return rows.

Hinweise

Finden Sie unter den Hinweisen zu System.Data.Common.DataAdapter.Fill(System.Data.DataSet) für zusätzliche Informationen.See the remarks for System.Data.Common.DataAdapter.Fill(System.Data.DataSet) for additional information.

Siehe auch

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

Aktualisiert Zeilen in einem angegebenen Bereich des DataSet oder fügt Zeilen hinzu, um Übereinstimmung mit den Zeilen in der Datenquelle herzustellen, die den Namen des DataSet und den Namen der DataTable verwenden. Adds or refreshes rows in a specified range in the DataSet to match those in the data source using the DataSet and DataTable names.

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

Parameter

dataSet
DataSet DataSet DataSet DataSet

Eine DataSet, die mit Datensätzen aufgefüllt werden soll. A DataSet to fill with records.

srcTable
String String String String

Eine Zeichenfolge, die den Namen der Quelltabelle angibt. A string indicating the name of the source table.

dataReader
IDataReader IDataReader IDataReader IDataReader

Eine Instanz von IDataReader. An instance of IDataReader.

startRecord
Int32 Int32 Int32 Int32

Der nullbasierte Startindex für die Startdatensatz. The zero-based index of the starting record.

maxRecords
Int32 Int32 Int32 Int32

Eine ganze Zahl, die die maximale Anzahl von Datensätzen angibt. An integer indicating the maximum number of records.

Gibt zurück

Die Anzahl der Zeilen, die dem DataSet erfolgreich hinzufügt bzw. darin aktualisiert wurden. The number of rows successfully added to or refreshed in the DataSet. Dies schließt keine Zeilen ein, die von Anweisungen betroffen sind, die keine Zeilen zurückgeben. This does not include rows affected by statements that do not return rows.

Hinweise

Finden Sie unter den Hinweisen zu System.Data.Common.DataAdapter.Fill(System.Data.DataSet) für zusätzliche Informationen.See the remarks for System.Data.Common.DataAdapter.Fill(System.Data.DataSet) for additional information.

Siehe auch

Gilt für: