Gewusst wie: Erstellen von TableAdapter-Abfragen

Aktualisiert: November 2007

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

Hinweis:

Je nach den aktiven Einstellungen oder der Version unterscheiden sich die Dialogfelder und Menübefehle auf Ihrem Bildschirm möglicherweise von den in der Hilfe beschriebenen. Klicken Sie im Menü Extras auf Einstellungen importieren und exportieren, um die Einstellungen zu ändern. Weitere Informationen finden Sie unter Visual Studio-Einstellungen.

Erstellen einer Abfrage im Dataset-Designer

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

  1. Öffnen Sie ein Dataset im Dataset-Designer. Weitere Informationen finden Sie unter Gewusst wie: Öffnen eines Datasets im DataSet-Designer.

  2. Klicken Sie mit der rechten Maustaste auf den gewünschten TableAdapter, und wählen Sie Abfrage hinzufügen aus.

    – oder –

  3. 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.

  4. 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

  1. Wählen Sie einen TableAdapter im Komponentenfach aus.

  2. Klicken Sie auf das Smarttag des TableAdapter, und wählen Sie Abfrage hinzufügen aus.

  3. Füllen Sie das Dialogfeld aus. Die Abfrage wird dann dem TableAdapter hinzugefügt. Weitere Informationen finden Sie unter Dialogfeld "Suchkriterien-Generator".

Siehe auch

Aufgaben

Gewusst wie: Bearbeiten von TableAdapter-Abfragen

Gewusst wie: Herstellen einer Verbindung zu Daten in einer Datenbank

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

Exemplarische Vorgehensweise: Anzeigen von Daten in einem Formular in einer Windows-Anwendung

Konzepte

Übersicht über TableAdapters

Übersicht über das Anzeigen von Daten

DataSet-Designer

Übersicht über Datenquellen

Weitere Ressourcen

Überprüfen von Daten