Gewusst wie: Erstellen von TableAdapter-Abfragen
Veröffentlicht: Juli 2016
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:
string cityValue = "Seattle";
customersTableAdapter.FillByCity(northwindDataSet.Customers, cityValue);
Dim cityValue As String = "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 Personalisieren von Visual Studio-IDE.
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".
Siehe auch
Übersicht über TableAdapters
Gewusst wie: Bearbeiten von TableAdapter-Abfragen
Erstellen und Bearbeiten von typisierten Datasets
Übersicht über Datenquellen
Gewusst wie: Herstellen einer Verbindung zu Daten in einer Datenbank
Überprüfen von Daten
Gewusst wie: Datennavigation mithilfe des DataNavigator-Steuerelements in Windows Forms
Exemplarische Vorgehensweise: Anzeigen von Daten in einem Windows Form
Exemplarische Vorgehensweise: Erstellen eines TableAdapter mit mehreren Abfragen