Freigeben über


TableAdapter-Abfragekonfigurations-Assistent

Mit dem Konfigurations-Assistenten für TableAdapter-Abfragen können Sie auf einfache Weise zusätzliche Abfragen erstellen und bearbeiten, die Sie TableAdapters hinzufügen können. Bei einer TableAdapter-Abfrage handelt es sich um eine gültige SQL-Abfrage oder gespeicherte Prozedur, die einen Skalarwert oder Daten zurückgibt, die demselben Schema entsprechen wie die mit dem TableAdapter verknüpfte Datentabelle. Nach Beendigung des Assistenten wird dem TableAdapter eine Methode hinzugefügt, die bei Aufruf die Abfrage ausführt. (Beispiel: CustomersTableAdapter.FillByCity(NorthwindDataSet.Customers, "Seattle").)

Ausführen des Assistenten

Ziehen Sie Abfragen auf den Dataset-Designer, oder konfigurieren Sie vorhandene Abfragen (jede Abfrage, die unterhalb der ersten Abfrage aufgeführt ist).

Bei der ersten Abfrage in einem TableAdapter handelt es sich um die Hauptabfrage des TableAdapter. Wenn Sie diese Hauptabfrage bearbeiten, wird der TableAdapter-Konfigurations-Assistent geöffnet und das Schema für die Datentabelle des TableAdapter bearbeitet. Alle unterhalb der Hauptabfrage aufgeführten Abfragen sind zusätzliche Abfragen, die mit dem Konfigurations-Assistenten für TableAdapter-Abfragen konfiguriert werden. Weitere Informationen zum Ausführen des Assistenten finden Sie unter Gewusst wie: Starten des Konfigurations-Assistenten für TableAdapter-Abfragen.

Auswählen einer Datenverbindung

Wählen Sie in der Liste der Verbindungen eine vorhandene Verbindung aus, oder klicken Sie auf Neue Verbindung, um Dialogfeld "Verbindung hinzufügen/ändern" (Allgemein) zu öffnen und eine Verbindung mit der Datenquelle zu erstellen.

Nach Beendigung des Dialogfelds Verbindungseigenschaften werden im Bereich Verbindungsdetails schreibgeschützte Informationen zum ausgewählten Anbieter sowie zur Verbindungszeichenfolge angezeigt.

Speichern der Verbindungszeichenfolge in der Anwendungskonfigurationsdatei

Wählen Sie Ja, Verbindung speichern unter aus, um die Verbindungszeichenfolge in der Anwendungskonfigurationsdatei zu speichern. Geben Sie einen Namen für die Verbindung ein, oder verwenden Sie den angegebenen Standardnamen.

Das Speichern von Verbindungszeichenfolgen in der Anwendungskonfigurationsdatei vereinfacht das Verwalten der Anwendung, falls die Datenbankverbindung geändert wird. Wenn sich die Datenbankverbindung ändert, können Sie die Verbindungszeichenfolge in der Anwendungskonfigurationsdatei bearbeiten. Auf diese Weise müssen Sie den Quellcode nicht bearbeiten und Ihre Anwendung nicht erneut kompilieren. Informationen zum Bearbeiten einer Verbindungszeichenfolge in der Anwendungskonfigurationsdatei finden Sie unter Gewusst wie: Speichern und Bearbeiten von Verbindungszeichenfolgen.

SicherheitshinweisSicherheitshinweis

In der Anwendungskonfigurationsdatei werden alle Informationen als Nur-Text gespeichert. Um die Möglichkeit eines unberechtigten Zugriffs auf vertrauliche Daten einzuschränken, empfiehlt es sich, die Daten zu verschlüsseln. Weitere Informationen finden Sie unter Verschlüsseln und Entschlüsseln von Daten.

SQL-Anweisungen verwenden

In diesem Abschnitt wird erläutert, wie Sie den Konfigurations-Assistenten für TableAdapter-Abfragen bei Auswahl der Option SQL-Anweisungen verwenden ausführen.

Abfragetyp auswählen

