TableAdapter-Konfigurations-Assistent

Artikel
08/10/2011

Der TableAdapter-Konfigurations-Assistent erstellt und bearbeitet TableAdapters. Der Assistent erstellt TableAdapters auf der Grundlage von eingegebenen SQL-Anweisungen oder gespeicherten Prozeduren in der Datenbank. Ausgehend von SQL-Anweisungen, die Sie im Assistenten eingeben, kann der Assistent auch neue gespeicherte Prozeduren in der Datenbank erstellen.

Ein TableAdapter stellt eine Verbindung mit einer Datenbank her, führt Abfragen oder gespeicherte Prozeduren in einer Datenbank aus und füllt eine DataTable mit den von der Abfrage oder der gespeicherten Prozedur zurückgegebenen Daten. TableAdapters füllen nicht nur vorhandene Datentabellen mit Daten, sondern können auch neue mit Daten gefüllte Datentabellen zurückgeben. Weitere Informationen finden Sie unter Übersicht über TableAdapters.

Ausführen des Assistenten

Führen Sie den Assistenten aus, um TableAdapters und deren zugeordnete Datentabellen zu erstellen oder zu bearbeiten. Weitere Informationen finden Sie unter Gewusst wie: Starten des TableAdapter-Konfigurations-Assistenten.

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.

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

Wählen Sie einen Befehlstyp aus

Wählen Sie den Befehlstyp aus, der für die Datenbank ausgeführt werden soll.

Wählen Sie auf der Seite Wählen Sie einen Befehlstyp aus eine der folgenden Methoden zum Abrufen von Daten aus der Datenbank aus:

SQL-Anweisungen verwenden – Mit dieser Option können Sie eine SQL-Anweisung eingeben, um die Daten in der Datenbank auszuwählen.
Neue gespeicherte Prozeduren erstellen: Wählen Sie diese Option aus, um vom Assistenten neue gespeicherte Prozeduren (in der Datenbank) erstellen zu lassen, die auf der angegebenen SELECT-Anweisung beruhen.
Vorhandene gespeicherte Prozeduren verwenden: Wählen Sie diese Option aus, um gespeicherte Prozeduren, die bereits in der Datenbank vorhanden sind, den Befehlen SELECT, INSERT, UPDATE und DELETE des TableAdapter zuzuordnen.

SQL-Anweisungen verwenden

In diesem Abschnitt wird erläutert, welche Schritte im TableAdapter-Konfigurations-Assistenten auszuführen sind, wenn die Option SQL-Anweisungen verwenden ausgewählt wird.

Geben Sie auf der Seite SQL-Anweisungen generieren die SQL-Anweisung ein, bei deren Ausführung die Datentabelle mit Daten gefüllt wird.

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.

Auf der Seite Assistentenergebnisse anzeigen werden die Ergebnisse für die Erstellung des TableAdapter angezeigt. Wenn im Assistenten Probleme auftreten, werden auf dieser Seite die Fehlerinformationen angezeigt.

Methode zum Generieren auswählen

Diese Seite enthält Optionen, mit denen Sie diejenigen TableAdapter-Methoden auswählen, die der Assistent zum Abrufen und Aktualisieren von Daten generiert.

DataTable füllen
Erstellt die Standardmethode des TableAdapter zum Auffüllen der Datentabelle. Übergeben Sie den Namen der Datentabelle als Parameter, wenn Sie diese Methode aufrufen.

Optional können Sie den Standardnamen im Feld Methodenname ändern.
DataTable zurückgeben
Erstellt die Methode des TableAdapter 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.
Methoden erstellen, um Updates direkt an die Datenbank zu senden
Erstellt die Befehle INSERT, UPDATE und DELETE, die zum Ändern der zugrunde liegenden Datenbank benötigt werden. Die Auswahl dieses Felds hat den gleichen Effekt wie das Festlegen der GenerateDBDirectMethods-Eigenschaft auf true.

Tipp

Diese Option ist nicht verfügbar, wenn die ursprüngliche SQL-Anweisung nicht genügend Informationen bereitstellt oder die Abfrage keine aktualisierbare Abfrage darstellt. Diese Situation kann beispielsweise bei JOIN-Abfragen und Abfragen auftreten, die einen einzelnen Wert (Skalarwert) zurückgeben.

Neue gespeicherte Prozeduren erstellen

In diesem Abschnitt wird erläutert, welche Schritte im TableAdapter-Konfigurations-Assistenten auszuführen sind, wenn die Option Neue gespeicherte Prozeduren erstellen ausgewählt wird.

