Gewusst wie: Ausführen von TableAdapter-Abfragen

Artikel
09/11/2015

TableAdapter-Abfragen sind SQL-Anweisungen oder gespeicherte Prozeduren, die für eine Datenbank ausgeführt werden können und die im TableAdapter als typisierte Methoden zur Verfügung gestellt werden. Sie können TableAdapter-Abfragen ausführen, indem Sie die entsprechenden Methoden aufrufen – ganz auf dieselbe Weise, wie auch sonst das Aufrufen von Methoden für Objekte funktioniert.

TableAdapter-Abfragen können Datentabellen füllen (Fill-Abfrage und FillBy-Abfrage) oder neue Datentabellen zurückgeben, die mit den Daten aufgefüllt sind, die von der Abfrage (GetData-Abfrage und GetDataBy-Abfrage) zurückgegeben werden.

Sie können vorhandenen TableAdapters Abfragen hinzufügen, indem Sie den TableAdapter-Abfragekonfigurations-Assistent ausführen.

Erstellen einer Instanz des TableAdapter

Sie müssen eine Instanz des TableAdapter erstellen, bevor Sie eine der Methoden des TableAdapter aufrufen können.

Hinweis

Obwohl TableAdapters mit dem DataSet-Designer erstellt und bearbeitet werden, sind TableAdapters keine geschachtelten Klassen innerhalb eines Datasets.TableAdapter befinden sich in einem Namespace, dessen Bezeichnung auf dem Namen des dem TableAdapter zugeordneten Datasets basiert.Die Namenskonvention lautet: DataSetName + "TableAdapters".Zum Beispiel befinden sich alle dem NorthwindDataSet zugeordneten TableAdapters im NorthwindDataSetTableAdapters-Namespace.Der vollqualifizierte Name eines CustomersTableAdapter wäre beispielsweise NorthwindDataSetTableAdapters.CustomersTableAdapter.

So erstellen Sie eine Instanz des TableAdapter

Ziehen Sie Elemente vom Datenquellenfenster auf ein Formular in der Windows-Anwendung, um auf dem Formular automatisch eine Instanz eines TableAdapter zu erstellen. Überprüfen Sie den TableAdapter auf der Komponentenleiste (dem kleinen Bereich direkt unterhalb des Formulars) auf den Namen der Instanz.

- oder -
Erstellen Sie einen TableAdapter, und erstellen Sie das Projekt. Der TableAdapter wird dann in der Toolbox angezeigt. Ziehen Sie den TableAdapter aus der Toolbox auf ein Formular, um eine Instanz zu erstellen. Überprüfen Sie den TableAdapter auf der Komponentenleiste auf den Namen der Instanz.

- oder -

Erstellen Sie programmgesteuert eine TableAdapter-Instanz:

Dim CustomersTableAdapter1 As NorthwindDataSetTableAdapters.CustomersTableAdapter
CustomersTableAdapter1 = New NorthwindDataSetTableAdapters.CustomersTableAdapter()

NorthwindDataSetTableAdapters.CustomersTableAdapter customersTableAdapter1;
customersTableAdapter1 = new NorthwindDataSetTableAdapters.CustomersTableAdapter();

Ausführen von TableAdapter-Abfragen, die vorhandene Datentabellen füllen (Fill()-Methoden)

So führen Sie eine TableAdapter-Abfrage aus, die eine vorhandene Datentabelle füllt

Rufen Sie die Fill-Abfrage oder die FillBy-Abfrage auf, und übergeben Sie die zu füllende Datentabelle. Im folgenden Code wird durch Ausführen der Fill-Abfrage die Tabelle Customers gefüllt:
```
CustomersTableAdapter1.Fill(NorthwindDataSet1.Customers)
```
```
customersTableAdapter1.Fill(northwindDataSet1.Customers);
```

Ausführen von TableAdapter-Abfragen, die neue Datentabellen zurückgeben (GetData()-Methoden)

So führen Sie eine TableAdapter-Abfrage aus, die eine neue Datentabelle zurückgibt

Rufen Sie die GetData-Abfrage oder die GetDataBy-Abfrage auf, um eine typisierte Datentabelle zurückzugeben, die mit den Ergebnissen der Abfrage gefüllt ist. Im folgenden Code wird durch Ausführen der GetData-Abfrage die Tabelle Customers zurückgegeben:
```
Dim newCustomersTable As NorthwindDataSet.CustomersDataTable
newCustomersTable = CustomersTableAdapter1.GetData()
```
```
NorthwindDataSet.CustomersDataTable newCustomersTable;
newCustomersTable = customersTableAdapter1.GetData();
```

Ausführen von TableAdapter-Abfragen, die einzelne (skalare) Werte zurückgeben

Sie können eine Abfrage direkt aus der Toolbox auf den DataSet-Designer ziehen, um eine eigenständige Abfrage zu erstellen (eine Abfrage ohne Datentabelle).

So führen Sie eine TableAdapter-Abfrage aus, die einen einzelnen (skalaren) Wert zurückgibt

Erstellen Sie eine Instanz des TableAdapter, deklarieren Sie eine Variable, die den Rückgabewert enthält, und weisen Sie ihr das Ergebnis der Abfrage zu. Im folgenden Beispiel wird davon ausgegangen, dass für den QueriesTableAdapter eine Abfrage mit dem Namen CustomerCount vorhanden ist.

Dim scalarQueriesTableAdapter As NorthwindDataSetTableAdapters.QueriesTableAdapter
scalarQueriesTableAdapter = New NorthwindDataSetTableAdapters.QueriesTableAdapter()

Dim returnValue As Integer
returnValue = CType(scalarQueriesTableAdapter.CustomerCount(), Integer)

NorthwindDataSetTableAdapters.QueriesTableAdapter scalarQueriesTableAdapter;
scalarQueriesTableAdapter = new NorthwindDataSetTableAdapters.QueriesTableAdapter();

int returnValue;
returnValue = (int)scalarQueriesTableAdapter.CustomerCount();

Siehe auch

Aufgaben

Gewusst wie: Erstellen von TableAdapters

Gewusst wie: Erstellen von TableAdapter-Abfragen

Gewusst wie: Bearbeiten von TableAdapter-Abfragen

Gewusst wie: Direktes Zugreifen auf die Datenbank mit einem TableAdapter

Exemplarische Vorgehensweise: Speichern von Daten mit den TableAdapter-DBDirect-Methoden

Gewusst wie: Datennavigation mithilfe des DataNavigator-Steuerelements in Windows Forms

Exemplarische Vorgehensweise: Anzeigen von Daten in einem Windows Form

Konzepte

Übersicht über TableAdapters

Abrufen von Daten für die Anwendung

Binden von Windows Forms-Steuerelementen an Daten in Visual Studio

Erstellen und Bearbeiten von typisierten Datasets

Übersicht über Datenquellen

Überprüfen von Daten

Freigeben über