Exemplarische Vorgehensweise: Erstellen eines TableAdapter mit mehreren Abfragen

Artikel
09/02/2008

Aktualisiert: November 2007

In dieser exemplarischen Vorgehensweise erstellen Sie mit dem Assistent zum Konfigurieren von Datenquellen einen TableAdapter in einem Dataset. In dieser exemplarischen Vorgehensweise werden die Schritte zum Erstellen einer zweiten Abfrage im TableAdapter mithilfe von Konfigurations-Assistent für TableAdapter-Abfragen im Dataset-Designer erläutert.

Zu den Aufgaben in dieser exemplarischen Vorgehensweise gehören:

Erstellen eines neuen Projekts vom Typ Windows-Anwendung.
Erstellen und Konfigurieren einer Datenquelle in der Anwendung, indem mit dem Assistenten zum Konfigurieren von Datenquellen ein Dataset erstellt wird.
Öffnen des neuen Datasets im Dataset-Designer.
Hinzufügen von Abfragen zum TableAdapter mit dem TableAdapter-Konfigurations-Assistenten.

Vorbereitungsmaßnahmen

Für die Durchführung dieser exemplarischen Vorgehensweise benötigen Sie Folgendes:

Zugriff auf die Beispieldatenbank Northwind (SQL Server- oder Access-Version). Weitere Informationen finden Sie unter Gewusst wie: Installieren von Beispieldatenbanken.

Erstellen einer neuen Windows-Anwendung.

Im ersten Schritt wird eine Windows-Anwendung erstellt.

So erstellen Sie ein neues Windows-Anwendungsprojekt

Erstellen Sie in Visual Studio über das Menü Datei ein neues Projekt.
Wählen Sie im Bereich Projekttypen eine Programmiersprache aus.
Klicken Sie im Bereich Vorlagen auf Windows-Anwendung.
Nennen Sie das Projekt TableAdapterQueriesWalkthrough, und klicken Sie anschließend auf OK.

Visual Studio fügt das Projekt dem Projektmappen-Explorer hinzu und zeigt im Designer ein neues Formular an.

Erstellen einer Datenbank-Datenquelle mit einem TableAdapter

In diesem Schritt wird mit dem Assistenten zum Konfigurieren von Datenquellen eine Datenquelle erstellt, die auf der Tabelle Customers der Beispieldatenbank Northwind basiert. Sie müssen Zugriff auf die Beispieldatenbank Northwind haben, um die Verbindung erstellen zu können. Informationen zum Einrichten der Beispieldatenbank Northwind finden Sie unter Gewusst wie: Installieren von Beispieldatenbanken.

So erstellen Sie die Datenquelle

Klicken Sie im Menü Daten auf Datenquellen anzeigen.
Wählen Sie im Datenquellenfenster die Option Neue Datenquelle hinzufügen aus, um den Assistenten zum Konfigurieren von Datenquellen zu starten.
Wählen Sie auf der Seite Datenquellentyp auswählen die Option Datenbank aus, und klicken Sie dann auf Weiter.
Führen Sie auf der Seite Wählen Sie Ihre Datenverbindung aus einen der folgenden Schritte aus:
- Wenn in der Dropdownliste eine Datenverbindung mit der Beispieldatenbank Northwind verfügbar ist, wählen Sie sie aus.
  
  – oder –
- Wählen Sie Neue Verbindung aus, um das Dialogfeld Verbindung hinzufügen/ändern zu öffnen. Weitere Informationen finden Sie unter Dialogfeld "Verbindung hinzufügen/ändern" (Allgemein).
Falls die Datenbank ein Kennwort erfordern sollte, aktivieren Sie die Option für die Einbeziehung vertraulicher Daten, und klicken Sie dann auf Weiter.
Klicken Sie auf der Seite Verbindungszeichenfolge in der Anwendungskonfigurationsdatei speichern auf Weiter.
Erweitern Sie auf der Seite Datenbankobjekte auswählen den Knoten Tabellen.
Wählen Sie die Tabelle Customers aus, und klicken Sie anschließend auf Fertig stellen.