In Abhängigkeit von den Anforderungen der Anwendung erstellt der Assistent mehrere Typen von Abfragen. Sie können SELECT-Abfragen auswählen, die Datenzeilen zurückgeben (Datentabelle), oder Sie können SELECT-Abfragen auswählen, die einen Skalarwert zurückgeben (einen Einzelwert wie Count oder Sum).

Wählen Sie auf der Seite Abfragetyp auswählen die Art der Abfrage aus, die aus der Liste der verfügbaren Abfragen erstellt werden soll.

Tipp

Das Erstellen von INSERT-, UPDATE- oder DELETE-Anweisungen ist kein Ersatz für die TableAdapter-Befehle, die beim Aufrufen der Update-Methode des TableAdapter verwendet werden. Wenn Sie z. B.den Abfragetyp UPDATE auswählen, wird eine neue Abfrage mit einem Namen erstellt, den Sie zu einem späteren Zeitpunkt im Assistenten angeben. Sie führen diese Abfrage aus, indem Sie diese benannte Methode des TableAdapter aufrufen. Wenn Sie die Update-Methode des TableAdapter aufrufen, werden Anweisungen ausgeführt, die bei der ursprünglichen Konfiguration des TableAdapter erstellt wurden.

SQL-<Abfragetyp>-Anweisung angeben

Geben Sie auf der Seite SQL-Anweisung angeben die SQL-Anweisung ein, die beim Aufrufen der Abfrage ausgeführt werden soll.

Tipp

Der Assistent ermöglicht den Zugriff auf den Abfrage-Generator, ein visuelles Tool für die Erstellung von SQL-Abfragen. Klicken Sie zum Öffnen auf die Schaltfläche Abfrage-Generator. Weitere Informationen zum Verwenden des Abfrage-Generators finden Sie unter Tools im Abfrage- und Ansicht-Designer, oder drücken Sie F1 im entsprechenden Dialogfeld.

Methode zum Generieren auswählen

Auf dieser Seite finden Sie Optionen, mit denen Sie auswählen können, welche Methoden der Assistent für die Abfrage generieren soll.

  • DataTable füllen
    Erstellt eine Methode zum Füllen der Datentabelle. Sie übergeben den Namen der Datentabelle als Parameter, wenn Sie diese Methode aufrufen, um die Datentabelle mit den zurückgegebenen Daten zu füllen.

    Optional können Sie den Standardnamen im Feld Methodenname ändern. für die Verwendung von dieser Abfrage im Code kann es hilfreich sein, einen aussagekräftigen Namen anzugeben.

  • DataTable zurückgeben
    Erstellt eine Methode zum Zurückgeben einer gefüllten Datentabelle. In bestimmten Anwendungen kann es sinnvoller sein, gefüllte Datentabellen zurückzugeben, als vorhandene Datentabellen mit Daten zu füllen.

    Optional können Sie den Standardnamen im Feld Methodenname ändern.

Funktionsnamen wählen

Geben Sie einen Namen für die Funktion ein. Beim Erstellen einer TableAdapter-Abfrage wird dem TableAdapter eine Methode mit dem hier angegebenen Namen hinzugefügt. Rufen Sie diese Methode auf, um die Abfrage auszuführen. für die Verwendung von dieser Abfrage im Code ist es hilfreich, einen aussagekräftigen Namen anzugeben.

Tipp

Wenn Sie neue gespeicherte Prozeduren erstellen, werden Sie aufgefordert, zwei Namen einzugeben. Der erste Name ist der Name der in der Datenbank erstellten gespeicherten Prozedur. Der zweite Name ist der Name der Methode für den TableAdapter, die bei einem entsprechenden Aufruf die gespeicherte Prozedur ausführt.

Neue gespeicherte Prozeduren erstellen

