DbDataAdapter.Fill Methode

Quelle:

DbDataAdapter.cs

Quelle:

DbDataAdapter.cs

Quelle:

DbDataAdapter.cs

protected:
 virtual int Fill(System::Data::DataSet ^ dataSet, int startRecord, int maxRecords, System::String ^ srcTable, System::Data::IDbCommand ^ command, System::Data::CommandBehavior behavior);

protected virtual int Fill (System.Data.DataSet dataSet, int startRecord, int maxRecords, string srcTable, System.Data.IDbCommand command, System.Data.CommandBehavior behavior);

override this.Fill : System.Data.DataSet * int * int * string * System.Data.IDbCommand * System.Data.CommandBehavior -> int

Protected Overridable Function Fill (dataSet As DataSet, startRecord As Integer, maxRecords As Integer, srcTable As String, command As IDbCommand, behavior As CommandBehavior) As Integer

Parameter

Gibt zurück

Die Anzahl der Zeilen, die dem DataSet erfolgreich hinzufügt bzw. darin aktualisiert wurden. Dies schließt keine Zeilen ein, die von Anweisungen betroffen sind, die keine Zeilen zurückgeben.

Ausnahmen

Hinweise

Der maxRecords Wert 0 ruft alle Datensätze ab, die nach dem Startdatensatz gefunden wurden. Wenn maxRecords größer als die Anzahl der verbleibenden Zeilen ist, werden nur die verbleibenden Zeilen zurückgegeben, und es wird kein Fehler ausgegeben.

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

Der Fill Vorgang fügt dann die Zeilen den Zielobjekten DataTable in hinzu DataSet, und erstellt die DataTable Objekte, wenn sie noch nicht vorhanden sind. Beim Erstellen von DataTable Objekten erstellt der Fill Vorgang normalerweise nur Metadaten für Spaltennamen. Wenn die MissingSchemaAction -Eigenschaft jedoch auf AddWithKeyfestgelegt ist, werden auch entsprechende Primärschlüssel und Einschränkungen erstellt.

Wenn doppelte DbDataAdapter Spalten beim Auffüllen eines DataTableauftreten, generiert es Namen für die nachfolgenden Spalten, wobei das Muster "Spaltenname1", "Spaltenname2", "Spaltenname3" usw. verwendet wird. Wenn die eingehenden Daten unbenannte Spalten enthalten, werden sie platziert, der DataSet gemäß dem Muster "Column1", "Column2" usw. Wenn mehrere Resultsets hinzugefügt werden, wird jedes DataSet Resultset in einer separaten Tabelle platziert. Zusätzliche Resultsets werden benannt, indem integrale Werte an den angegebenen Tabellennamen angefügt werden (z. B. "Table", "Table1", "Table2" usw.). Wenn Ihre App Spalten- und Tabellennamen verwendet, stellen Sie sicher, dass keine Konflikte mit diesen Benennungsmustern auftreten.

Die Fill -Methode unterstützt Szenarien, in denen mehrere DataSetDataTable Objekte enthält, deren Namen sich nur nach Groß-/Kleinschreibung unterscheiden. Führt in solchen Situationen einen Vergleich zwischen Groß- und Kleinschreibung aus, Fill um die entsprechende Tabelle zu finden, und erstellt eine neue Tabelle, wenn keine genaue Übereinstimmung vorhanden ist. Der folgende C#-Code veranschaulicht dieses Verhalten.

DataSet dataset = new DataSet();  
dataset.Tables.Add("aaa");  
dataset.Tables.Add("AAA");  
adapter.Fill(dataset, "aaa"); // Fills "aaa", which already exists in the DataSet.  
adapter.Fill(dataset, "Aaa"); // Adds a new table called "Aaa".  

Wenn Fill aufgerufen wird und nur DataSet einen DataTable enthält, dessen Name sich nur nach Groß- und Kleinschreibung unterscheidet, wird dieser DataTable aktualisiert. In diesem Szenario wird beim Vergleich die Groß-/Kleinschreibung nicht beachtet. Der folgende C#-Code veranschaulicht dieses Verhalten.

DataSet dataset = new DataSet();  
dataset.Tables.Add("aaa");  
adapter.Fill(dataset, "AAA"); // Fills table "aaa" because only one similarly named table is in the DataSet.  

Sie können die Fill -Methode mehrmals für dieselbe 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 DataTableangefügt.

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 Löschen von Primärschlüsseln.

Hinweise für Vererber

Diese Überladung der Fill(DataSet) -Methode ist geschützt und für die Verwendung durch einen .NET Framework-Datenanbieter konzipiert.

Weitere Informationen

• DbProviderFactories (ADO.NET)
• Übersicht über ADO.NET

Quelle:

DbDataAdapter.cs

Quelle:

DbDataAdapter.cs

Quelle:

DbDataAdapter.cs

protected:
 virtual int Fill(cli::array <System::Data::DataTable ^> ^ dataTables, int startRecord, int maxRecords, System::Data::IDbCommand ^ command, System::Data::CommandBehavior behavior);