NorthwindDataSet wird dem Projekt hinzugefügt, und die Customers-Tabelle wird im Datenquellenfenster angezeigt.

Öffnen des Datasets im Dataset-Designer

So öffnen Sie das Dataset im Dataset-Designer.

Klicken Sie im Datenquellenfenster mit der rechten Maustaste auf NorthwindDataset.
Klicken Sie im Kontextmenü auf DataSet mit Designer bearbeiten.

Das Dataset NorthwindDataset wird im Dataset-Designer geöffnet.

Hinzufügen einer zweiten Abfrage zu CustomersTableAdapter

Der Assistent hat das Dataset mit einer Datentabelle Customers und dem CustomersTableAdapter erstellt. In diesem Abschnitt der exemplarischen Vorgehensweise wird dem CustomersTableAdapter eine zweite Abfrage hinzugefügt.

So fügen Sie dem CustomersTableAdapter eine Abfrage hinzu

Ziehen Sie in der Toolbox aus der Registerkarte DataSet eine Abfrage auf die Tabelle Customers.

Der Konfigurations-Assistent für TableAdapter-Abfragen wird geöffnet.
Wählen Sie SQL-Anweisungen verwenden aus, und klicken Sie anschließend auf Weiter.
Wählen Sie SELECT-Anweisung, die Zeilen zurückgibt aus, und klicken Sie dann auf Weiter.

Fügen Sie der Abfrage eine WHERE-Klausel hinzu, sodass sie wie folgt aussieht:

SELECT CustomerID, CompanyName, ContactName, ContactTitle, Address, City, Region, PostalCode, Country, Phone, Fax 
FROM Customers 
WHERE City = @City

Hinweis:
Wenn Sie die Access-Version der Northwind-Datenbank verwenden, ersetzen Sie den Parameter @City durch ein Fragezeichen. (SELECT CustomerID, CompanyName, ContactName, ContactTitle, Address, City, Region, PostalCode, Country, Phone, Fax FROM Customers WHERE City = ?)

Geben Sie auf der Seite Methode zum Generieren auswählen der DataTable füllen-Methode den Namen FillByCity.

Hinweis:
Die Methode für DataTable zurückgeben wird in dieser exemplarischen Vorgehensweise nicht verwendet. Daher kann das entsprechende Kontrollkästchen deaktiviert oder der Standardname beibehalten werden.

Klicken Sie auf Weiter, und beenden Sie den Assistenten.

Dem CustomersTableAdapter wird die FillByCity-Abfrage hinzugefügt.

Hinzufügen von Code zum Ausführen der zusätzlichen Abfrage im Formular

So führen Sie die Abfrage aus

Wählen Sie im Projektmappen-Explorer die Option Form1 aus, und klicken Sie auf Ansicht-Designer.
Ziehen Sie den Knoten Customers aus dem Datenquellenfenster auf Form1.
Ändern Sie die Codeansicht, indem Sie im Menü Ansicht die Option Code auswählen.

Ersetzen Sie den Code im Form1_Load-Ereignishandler durch Folgendes, um die FillByCity-Abfrage auszuführen.

Dim cityValue As String = "Seattle"
CustomersTableAdapter.FillByCity(NorthwindDataSet.Customers, cityValue)

string cityValue = "Seattle";
customersTableAdapter.FillByCity(northwindDataSet.Customers, cityValue);

Ausführen der Anwendung

So führen Sie die Anwendung aus

Drücken Sie F5.
Das Raster wird mit Kunden mit einem City-Wert von Seattle gefüllt.

Nächste Schritte

So fügen Sie der Anwendung Funktionen hinzu

Fügen Sie ein TextBox-Steuerelement und ein Button-Steuerelement hinzu, und übergeben Sie den Wert im Textfeld an die Abfrage. (CustomersTableAdapter.FillByCity(NorthwindDataSet.Customers, TextBox1.Text)).
Fügen Sie dem ColumnChanging-Ereignis oder dem RowChanging-Ereignis der Datentabellen im Dataset eine Validierungslogik hinzu. Weitere Informationen finden Sie unter Übersicht über die Datenvalidierung.

Siehe auch