Gewusst wie: Erstellen von TableAdapter-Abfragen

Artikel
06/01/2015

TableAdapter-Abfragen sind SQL-Anweisungen oder gespeicherte Prozeduren, die von der Anwendung für eine Datenbank ausgeführt werden können.

Fügen Sie einem TableAdapter so viele Abfragen wie für die Anwendung erforderlich hinzu. TableAdapter-Abfragen werden in einem TableAdapter als Methoden angezeigt. Wenn Sie die Abfrage FillByCity erstellen, die einen Parameter annimmt, der den Wert für den Ort darstellt, wird die Abfrage dem TableAdapter hinzugefügt. Sie wird als typisierte Methode hinzugefügt, die den richtigen Parametertyp als Argument annimmt, in diesem Falle eine Zeichenfolge, die den Wert für den Ort darstellt. Sie rufen die TableAdapter-Abfrage einfach wie jede andere Methode für ein beliebiges Objekt auf. Der folgende Code führt z. B. die FillByCity-Abfrage aus und füllt die Customers-Tabelle mit allen Kunden mit dem Ortswert Seattle auf:

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

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

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. (Klicken Sie mit der rechten Maustaste auf einen beliebigen TableAdapter, und wählen Sie Abfrage hinzufügen aus.)

Hinweis

Auf Ihrem Computer werden möglicherweise andere Namen oder Speicherorte für die Benutzeroberflächenelemente von Visual Studio angezeigt als die in den folgenden Anweisungen aufgeführten. Diese Elemente sind von der jeweiligen Visual Studio-Version und den verwendeten Einstellungen abhängig. Weitere Informationen finden Sie unter Anpassen der Entwicklungseinstellungen in Visual Studio.

Erstellen einer Abfrage im Dataset-Designer

So fügen Sie einem TableAdapter im Dataset-Designer eine Abfrage hinzu

Öffnen Sie ein Dataset im Dataset-Designer. Weitere Informationen finden Sie unter Gewusst wie: Öffnen eines Datasets im DataSet-Designer.
Klicken Sie mit der rechten Maustaste auf den gewünschten TableAdapter, und wählen Sie Abfrage hinzufügen aus.

- oder -
Ziehen Sie in der Toolbox aus der Registerkarte DataSet eine Abfrage auf eine Tabelle im Designer.

Der Konfigurations-Assistent für TableAdapter-Abfragen wird geöffnet.
Stellen Sie den Assistenten fertig. Die Abfrage wird dem TableAdapter hinzugefügt.

Direktes Erstellen einer Abfrage auf einem Formular in der Windows-Anwendung

Wenn auf dem Formular eine Instanz eines TableAdapter vorhanden ist, können Sie in der Dialogfeld "Suchkriterien-Generator" eine Abfrage hinzufügen, womit dem Formular ein ToolStrip-Steuerelement, das alle von der Abfrage angeforderten Eingabeparameter akzeptiert, sowie eine Schaltfläche zum Ausführen der Abfrage hinzugefügt werden.

So fügen Sie einem TableAdapter über das Dialogfeld Suchkriterien eine Abfrage hinzu

Wählen Sie einen TableAdapter auf der Komponentenleiste aus.
Klicken Sie auf das Smarttag des TableAdapter, und wählen Sie Abfrage hinzufügen aus.
Füllen Sie das Dialogfeld aus. Die Abfrage wird dann dem TableAdapter hinzugefügt. Weitere Informationen finden Sie unter Dialogfeld "Suchkriterien-Generator".