protected virtual int Fill (System.Data.DataTable[] dataTables, int startRecord, int maxRecords, System.Data.IDbCommand command, System.Data.CommandBehavior behavior);

override this.Fill : System.Data.DataTable[] * int * int * System.Data.IDbCommand * System.Data.CommandBehavior -> int

Protected Overridable Function Fill (dataTables As DataTable(), startRecord As Integer, maxRecords As Integer, command As IDbCommand, behavior As CommandBehavior) As Integer

Parameter

Gibt zurück

Die Anzahl der Zeilen, die in den Datentabellen hinzugefügt bzw. darin aktualisiert wurden.

Ausnahmen

Hinweise

Der maxRecords Wert 0 ruft alle Datensätze ab, die nach dem Startdatensatz gefunden wurden. Wenn maxRecords größer als die Anzahl der verbleibenden Zeilen ist, werden nur die verbleibenden Zeilen zurückgegeben, und es wird kein Fehler ausgegeben.

Die Fill -Methode ruft die Daten mithilfe einer SELECT-Anweisung aus der Datenquelle ab. Das IDbConnection der SELECT-Anweisung zugeordnete Objekt muss gültig sein, muss aber nicht geöffnet sein. Wenn geschlossen IDbConnection wird, bevor Fill aufgerufen wird, wird es geöffnet, um Daten abzurufen, und dann geschlossen. Wenn die Verbindung geöffnet ist, bevor Fill aufgerufen wird, bleibt sie geöffnet.

Wenn ein Befehl keine Zeilen zurückgibt, werden der keine Tabellen hinzugefügt DataSet, aber es wird keine Ausnahme ausgelöst.

Wenn das DbDataAdapter Objekt beim Auffüllen eines DataTableauf doppelte Spalten stößt, generiert es Namen für die nachfolgenden Spalten, wobei das Muster "Spaltenname1", "Spaltenname2", "Spaltenname3" usw. verwendet wird. Wenn die eingehenden Daten unbenannte Spalten enthalten, werden sie platziert, der DataSet gemäß dem Muster "Column1", "Column2" usw.

Wenn die angegebene Abfrage mehrere Ergebnisse zurückgibt, wird jedes Resultset in einer separaten Tabelle platziert. Zusätzliche Resultsets werden benannt, indem integrale Werte an den angegebenen Tabellennamen angefügt werden (z. B. "Table", "Table1", "Table2" usw.). Da für eine Abfrage, die keine Zeilen zurückgibt, keine Tabelle erstellt wird, würde die für die Auswahlabfrage erstellte Tabelle "Tabelle" heißen, wenn Sie eine Einfügeabfrage gefolgt von einer Auswahlabfrage verarbeiten würden, da es sich um die erste erstellte Tabelle handelt. Wenn Ihre App Spalten- und Tabellennamen verwendet, stellen Sie sicher, dass keine Konflikte mit diesen Benennungsmustern auftreten.

Die Fill -Methode unterstützt Szenarien, in denen mehrere DataSetDataTable Objekte enthält, deren Namen sich nur nach Groß-/Kleinschreibung unterscheiden. Führt in solchen Situationen einen Vergleich zwischen Groß- und Kleinschreibung aus, Fill um die entsprechende Tabelle zu finden, und erstellt eine neue Tabelle, wenn keine genaue Übereinstimmung vorhanden ist. Der folgende C#-Code veranschaulicht dieses Verhalten.

DataSet dataset = new DataSet();  
dataset.Tables.Add("aaa");  
dataset.Tables.Add("AAA");  
adapter.Fill(dataset, "aaa"); // Fills "aaa", which already exists in the DataSet.  
adapter.Fill(dataset, "Aaa"); // Adds a new table called "Aaa".  

Wenn Fill aufgerufen wird und nur DataSet einen DataTable enthält, dessen Name sich nur nach Groß- und Kleinschreibung unterscheidet, wird dieser DataTable aktualisiert. In diesem Szenario wird beim Vergleich die Groß-/Kleinschreibung nicht beachtet. Der folgende C#-Code veranschaulicht dieses Verhalten.

DataSet dataset = new DataSet();  
dataset.Tables.Add("aaa");  
adapter.Fill(dataset, "AAA"); // Fills table "aaa" because only one similarly named table is in the DataSet.  

Wenn beim Auffüllen der Datentabellen ein Fehler oder eine Ausnahme auftritt, verbleiben zeilen, die vor dem Auftreten des Fehlers hinzugefügt wurden, in den Datentabellen. Der Rest des Vorgangs wird abgebrochen.

Wenn die SELECT-Anweisung, die zum Auffüllen der DataTable Objekte verwendet wird, mehrere Ergebnisse zurückgibt, z. B. eine Batch-SQL-Anweisung, beachten Sie Folgendes:

