Gewusst wie: Ausführen von TableAdapter-Abfragen

Artikel
09/02/2008

Aktualisiert: November 2007

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 Konfigurations-Assistent für TableAdapter-Abfragen 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.

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 im Komponentenfach (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 im Komponentenfach 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

Freigeben über