Datenadapter-Konfigurations-Assistent

Artikel
09/02/2008

Aktualisiert: November 2007

Der Datenadapter-Konfigurations-Assistent unterstützt Sie beim Festlegen der Eigenschaften eines neuen oder vorhandenen Datenadapters. Ein Datenadapter enthält SQL‑Befehle, die eine Anwendung verwenden kann, um Daten aus einer Datenbank in ein Dataset einzulesen und sie wieder in die Datenbank zurück zu schreiben. Der Assistent kann optional eine Datenverbindung erstellen, durch die der Adapter mit einer Datenbank kommunizieren kann.

Das Konfigurieren eines Datenadapters ist einer der Schritte, die für die Verwendung eines Datasets in einer Anwendung erforderlich sind. Nach dem Ausführen des Assistenten müssen Sie jedoch der Anwendung in einem eigenen Schritt ein Dataset hinzufügen und Code schreiben, sodass der Datenadapter und das Dataset zusammen verwendet werden können.

Hinweis:
In der vorherigen Version von Visual Studio wurden Datenadapter für die Kommunikation zwischen einer Anwendung und einer Datenbank verwendet. Während Datenadapter eine Hauptkomponente von .NET Framework-Datenanbieter (ADO.NET) darstellen, sind TableAdapter vom Designer generierte Komponenten, die das Ändern von Daten zwischen der Anwendung und einer Datenbank vereinfachen. Weitere Informationen zum Verwenden von TableAdapter finden Sie unter Übersicht über TableAdapters.

In der vorherigen Version von Visual Studio wurden Datenadapter für die Kommunikation zwischen einer Anwendung und einer Datenbank verwendet. Während Datenadapter eine Hauptkomponente von .NET Framework-Datenanbieter (ADO.NET) darstellen, sind TableAdapter vom Designer generierte Komponenten, die das Ändern von Daten zwischen der Anwendung und einer Datenbank vereinfachen. Weitere Informationen zum Verwenden von TableAdapter finden Sie unter Übersicht über TableAdapters.

Ausführen des Assistenten

Sie können den Assistenten ausführen, um neue Adapter zu erstellen oder vorhandene zu bearbeiten. Außerdem können Sie den Assistenten für einen vorhandenen Datenadapter ausführen, um dessen Eigenschaften zu bearbeiten.

So führen Sie den Assistenten aus

Führen Sie einen der folgenden Schritte aus:
- Wenn Sie einen neuen Adapter erstellen, ziehen Sie ein DataAdapter-Objekt aus der Toolbox auf ein Formular oder eine Komponente.
- Wenn Sie einen vorhandenen Adapter bearbeiten, wählen Sie diesen im Formular oder in der Komponente aus, und wählen Sie dann im Kontextmenü Datenadapter konfigurieren aus.
Der Assistent wird gestartet.

Geben Sie die Daten für die Verbindung und den SQL‑Befehl an. Dabei zeigt der Assistent zu Ihrer Unterstützung verschiedene Dialogfelder an:

Wenn Sie eine Verbindung herstellen möchten, wird die Registerkarte Verbindung von Dialogfeld "Verbindung hinzufügen/ändern" (Allgemein) im Assistenten angezeigt. Auf dieser Registerkarte können Sie Anbieter, Server-, Datenbank- und Benutzernamen sowie ein Kennwort für die Verbindung angeben.

Um Sie beim Erstellen von SQL-Anweisungen zu unterstützen, stellt der Assistent den Abfrage-Generator bereit, ein Dienstprogramm, mit dem Sie eine Select-Anweisung mithilfe von visuellen Tools erstellen und testen können. Um dieses Dienstprogramm zu starten, klicken Sie auf die Schaltfläche Abfrage-Generator, wenn Sie aufgefordert werden, eine SQL-Anweisung einzugeben. Weitere Informationen finden Sie unter Tools im Abfrage- und Ansicht-Designer.