• Beim Verarbeiten mehrerer Ergebnisse aus einer BATCH-SQL-Anweisung maxRecords gilt nur für das erste Ergebnis. Gleiches gilt für Zeilen, die kapitelweise Ergebnisse enthalten (.NET Framework Datenanbieter nur für OLE DB). Das Ergebnis der obersten Ebene wird durch maxRecordseingeschränkt, aber alle untergeordneten Zeilen werden hinzugefügt.

• Wenn eines der Ergebnisse einen Fehler enthält, werden alle nachfolgenden Ergebnisse übersprungen.

Hinweise für Vererber

Achten Sie beim Überschreiben Fill(DataSet) in einer abgeleiteten Klasse darauf, die -Methode der Basisklasse Fill(DataSet) aufzurufen.

Weitere Informationen

• DbProviderFactories (ADO.NET)
• Übersicht über ADO.NET

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

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

Gibt zurück

Die Anzahl der Zeilen, die dem DataSet erfolgreich hinzufügt bzw. darin aktualisiert wurden. Dies schließt keine Zeilen ein, die von Anweisungen betroffen sind, die keine Zeilen zurückgeben.

Ausnahmen

Hinweise

Der maxRecords Wert 0 ruft alle Datensätze ab, die nach dem Startdatensatz gefunden wurden. Wenn maxRecords die Anzahl der verbleibenden Zeilen größer ist, werden nur die verbleibenden Zeilen zurückgegeben, und es wird kein Fehler ausgegeben.

Quelle:

DbDataAdapter.cs

Quelle:

DbDataAdapter.cs

Quelle:

DbDataAdapter.cs

public:
 int Fill(System::Data::DataSet ^ dataSet, int startRecord, int maxRecords, System::String ^ srcTable);

public int Fill (System.Data.DataSet dataSet, int startRecord, int maxRecords, string srcTable);

override this.Fill : System.Data.DataSet * int * int * string -> int

Public Function Fill (dataSet As DataSet, startRecord As Integer, maxRecords As Integer, srcTable As String) As Integer

Parameter

Gibt zurück

Die Anzahl der Zeilen, die dem DataSet erfolgreich hinzufügt bzw. darin aktualisiert wurden. Dies schließt keine Zeilen ein, die von Anweisungen betroffen sind, die keine Zeilen zurückgeben.

Ausnahmen

Beispiele

Im folgenden Beispiel wird die abgeleitete Klasse verwendet, OleDbDataAdapterum eine DataSet mit 15 Zeilen zu füllen, die bei Zeile 10 beginnen, aus der Tabelle Categories . In diesem Beispiel wird davon ausgegangen, dass Sie ein OleDbDataAdapter und ein DataSeterstellt haben.

public void GetRecords()
{
    // ...
    // create dataSet and adapter
    // ...
    adapter.Fill(dataSet,9,15,"Categories");
}

Public Sub GetRecords()
    ' ...
    ' create dataSet and adapter
    ' ...
    adapter.Fill(dataSet, 9, 15, "Categories")
End Sub

Hinweise

Der maxRecords Wert 0 ruft alle Datensätze ab, die nach dem Startdatensatz gefunden wurden. Wenn maxRecords die Anzahl der verbleibenden Zeilen größer ist, werden nur die verbleibenden Zeilen zurückgegeben, und es wird kein Fehler ausgegeben.

Wenn der entsprechende Select-Befehl eine Anweisung ist, die mehrere Ergebnisse zurückgibt, Fill gilt nur für maxRecords das erste Ergebnis.

Die Fill -Methode ruft die Daten mithilfe einer SELECT-Anweisung aus der Datenquelle ab. Das IDbConnection der SELECT-Anweisung zugeordnete Objekt muss gültig sein, muss aber nicht geöffnet sein. Wenn geschlossen IDbConnection ist, bevor Fill aufgerufen wird, wird es geöffnet, um Daten abzurufen, und dann geschlossen. Wenn die Verbindung geöffnet ist, bevor Fill sie aufgerufen wird, bleibt sie geöffnet.

Wenn ein Befehl keine Zeilen zurückgibt, werden keine Tabellen hinzugefügt DataSet, aber es wird keine Ausnahme ausgelöst.

Wenn das DbDataAdapter Objekt beim Auffüllen eines DataTableauf doppelte Spalten stößt, generiert es Namen für die nachfolgenden Spalten, wobei das Muster "Spaltenname1", "Spaltenname2", "Spaltenname3" usw. verwendet wird. Wenn die eingehenden Daten unbenannte Spalten enthalten, werden sie platziert, der DataSet gemäß dem Muster "Column1", "Column2" usw.

Wenn die angegebene Abfrage mehrere Ergebnisse zurückgibt, wird jedes Resultset in einer separaten Tabelle platziert. Zusätzliche Resultsets werden benannt, indem integrale Werte an den angegebenen Tabellennamen angefügt werden (z. B. "Table", "Table1", "Table2" usw.). Da keine Tabelle für eine Abfrage erstellt wird, die keine Zeilen zurückgibt, wird die für die Select-Abfrage erstellte Tabelle "Table" genannt, da es sich um die erste erstellte Tabelle handelt. Wenn Ihre App Spalten- und Tabellennamen verwendet, stellen Sie sicher, dass keine Konflikte mit diesen Benennungsmustern auftreten.