Geben Sie auf der Seite Gespeicherte Prozeduren generieren die SQL-Anweisung ein, die zum Füllen der Datentabelle dient. Dies ist die SELECT-Anweisung des TableAdapter, auf deren Grundlage die gespeicherten Prozeduren zum Auswählen, Aktualisieren, Einfügen und Löschen von Daten erstellt werden.

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.
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, in der Datenbank gespeicherte Prozeduren zu erstellen, hängt von den Sicherheitseinstellungen und Berechtigungen für die jeweilige Datenbank ab. Wenn Sie z. B. nicht berechtigt sind, in der Datenbank neue gespeicherte Prozeduren zu erstellen, kann diese Option nicht ausgeführt werden.
Auf der Seite Assistentenergebnisse anzeigen werden die Ergebnisse für die Erstellung des TableAdapter angezeigt. Wenn im Assistenten Probleme auftreten, werden auf dieser Seite die Fehlerinformationen angezeigt.

Vorhandene gespeicherte Prozeduren verwenden

In diesem Abschnitt wird erläutert, welche Schritte im TableAdapter-Konfigurations-Assistenten auszuführen sind, wenn die Option Vorhandene gespeicherte Prozeduren verwenden ausgewählt wird.

Befehle an vorhandene gespeicherte Prozeduren binden

Wählen Sie die gespeicherte Prozedur, die für die Befehle SELECT, INSERT, UPDATE und DELETE des TableAdapter ausgeführt werden soll. Diese gespeicherten Prozeduren werden ausgeführt, wenn die zugeordneten Methoden über den TableAdapter aufgerufen werden. Die dem Befehl Update zugeordnete gespeicherte Prozedur wird z. B. ausgeführt, wenn die TableAdapter.Update()-Methode aufgerufen wird.

Ordnen Sie die Parameter der ausgewählten gespeicherten Prozedur den entsprechenden Spalten in der Datentabelle zu. Wenn die gespeicherte Prozedur z. B. einen Parameter mit dem Namen @CompanyName annimmt, welcher der Spalte CompanyName in der Tabelle übergeben wird, legen Sie als Quellspalte des @CompanyName-Parameters CompanyName fest.

Tipp

Die dem SELECT-Befehl zugeordnete gespeicherte Prozedur wird ausgeführt, indem die Methode des TableAdapter aufgerufen wird, die Sie im nächsten Schritt des Assistenten angeben. Die Standardmethode ist Fill; der typische Code zum Ausführen der SELECT-Prozedur lautet somit TableAdapter.Fill(tableName). Ersetzen Sie Fill durch den Namen, den Sie zuordnen, wenn Sie nicht den Standardnamen Fill verwenden, und ersetzen Sie "TableAdapter" durch den tatsächlichen Namen des TableAdapter (beispielsweise CustomersTableAdapter).

Erweiterte Optionen

Wenn Sie auf Erweiterte Optionen klicken, können Sie auf die folgenden erweiterten Optionen des TableAdapter zugreifen. Weitere Informationen finden Sie unter Dialogfeld "Erweiterte SQL-Generierungsoptionen".

Insert-, Update- und Delete-Anweisungen generieren

Wenn Sie diese Option auswählen, versucht der Assistent, INSERT-, UPDATE- und DELETE-Anweisungen zu generieren, die auf der SELECT-Anweisung beruhen, die auf der Seite SQL-Anweisungen eingeben definiert wurden.
Vollständige Parallelität verwenden

Wenn Sie diese Option auswählen, werden die UPDATE-Anweisungen und DELETE-Anweisungen so geändert, dass festgestellt werden kann, ob einzelne Datensätze nach dem erstmaligen Einlesen in die Datentabelle geändert wurden. Eine Ausnahme wird ausgelöst, wenn Parallelitätsverstöße erkannt werden.
Datentabelle aktualisieren

Wenn Sie diese Option auswählen, werden die Daten in der Tabelle aktualisiert, nachdem INSERT-Anweisungen und UPDATE-Anweisungen ausgeführt wurden.

Nächste Schritte

Nach der Beendigung des Assistenten wird der TableAdapter zum Dataset hinzugefügt und kann im DataSet-Designer angezeigt und bearbeitet werden. Danach können Sie eine Reihe von weiteren Schritten durchführen.

Fügen Sie weitere TableAdapters hinzu. Der Assistent erstellt einen TableAdapter. Wenn Sie ein Dataset verwenden möchten, das mehrere Tabellen enthält, sollten Sie weitere TableAdapters zum Dataset hinzufügen.
Fügen Sie zusätzliche Abfragen zum TableAdapter hinzu. Weitere Informationen finden Sie unter Gewusst wie: Erstellen von TableAdapter-Abfragen.
Zeigen Sie dieses Dataset im Datenquellenfenster an, und ziehen Sie Elemente auf die Formulare, um datengebundene Steuerelemente zu erstellen. Weitere Informationen finden Sie unter Binden von Windows Forms-Steuerelementen an Daten in Visual Studio.

Siehe auch