Tipp:
Wenn Sie angeben, dass Sie gespeicherte Prozeduren erstellen möchten, klicken Sie auf SQL-Skriptvorschau anzeigen, um das Skript einzublenden, mit dem der Assistent die gespeicherten Prozeduren erstellen würde. Sie können dieses Skript kopieren und bearbeiten, um eigene Prozeduren zu erstellen.

Hinweis:
Wenn Sie im Assistenten auf Abbrechen klicken, wird der Adapter zwar erstellt, seine Eigenschaften werden jedoch nicht festgelegt. Sie können die Eigenschaften des Adapters manuell im Eigenschaftenfenster festlegen oder den Assistenten erneut ausführen.

Ergebnis

Der Datenadapter-Konfigurations-Assistent führt Sie durch den gesamten Prozess der Erstellung eines Datenadapters (und ggf. einer Datenverbindung). Der Assistent führt die folgenden Schritte aus:

Erstellen des Adapters
Falls erforderlich, Erstellen einer Datenverbindung und Einrichten des Adapters für die Verwendung der Verbindung
Erstellen der SQL‑Anweisung oder der gespeicherte Prozeduren zum Lesen und Schreiben von Daten
Erstellen und Konfigurieren der Parameter für die SQL‑Anweisungen oder gespeicherten Prozeduren, sodass die Befehle die korrekten Daten lesen und schreiben
Zuordnen von Tabellen- und Spaltennamen zwischen Datenbank und Dataset

Konfigurieren der Befehlsobjekte

Der Hauptteil der Arbeit des Assistenten besteht darin, die vier Datenbefehlsobjekte zu konfigurieren, mit denen der Adapter Daten in die und aus der Datenbank übergibt. Dazu gehören das SelectCommand-Objekt und optional die Objekte UpdateCommand, InsertCommand und DeleteCommand. Jedes dieser Objekte enthält entweder eine SQL‑Anweisung oder den Namen einer gespeicherten Prozedur, mit der Daten gelesen und geschrieben werden. Die Eigenschaften dieser Befehle (besonders die CommandText-Eigenschaft) werden gemäß den von Ihnen im Assistenten gewählten Einstellungen festgelegt.

Der Assistent ermöglicht es Ihnen, für die Befehle entweder SQL‑Anweisungen oder gespeicherte Prozeduren zu verwenden. Sie haben folgende Möglichkeiten:

SQL‑Anweisungen verwenden. Sie können eine Select-Anweisung angeben, und der Assistent erstellt entsprechende Update-, Insert- und Delete-Anweisungen (sofern Sie deren Erstellung angegeben haben) gemäß den Angaben für die Select-Anweisung. Die Update- und die Insert-Anweisung enthalten Parameter für die Übergabe neuer Werte. Die Update-, Insert- und Delete-Anweisung enthalten Parameter in einer WHERE-Klausel, mit denen der richtige Datensatz in der Datenbank lokalisiert wird.
Neue gespeicherte Prozeduren erstellen. Diese Option entspricht der Verwendung einer Anweisung, allerdings generiert hier der Assistent statt der Anweisungen gespeicherte Prozeduren. Da gespeicherte Prozeduren schneller ausgeführt werden können als SQL‑Anweisungen, empfiehlt es sich u. U., aus Gründen der Leistungssteigerung diese Option zu wählen. Bei dieser Option generiert der Assistent gespeicherte Prozeduren für alle vier Befehle (wieder gemäß Ihren Angaben im Select-Befehl). Sie können festlegen, dass die neuen gespeicherten Prozeduren in die Datenbank geschrieben werden. Andernfalls können Sie das SQL‑Skript, das der Assistent zum Erstellen der gespeicherten Prozeduren verwenden würde, dennoch erfassen und später ausführen.
Vorhandene gespeicherte Prozeduren verwenden. Bei dieser Option wählen Sie für jeden der vier Befehle gespeicherte Prozeduren aus. Der Assistent zeigt die Namen und die Details der gespeicherten Prozeduren an, die in der Datenbank gefunden wurden. Diese Option ist nützlich, wenn bereits gespeicherte Prozeduren vorhanden sind, die die vier Datenbankoperationen ausführen.