Die Fill -Methode unterstützt Szenarien, in denen das DataSet mehrere DataTable Objekte enthält, deren Namen sich nur nach Groß- und Kleinschreibung unterscheiden. Führt in solchen Situationen einen Vergleich zwischen Groß- und Kleinschreibung durch, Fill um die entsprechende Tabelle zu finden, und erstellt eine neue Tabelle, wenn keine genaue Übereinstimmung vorhanden ist. Der folgende C#-Code veranschaulicht dieses Verhalten.

DataSet dataset = new DataSet();  
dataset.Tables.Add("aaa");  
dataset.Tables.Add("AAA");  
adapter.Fill(dataset, "aaa"); // Fills "aaa", which already exists in the DataSet.  
adapter.Fill(dataset, "Aaa"); // Adds a new table called "Aaa".  

Wenn Fill aufgerufen wird und nur einen DataTable enthält, dessen Name sich nur nach Groß- und DataSet Kleinschreibung unterscheidet, wird dies DataTable aktualisiert. In diesem Szenario wird beim Vergleich die Groß-/Kleinschreibung nicht beachtet. Der folgende C#-Code veranschaulicht dieses Verhalten.

DataSet dataset = new DataSet();  
dataset.Tables.Add("aaa");  
adapter.Fill(dataset, "AAA"); // Fills table "aaa" because only one similarly named table is in the DataSet.  

Wenn beim Auffüllen der Datentabellen ein Fehler oder eine Ausnahme auftritt, verbleiben zeilen, die vor dem Auftreten des Fehlers hinzugefügt wurden, in den Datentabellen. Der Rest des Vorgangs wird abgebrochen.

Wenn die SELECT-Anweisung, die zum Auffüllen verwendet DataSet wird, mehrere Ergebnisse zurückgibt, z. B. BATCH-SQL-Anweisungen, beachten Sie Folgendes:

• Beim Verarbeiten mehrerer Ergebnisse aus einer BATCH-SQL-Anweisung maxRecords gilt nur für das erste Ergebnis. Gleiches gilt für Zeilen, die kapitelweise Ergebnisse enthalten (.NET Framework Datenanbieter nur für OLE DB). Das Ergebnis der obersten Ebene ist durch maxRecordseingeschränkt, aber alle untergeordneten Zeilen werden hinzugefügt.

• Wenn eines der Ergebnisse einen Fehler enthält, werden alle nachfolgenden Ergebnisse übersprungen und nicht dem DataSethinzugefügt.

Wenn Sie nachfolgende Fill Aufrufe zum Aktualisieren des Inhalts verwenden DataSet, müssen zwei Bedingungen erfüllt sein:

1. Die SQL-Anweisung sollte mit der sql-Anweisung übereinstimmen, die ursprünglich zum Auffüllen von DataSetverwendet wurde.

2. Die Schlüsselspalteninformationen müssen vorhanden sein.

Wenn Primärschlüsselinformationen vorhanden sind, werden alle doppelten Zeilen abgeglichen und nur einmal in der angezeigt, die DataTable dem DataSetentspricht. Primärschlüsselinformationen können entweder über FillSchemafestgelegt werden, indem Sie die PrimaryKey -Eigenschaft von DataTableangeben oder die MissingSchemaAction -Eigenschaft auf AddWithKeyfestlegen.

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 Löschen von Primärschlüsseln.

Hinweise für Vererber

Rufen Sie beim Überschreiben Fill(DataSet) in einer abgeleiteten Klasse unbedingt die Methode der Basisklasse Fill(DataSet) auf.

Weitere Informationen

• DbProviderFactories (ADO.NET)
• Übersicht über ADO.NET

Quelle:

DbDataAdapter.cs

Quelle:

DbDataAdapter.cs

Quelle:

DbDataAdapter.cs

public:
 int Fill(int startRecord, int maxRecords, ... cli::array <System::Data::DataTable ^> ^ dataTables);

public int Fill (int startRecord, int maxRecords, params System.Data.DataTable[] dataTables);

override this.Fill : int * int * System.Data.DataTable[] -> int

Public Function Fill (startRecord As Integer, maxRecords As Integer, ParamArray dataTables As DataTable()) As Integer

Parameter

Gibt zurück

Die Anzahl der Zeilen, die DataTable den -Objekten erfolgreich hinzugefügt oder aktualisiert wurden. Dieser Wert schließt keine Zeilen ein, die von Anweisungen betroffen sind, die keine Zeilen zurückgeben.

Ausnahmen

Hinweise

