Gewusst wie: Füllen eines Datasets mit Daten

Artikel
08/10/2011

Das Füllen eines Datasets mit Daten bezieht sich darauf, dass Daten in die einzelnen DataTable-Objekte geladen werden, aus denen das Dataset besteht. Datentabellen werden gefüllt, indem TableAdapter-Abfragen oder Befehle von Datenadaptern (z. B. SqlDataAdapter) ausgeführt werden.

Ob TableAdapters oder Datenadapter verwendet werden, hängt davon ab, wie Sie das Dataset erstellt haben. Wenn Sie die Entwurfstools in Visual Studio verwenden, z. B. den Assistent zum Konfigurieren von Datenquellen, enthält das Dataset TableAdapters. Weitere Informationen zu TableAdapters finden Sie unter Übersicht über TableAdapters. Wenn Sie ein Dataset programmgesteuert erstellt haben, müssen Sie in der Regel Datenadapter erstellen, um Daten in die Datentabellen laden zu können.

Tipp

Wenn Sie Elemente aus dem Datenquellenfenster auf ein Formular ziehen, wird dem Form_Load-Ereignishandler automatisch der Code hinzugefügt, der die Datentabelle mit Daten füllt. Öffnen Sie das Formular im Code-Editor, um die genaue Syntax für das Füllen der einzelnen Tabellen anzuzeigen. Wenn die Tabelle beim Laden des Formulars nicht gefüllt werden soll, können Sie diesen Code in eine andere Methode verschieben oder komplett löschen.

Füllen eines Datasets mithilfe eines TableAdapter

Sie können eine TableAdapter-Abfrage aufrufen, um Daten in Datentabellen eines Datasets zu laden. Übergeben Sie die zu füllende DataTable an die TableAdapter-Abfrage. Wenn die Abfrage Parameter annimmt, übergeben Sie diese ebenfalls an die Methode. Wenn das Dataset mehrere Tabellen enthält, sollten Sie separate TableAdapter für die einzelnen Tabellen besitzen, die separat gefüllt werden müssen.

Tipp

Immer, wenn Sie eine TableAdapter-Abfrage ausführen, werden die Daten in der Tabelle standardmäßig gelöscht, bevor die Ergebnisse der Abfrage in die Tabelle geladen werden. Um die bestehenden Tabellendaten beizubehalten und die Ergebnisse anzuhängen, legen Sie für die ClearBeforeFill-Eigenschaft des TableAdapter false fest.

So füllen Sie ein Dataset mithilfe eines TableAdapter mit Daten

Öffnen Sie das Formular oder die Komponente im Code-Editor.
Fügen Sie in der Anwendung Code ein, wo Daten in eine Datentabelle geladen werden müssen. Wenn in der Abfrage keine Parameter verwendet werden, übergeben Sie die DataTable, die gefüllt werden soll. Der Code sollte ungefähr wie folgt aussehen:
```
Me.CustomersTableAdapter.Fill(Me.NorthwindDataSet.Customers)
```
```
this.customersTableAdapter.Fill(this.northwindDataSet.Customers);
```

Wenn die Abfrage Parameter verwendet, übergeben Sie die DataTable, die gefüllt werden soll, sowie die Parameter, die von der Abfrage erwartet werden. Je nach den tatsächlich in der Abfrage verwendeten Parametern, würde der Code wie in den folgenden Beispielen aussehen:

CustomersTableAdapter.FillByCity(NorthwindDataSet.Customers, "Seattle")
CustomersTableAdapter.FillByCityAndState(NorthwindDataSet.Customers, "Seattle", "WA")

customersTableAdapter.FillByCity(northwindDataSet.Customers, "Seattle");
customersTableAdapter.FillByCityAndState(northwindDataSet.Customers, "Seattle", "WA");

Füllen eines Datasets mithilfe eines DataAdapter

Rufen Sie die Fill-Methode des Datenadapters auf. Dies führt dazu, dass der Adapter die SQL-Anweisung oder die gespeicherte Prozedur ausführt, auf die in seiner SelectCommand-Eigenschaft verwiesen wird. Die Ergebnisse werden in eine Tabelle im Dataset übertragen. Wenn das Dataset mehrere Tabellen enthält, sollten Sie separate Datenadapter für die einzelnen Tabellen besitzen, die alle separat gefüllt werden müssen.

So füllen Sie ein Dataset mithilfe eines DataAdapters mit Daten

Rufen Sie die Fill-Methode von DataAdapter auf, um DataSet oder DataTable zu übergeben, in die Daten geladen werden. Beispiel:
```
sqlDataAdapter1.Fill(dataset1.Tables("Customers"))
```
```
sqlDataAdapter1.Fill(dataset1.Tables["Customers"]);
```
Sie sollten i. d. R. den Namen von DataTable angeben, wenn Sie dorthin Daten laden möchten. Wenn Sie statt einer bestimmten Datentabelle den Namen eines DataSet übergeben, wird dem Dataset die DataTable Table1 hinzugefügt und mit den Ergebnissen aus der Datenbank geladen. (Die Alternative wäre, Daten in eine vorhandene DataTable im Dataset zu laden.) Weitere Informationen finden Sie unter Auffüllen eines 'DataSet' durch einen 'DataAdapter' (ADO.NET).