In diesem Abschnitt wird erläutert, wie Sie den Konfigurations-Assistenten für TableAdapter-Abfragen bei Auswahl der Option Neue gespeicherte Prozeduren erstellen ausführen.

  1. Geben Sie auf der Seite Gespeicherte Prozeduren generieren die SQL-Anweisung ein, die beim Aufrufen der gespeicherten Prozedur ausgeführt werden soll.

    Tipp

    Der Assistent ermöglicht den Zugriff auf den Abfrage-Generator, ein visuelles Tool für die Erstellung von SQL-Abfragen. Klicken Sie zum Öffnen auf die Schaltfläche Abfrage-Generator. Weitere Informationen zum Verwenden des Abfrage-Generators finden Sie unter Tools im Abfrage- und Ansicht-Designer, oder drücken Sie F1 im entsprechenden Dialogfeld.

  2. Gehen Sie auf der Seite Gespeicherte Prozeduren erstellen folgendermaßen vor:

    1. Geben Sie einen Namen für die neue gespeicherte Prozedur ein.

    2. Geben Sie an, ob die gespeicherte Prozedur in der zugrunde liegenden Datenbank erstellt werden soll.

      Tipp

      Die Möglichkeit zum Erstellen einer gespeicherten Prozedur in der Datenbank ist von den Sicherheitseinstellung der betreffenden Datenbank abhängig.

    Auf der Seite Assistentenergebnisse anzeigen werden die Ergebnisse für das Erstellen der TableAdapter-Abfrage angezeigt. Wenn im Assistenten Probleme auftreten, werden auf dieser Seite die Fehlerinformationen angezeigt.

Vorhandene gespeicherte Prozeduren verwenden

In diesem Abschnitt wird erläutert, wie Sie den Konfigurations-Assistenten für TableAdapter-Abfragen bei Auswahl der Option Vorhandene gespeicherte Prozeduren verwenden ausführen.

  1. Wählen Sie auf der Seite Vorhandene gespeicherte Prozedur auswählen des Assistenten eine vorhandene gespeicherte Prozedur aus der Dropdownliste aus.

    Zu Referenzzwecken werden die Parameter und die Ergebnisse für die ausgewählte gespeicherte Prozedur angezeigt.

  2. Klicken Sie auf Next.

Von der gespeicherten Prozedur zurückgegebene Form der Daten auswählen

Der Typ der von der ausgewählten gespeicherten Prozedur zurückgegebenen Daten bestimmt, wie der Assistent die TableAdapter-Methoden erstellt.

Wählen Sie den Datentyp aus, der von dieser Abfrage zurückgegeben werden soll.

  • Wenn Sie Tabellendaten auswählen, wird die Seite Methode zum Generieren auswählen geöffnet (auf dieser Hilfeseite an früherer Stelle beschrieben). Hier können Sie die zu erstellenden Typen und Namen von Methoden angeben sowie die Pagingunterstützung festlegen.

  • Wenn Sie Einzelner Wert auswählen, wird eine eine typisierte Methode erstellt, die einen einzelnen Wert zurückgibt. Mit dieser Option wird die Seite Funktionsnamen wählen geöffnet (auf dieser Hilfeseite an früherer Stelle beschrieben).

  • Wenn Sie Kein Wert auswählen, wird eine typisierte Methode erstellt, die die gespeicherte Prozedur ausführt und keine Datenrückgabe erwartet. Mit dieser Option wird die Seite Funktionsnamen wählen geöffnet (auf dieser Hilfeseite an früherer Stelle beschrieben).

Anzeigen der Assistentenergebnisse

Auf der Seite Assistentenergebnisse anzeigen werden die Ergebnisse für das Erstellen der TableAdapter-Abfrage angezeigt. Wenn im Assistenten Probleme aufgetreten sind, werden die entsprechenden Details auf dieser Seite angezeigt.

Siehe auch

Aufgaben

Gewusst wie: Bearbeiten von TableAdapter-Abfragen

Konzepte

Übersicht über TableAdapters

Neues in der Datenanwendungsentwicklung

Binden von Windows Forms-Steuerelementen an Daten in Visual Studio

Binden von Steuerelementen an Daten in Visual Studio

Weitere Ressourcen

Exemplarische Vorgehensweisen zur Arbeit mit Daten

Übersicht über Datenanwendungen in Visual Studio

Herstellen von Datenverbindungen in Visual Studio

Vorbereiten der Anwendung auf den Empfang von Daten

Abrufen von Daten für die Anwendung

Bearbeiten von Daten in der Anwendung

Überprüfen von Daten

Speichern von Daten