Der maxRecords Wert 0 ruft alle Datensätze ab, die nach dem Startdatensatz gefunden wurden. Wenn maxRecords die Anzahl der verbleibenden Zeilen größer ist, werden nur die verbleibenden Zeilen zurückgegeben, und es wird kein Fehler ausgegeben.

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

Der Fill Vorgang fügt die Zeilen dann Zielobjekten DataTable in hinzu DataSet, und erstellt die DataTable Objekte, sofern sie noch nicht vorhanden sind. Beim Erstellen von DataTable Objekten erstellt der Fill Vorgang normalerweise nur Spaltennamenmetadaten. Wenn die MissingSchemaAction -Eigenschaft jedoch auf AddWithKeyfestgelegt ist, werden auch die entsprechenden 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 Löschen von Primärschlüsseln.

Wenn der Datenadapter beim Auffüllen eines DataTableauf doppelte Spalten stößt, generiert er Namen für die nachfolgenden Spalten unter Verwendung des Musters "columnname1", "columnname2", "columnname3" usw. Wenn die eingehenden Daten unbenannte Spalten enthalten, werden sie platziert, der DataSet gemäß dem Muster "Column1", "Column2" usw. Wenn mehrere Resultsets hinzugefügt DataSetwerden, wird jedes Resultset in einer separaten Tabelle platziert. Zusätzliche Resultsets werden benannt, indem integrale Werte an den angegebenen Tabellennamen angefügt werden (z. B. "Table", "Table1", "Table2" usw.). Wenn Ihre App Spalten- und Tabellennamen verwendet, stellen Sie sicher, dass keine Konflikte mit diesen Benennungsmustern auftreten.

Wenn die SELECT-Anweisung, die zum Auffüllen verwendet DataSet wird, mehrere Ergebnisse zurückgibt, z. B. eine BATCH-SQL-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 für dieselbe 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 den DataTableangefügt.

Weitere Informationen

• DbProviderFactories (ADO.NET)
• Übersicht über ADO.NET

Quelle:

DbDataAdapter.cs

Quelle:

DbDataAdapter.cs

Quelle:

DbDataAdapter.cs

public:
 int Fill(System::Data::DataTable ^ dataTable);

public int Fill (System.Data.DataTable dataTable);

override this.Fill : System.Data.DataTable -> int

Public Function Fill (dataTable As DataTable) As Integer

Parameter

Gibt zurück

Die Anzahl der Zeilen, die dem DataSet erfolgreich hinzufügt bzw. darin aktualisiert wurden. Dies schließt keine Zeilen ein, die von Anweisungen betroffen sind, die keine Zeilen zurückgeben.

Ausnahmen

Hinweise

Die Fill -Methode ruft Zeilen aus der Datenquelle mithilfe der SELECT-Anweisung ab, die durch eine zugeordnete SelectCommand Eigenschaft angegeben wird. Das der SELECT-Anweisung zugeordnete Verbindungsobjekt muss gültig sein, muss aber nicht geöffnet sein. Wenn die Verbindung geschlossen wird, bevor Fill sie aufgerufen 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 die Zeilen dann Zielobjekten DataTable in hinzu DataSet, und erstellt die DataTable Objekte, sofern sie noch nicht vorhanden sind. Beim Erstellen von DataTable Objekten erstellt der Fill Vorgang normalerweise nur Spaltennamenmetadaten. Wenn die MissingSchemaAction -Eigenschaft jedoch auf AddWithKeyfestgelegt ist, werden auch die entsprechenden Primärschlüssel und Einschränkungen erstellt.

Wenn doppelte DbDataAdapter Spalten beim Auffüllen eines DataTableauftreten, generiert es Namen für die nachfolgenden Spalten unter Verwendung des Musters "Spaltenname1", "Spaltenname2", "Spaltenname3" usw. Wenn die eingehenden Daten unbenannte Spalten enthalten, werden sie platziert, der DataSet gemäß dem Muster "Column1", "Column2" usw. Wenn mehrere Resultsets hinzugefügt werden, wird jedes DataSet Resultset in einer separaten Tabelle platziert.

Die Überladung von Fill , die als Parameter verwendet DataTable wird, erhält nur das erste Ergebnis. Verwenden Sie eine Überladung von, die Fill als Parameter verwendet wird DataSet , um mehrere Ergebnisse zu erhalten.

Die Fill -Methode unterstützt Szenarien, in denen das DataSet mehrere DataTable Objekte enthält, deren Namen sich nur nach Groß- und Kleinschreibung unterscheiden. Führt in solchen Situationen einen Vergleich zwischen Groß- und Kleinschreibung durch, Fill um die entsprechende Tabelle zu finden, und erstellt eine neue Tabelle, wenn keine genaue Übereinstimmung vorhanden ist. Der folgende C#-Code veranschaulicht dieses Verhalten.

DataSet dataset = new DataSet();  
 dataset.Tables.Add("aaa");  
 dataset.Tables.Add("AAA");  
 adapter.Fill(dataset, "aaa"); // Fills "aaa", which already exists in the DataSet.  
    adapter.Fill(dataset, "Aaa"); // Adds a new table called "Aaa".  