Erweiterte Optionen im Assistenten

Der Assistent bietet erweiterte Optionen an, mit denen Sie steuern können, wie die Befehle Update, Insert und Delete für den Datenadapter erstellt werden. Sie können das Dialogfeld Erweiterte SQL‑Generierungsoptionen öffnen, indem Sie im Bereich SQL‑Anweisungen generieren des Assistenten auf Erweiterte Optionen klicken.

In diesem Dialogfeld können Sie folgende Optionen wählen:

Insert-, Update- und Delete-Anweisungen generieren. Gibt an, dass der Datenadapter basierend auf der Select-Anweisung zusätzliche Anweisungen oder gespeicherte Prozeduren generiert, um Daten in die Datenbank zu schreiben. Wenn der Adapter nur zum Lesen und nicht zum Aktualisieren von Daten verwendet wird, kann das Deaktivieren dieses Kontrollkästchens zu effizienterem Code führen.
Vollständige Parallelität verwenden. Gibt an, dass der Assistent Logik einfügen soll, mit der getestet wird, ob ein Datensatz sich seit dem Einlesen aus der Datenbank geändert hat.
DataSet aktualisieren. Gibt an, ob der Assistent Code generieren soll, der einen Datensatz nach dessen Aktualisierung erneut aus der Datenbank einliest. Dadurch erhalten Sie eine aktualisierte Ansicht eines Datensatzes, die auch Werte enthält, die durch die Datenbank eingefügt werden, z. B. Standardwerte und automatisch inkrementierte Werte.

Weitere Informationen finden Sie unter Dialogfeld "Erweiterte SQL-Generierungsoptionen".

Nächste Schritte

Nach der Beendigung des Assistenten wird dem Formular der Datenadapter (und optional die Datenverbindung) hinzugefügt. Danach können Sie eine Reihe von weiteren Schritten durchführen. Einige Schritte werden fast immer ausgeführt, während andere optional sind.

Schritte, die u. U. erforderlich sind

Die folgenden Schritte werden häufig nach der Beendigung des Datenadapter-Konfigurations-Assistenten durchgeführt:

Weitere Datenadapter hinzufügen. Der Assistent erstellt genau einen Datenadapter. Jeder Datenadapter liest und schreibt typischerweise Daten in eine einzige Datentabelle. Wenn Sie vorhaben, ein Dataset mit mehreren Tabellen zu verwenden, sollten Sie weitere Datenadapter in das Formular oder die Komponente einfügen. Jedes Mal, wenn Sie einen Datenadapter aus der Toolbox hinzufügen, führen Sie den Assistenten erneut aus, damit der betreffende Datenadapter konfiguriert wird.
Die Tabellenzuordnungen eines Datenadapters ändern. Standardmäßig geht der Adapter davon aus, dass er Daten in Tabellen und Spalten mit identischen Namen liest und schreibt. Sie möchten aber vielleicht den Adapter verwenden, um Daten aus einer Datenbank mit einem bestimmten Namen in ein Dataset mit anderen Namen einzulesen. Oder es werden mehr Spalten aus der Datenbank eingelesen, als in dem Dataset benötigt werden. Informationen zum Ändern dieser Einstellungen finden Sie unter Gewusst wie: Zuordnen von Datenquellspalten zu DataSet-Datentabellenspalten.
Eine Vorschau auf die Daten anzeigen, die der Adapter in das Dataset lädt. Weitere Informationen finden Sie unter Gewusst wie: Vorschau von Datenadapterergebnissen.
Logik zum Einlesen von Daten in das Dataset hinzufügen. Wenn mithilfe des Datenadapters ein Dataset gefüllt werden soll, rufen Sie die Fill-Methode des Adapters auf. Dadurch wird der Befehl im SelectCommand-Objekt des Adapters ausgeführt, und die Ergebnisse werden in das Dataset geladen. Weitere Informationen finden Sie unter Auffüllen eines 'DataSet' durch einen 'DataAdapter' (ADO.NET).