Wenn Fill aufgerufen wird und nur einen DataTable enthält, dessen Name sich nur nach Groß- und DataSet Kleinschreibung unterscheidet, wird dies DataTable aktualisiert. In diesem Szenario wird beim Vergleich die Groß-/Kleinschreibung nicht beachtet. Der folgende C#-Code veranschaulicht dieses Verhalten.

DataSet dataset = new DataSet();  
 dataset.Tables.Add("aaa");  
    adapter.Fill(dataset, "AAA"); // Fills table "aaa" because only one similarly named table is in the DataSet.  

Sie können die Fill -Methode mehrmals für dieselbe 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 den DataTableangefügt.

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 Löschen von Primärschlüsseln.

Hinweise für Vererber

Diese Überladung der Fill(DataSet) Methode ist geschützt und für die Verwendung durch einen .NET Framework Datenanbieter konzipiert.

Weitere Informationen

• DbProviderFactories (ADO.NET)
• Übersicht über ADO.NET

protected:
 virtual int Fill(System::Data::DataTable ^ dataTable, System::Data::IDataReader ^ dataReader);

protected virtual int Fill (System.Data.DataTable dataTable, System.Data.IDataReader dataReader);

override this.Fill : System.Data.DataTable * System.Data.IDataReader -> int

Protected Overridable Function Fill (dataTable As DataTable, dataReader As IDataReader) As Integer

Parameter

Gibt zurück

Die Anzahl der Zeilen, die dem DataTable erfolgreich hinzufügt bzw. darin aktualisiert wurden. Dies schließt keine Zeilen ein, die von Anweisungen betroffen sind, die keine Zeilen zurückgeben.

Quelle:

DbDataAdapter.cs

Quelle:

DbDataAdapter.cs

Quelle:

DbDataAdapter.cs

public:
 int Fill(System::Data::DataSet ^ dataSet, System::String ^ srcTable);

public int Fill (System.Data.DataSet dataSet, string srcTable);

override this.Fill : System.Data.DataSet * string -> int

Public Function Fill (dataSet As DataSet, srcTable As String) As Integer

Parameter

Gibt zurück

Die Anzahl der Zeilen, die dem DataSet erfolgreich hinzufügt bzw. darin aktualisiert wurden. Dies schließt keine Zeilen ein, die von Anweisungen betroffen sind, die keine Zeilen zurückgeben.

Ausnahmen

Beispiele

Im folgenden Beispiel wird die abgeleitete Klasse verwendet, OleDbDataAdapterum eine DataSet mit Zeilen aus der Tabelle kategorien zu füllen. In diesem Beispiel wird davon ausgegangen, dass Sie ein OleDbDataAdapter und ein DataSeterstellt haben.

public void GetRecords()
{
    // ...
    // create dataSet and adapter
    // ...
    adapter.Fill(dataSet, "Categories");
}

Public Sub GetRecords()
    ' ...
    ' create dataSet and adapter
    ' ...
    adapter.Fill(dataSet, "Categories")
End Sub

Hinweise

Die Fill -Methode ruft die Daten mithilfe einer SELECT-Anweisung aus der Datenquelle ab. Das IDbConnection dem Select-Befehl zugeordnete Objekt muss gültig sein, muss aber nicht geöffnet sein. Wenn geschlossen IDbConnection ist, bevor Fill aufgerufen wird, wird es geöffnet, um Daten abzurufen, und dann geschlossen. Wenn die Verbindung geöffnet ist, bevor Fill sie aufgerufen wird, bleibt sie geöffnet.

Wenn ein Befehl keine Zeilen zurückgibt, werden keine Tabellen hinzugefügt DataSet, und es wird keine Ausnahme ausgelöst.

Wenn die DbDataAdapter Objekt trifft doppelte Spalten beim Auffüllen einer DataTable, generiert er Namen für die nachfolgenden Spalten, die mit dem Muster "columnname1", "columnname2", "Spaltenname3" usw. Wenn die eingehenden Daten unbenannte Spalten enthalten, werden sie platziert, der DataSet gemäß dem Muster "Column1", "Column2" usw.

Wenn die angegebene Abfrage mehrere Ergebnisse zurückgibt, wird jedes Resultset in einer separaten Tabelle platziert. Zusätzliche Resultsets werden benannt, indem integrale Werte an den angegebenen Tabellennamen angefügt werden (z. B. "Table", "Table1", "Table2" usw.). Da keine Tabelle für eine Abfrage erstellt wird, die keine Zeilen zurückgibt, wird die für die Select-Abfrage erstellte Tabelle "Table" genannt, da es sich um die erste erstellte Tabelle handelt. Wenn Ihre App Spalten- und Tabellennamen verwendet, stellen Sie sicher, dass keine Konflikte mit diesen Benennungsmustern auftreten.

Die Fill -Methode unterstützt Szenarien, in denen das DataSet mehrere DataTable Objekte enthält, deren Namen sich nur nach Groß- und Kleinschreibung unterscheiden. Führt in solchen Situationen einen Vergleich zwischen Groß- und Kleinschreibung durch, Fill um die entsprechende Tabelle zu finden, und erstellt eine neue Tabelle, wenn keine genaue Übereinstimmung vorhanden ist. Der folgende C#-Code veranschaulicht dieses Verhalten.

DataSet dataset = new DataSet();  
dataset.Tables.Add("aaa");  
dataset.Tables.Add("AAA");  
adapter.Fill(dataset, "aaa"); // Fills "aaa", which already exists in the DataSet.  
adapter.Fill(dataset, "Aaa"); // Adds a new table called "Aaa".  

Wenn Fill aufgerufen wird und nur einen DataTable enthält, dessen Name sich nur nach Groß- und DataSet Kleinschreibung unterscheidet, wird dies DataTable aktualisiert. In diesem Szenario wird beim Vergleich die Groß-/Kleinschreibung nicht beachtet. Der folgende C#-Code veranschaulicht dieses Verhalten.

DataSet dataset = new DataSet();  
dataset.Tables.Add("aaa");  
adapter.Fill(dataset, "AAA"); // Fills table "aaa" because only one similarly named table is in the DataSet.  

Wenn beim Auffüllen der Datentabellen ein Fehler oder eine Ausnahme auftritt, verbleiben zeilen, die vor dem Auftreten des Fehlers hinzugefügt wurden, in den Datentabellen. Der Rest des Vorgangs wird abgebrochen.

Wenn die SELECT-Anweisung, die zum Auffüllen verwendet DataSet wird, mehrere Ergebnisse zurückgibt, z. B. eine batch-SQL-Anweisung, beachten Sie Folgendes:

• Wenn eines der Ergebnisse einen Fehler enthält, werden alle nachfolgenden Ergebnisse übersprungen und nicht dem DataSethinzugefügt.

Wenn Sie nachfolgende Fill Aufrufe zum Aktualisieren des Inhalts verwenden DataSet, müssen zwei Bedingungen erfüllt sein:

1. Die SQL-Anweisung sollte mit der sql-Anweisung übereinstimmen, die ursprünglich zum Auffüllen von DataSetverwendet wurde.

2. Die Schlüsselspalteninformationen müssen vorhanden sein. Wenn Primärschlüsselinformationen vorhanden sind, werden alle doppelten Zeilen abgeglichen und nur einmal in der angezeigt, die DataTable dem DataSetentspricht. Primärschlüsselinformationen können entweder über FillSchemafestgelegt werden, indem Sie die PrimaryKey -Eigenschaft von DataTableangeben oder die MissingSchemaAction -Eigenschaft auf AddWithKeyfestlegen.

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 Löschen von Primärschlüsseln.

Hinweise für Vererber

Rufen Sie beim Überschreiben Fill(DataSet) in einer abgeleiteten Klasse unbedingt die Methode der Basisklasse Fill(DataSet) auf.

Weitere Informationen

• DbProviderFactories (ADO.NET)
• Übersicht über ADO.NET

Quelle:

DbDataAdapter.cs

Quelle:

DbDataAdapter.cs

Quelle:

DbDataAdapter.cs

public:
 override int Fill(System::Data::DataSet ^ dataSet);

public override int Fill (System.Data.DataSet dataSet);

override this.Fill : System.Data.DataSet -> int

Public Overrides Function Fill (dataSet As DataSet) As Integer

Parameter

Gibt zurück

Die Anzahl der Zeilen, die dem DataSet erfolgreich hinzufügt bzw. darin aktualisiert wurden. Dies schließt keine Zeilen ein, die von Anweisungen betroffen sind, die keine Zeilen zurückgeben.

Implementiert

Hinweise

Die Fill -Methode ruft die Daten mithilfe einer SELECT-Anweisung aus der Datenquelle ab. Das IDbConnection dem Select-Befehl zugeordnete Objekt muss gültig sein, muss aber nicht geöffnet sein. Wenn geschlossen IDbConnection wird, bevor Fill aufgerufen wird, wird es geöffnet, um Daten abzurufen, und dann geschlossen. Wenn die Verbindung geöffnet ist, bevor Fill aufgerufen wird, bleibt sie geöffnet.

Wenn beim Auffüllen der Datentabellen ein Fehler oder eine Ausnahme auftritt, verbleiben zeilen, die vor dem Auftreten des Fehlers hinzugefügt wurden, in den Datentabellen. Der Rest des Vorgangs wird abgebrochen.

Wenn ein Befehl keine Zeilen zurückgibt, werden dem keine Tabellen hinzugefügt DataSet, und es wird keine Ausnahme ausgelöst.

Wenn das DbDataAdapter Objekt beim Auffüllen eines DataTableauf doppelte Spalten stößt, generiert es Namen für die nachfolgenden Spalten mit dem Muster "Spaltenname1", "Spaltenname2", "Spaltenname3" usw. Wenn die eingehenden Daten unbenannte Spalten enthalten, werden sie platziert, der DataSet gemäß dem Muster "Column1", "Column2" usw.

Wenn die angegebene Abfrage mehrere Ergebnisse zurückgibt, wird das Resultset für jede Zeilenrückgabeabfrage in einer separaten Tabelle platziert. Zusätzliche Resultsets werden benannt, indem integrale Werte an den angegebenen Tabellennamen angefügt werden (z. B. "Table", "Table1", "Table2" usw.). Da für eine Abfrage, die keine Zeilen zurückgibt, keine Tabelle erstellt wird, wird beim Verarbeiten einer Einfügeabfrage gefolgt von einer Auswahlabfrage die für die Auswahlabfrage erstellte Tabelle als "Tabelle" bezeichnet, da es sich um die erste erstellte Tabelle handelt. Wenn Ihre App Spalten- und Tabellennamen verwendet, stellen Sie sicher, dass keine Konflikte mit diesen Benennungsmustern auftreten.

Wenn die SELECT-Anweisung, die zum Auffüllen verwendet DataSet wird, mehrere Ergebnisse zurückgibt, z. B. Sql-Batchanweisungen, und wenn eines der Ergebnisse einen Fehler enthält, werden alle nachfolgenden Ergebnisse übersprungen und nicht hinzugefügt DataSet.

Wenn Sie nachfolgende Fill Aufrufe verwenden, um den Inhalt von DataSetzu aktualisieren, müssen zwei Bedingungen erfüllt sein:

1. Die SQL-Anweisung sollte mit der sql-Anweisung übereinstimmen, die ursprünglich zum Auffüllen von DataSetverwendet wurde.

2. Die Schlüsselspalteninformationen müssen vorhanden sein.

Wenn Primärschlüsselinformationen vorhanden sind, werden alle doppelten Zeilen abgeglichen und nur einmal in der angezeigt, die DataTable dem DataSetentspricht. Primärschlüsselinformationen können entweder über FillSchemafestgelegt werden, indem die PrimaryKey -Eigenschaft von DataTableangegeben wird, oder durch Festlegen der MissingSchemaAction -Eigenschaft auf AddWithKey.

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 Löschen von Primärschlüsseln.

Weitere Informationen

• DbProviderFactories (ADO.NET)
• Übersicht über ADO.NET

Quelle:

DbDataAdapter.cs

Quelle:

DbDataAdapter.cs

Quelle:

DbDataAdapter.cs

protected:
 virtual int Fill(System::Data::DataTable ^ dataTable, System::Data::IDbCommand ^ command, System::Data::CommandBehavior behavior);

protected virtual int Fill (System.Data.DataTable dataTable, System.Data.IDbCommand command, System.Data.CommandBehavior behavior);

override this.Fill : System.Data.DataTable * System.Data.IDbCommand * System.Data.CommandBehavior -> int

Protected Overridable Function Fill (dataTable As DataTable, command As IDbCommand, behavior As CommandBehavior) As Integer

Parameter

Gibt zurück

Die Anzahl der Zeilen, die dem DataTable erfolgreich hinzufügt bzw. darin aktualisiert wurden. Dies schließt keine Zeilen ein, die von Anweisungen betroffen sind, die keine Zeilen zurückgeben.

Hinweise

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

Der Fill Vorgang fügt dann die Zeilen dem angegebenen Zielobjekt DataTable im DataSethinzu, und erstellt das DataTable -Objekt, sofern es noch nicht vorhanden ist. Beim Erstellen eines DataTable Objekts erstellt der Fill Vorgang normalerweise nur Metadaten für Spaltennamen. Wenn die MissingSchemaAction -Eigenschaft jedoch auf AddWithKeyfestgelegt ist, werden auch entsprechende Primärschlüssel und Einschränkungen erstellt.

Wenn das DbDataAdapter Objekt beim Auffüllen eines DataTableauf doppelte Spalten stößt, generiert es Namen für die nachfolgenden Spalten, wobei das Muster "Spaltenname1", "Spaltenname2", "Spaltenname3" usw. verwendet wird. Wenn die eingehenden Daten unbenannte Spalten enthalten, werden sie platziert, der DataSet gemäß dem Muster "Column1", "Column2" usw.

Die Überladung von, Fill die als Parameter akzeptiert DataTable , erhält nur das erste Ergebnis. Verwenden Sie eine Überladung von, Fill die als Parameter akzeptiert DataSet , um mehrere Ergebnisse zu erhalten.

Sie können die Fill -Methode mehrmals für dieselbe 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 DataTableangefügt.

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 Löschen von Primärschlüsseln.

Hinweise für Vererber

Diese Überladung der Fill(DataSet) -Methode ist geschützt und für die Verwendung durch einen .NET Framework-Datenanbieter konzipiert.

Weitere Informationen

• DbProviderFactories (ADO.NET)
• Übersicht über ADO.NET