Gewusst wie: Manuelles Erstellen und Konfigurieren von Datenadaptern

Artikel
09/02/2008

Aktualisiert: November 2007

Sie können Datenadapter erstellen, ohne einen Assistenten zu verwenden. Unabhängig davon, wie Sie den Adapter erstellt haben, können Sie dessen Konfiguration jederzeit ändern.

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 zentrale Komponente von .NET Framework-Datenanbieter (ADO.NET) darstellen, sind TableAdapters vom Designer generierte Komponenten, die das Verschieben von Daten zwischen der Anwendung und einer Datenbank vereinfachen. Weitere Informationen zum Verwenden von TableAdapters 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 zentrale Komponente von .NET Framework-Datenanbieter (ADO.NET) darstellen, sind TableAdapters vom Designer generierte Komponenten, die das Verschieben von Daten zwischen der Anwendung und einer Datenbank vereinfachen. Weitere Informationen zum Verwenden von TableAdapters finden Sie unter Übersicht über TableAdapters.

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

Standardmäßig ist in Visual Studio die Entwurfszeitunterstützung für Datenadapter deaktiviert. Wenn Sie die Entwurfszeitunterstützung für Datenadapter aktivieren möchten, fügen Sie der Toolbox Datenadapter hinzu, wie in der ersten nachfolgenden Prozedur beschrieben.

So fügen Sie der Tollbox Datenadapter, Verbindungen und Befehle hinzu

Klicken Sie mit der rechten Maustaste auf die Toolbox, und wählen Sie Elemente auswählen aus.
Wählen Sie dann im Dialogfeld Toolboxelemente auswählen auf der Registerkarte .NET Framework-Komponenten die hinzuzufügenden Elemente aus. Um beispielsweise .NET Framework-Datenanbieter für SQL Server zu verwenden, wählen Sie SqlDataAdapter, SqlConnection und SqlCommand aus.
Klicken Sie auf OK, um der Toolbox die ausgewählten Elemente hinzuzufügen.

So erstellen Sie einen Datenadapter manuell

Stellen Sie sicher, dass dem verwendeten Formular oder der verwendeten Komponente ein Verbindungsobjekt zur Verfügung steht. Ausführliche Informationen zum Hinzufügen einer eigenständigen Verbindung finden Sie unter Herstellen der Verbindung (ADO.NET).
Ziehen Sie von der Registerkarte Daten der Toolbox ein Objekt OleDbDataAdapter, SqlDataAdapter, OdbcDataAdapter oder OracleDataAdapter auf die Entwurfsoberfläche.

Der Designer fügt dem Formular oder der Komponente eine Instanz des Adapters hinzu und startet den Datenadapter-Konfigurations-Assistenten.
Schließen Sie den Assistenten.

So konfigurieren Sie einen Datenadapter manuell

Wählen Sie den Adapter aus, und konfigurieren Sie anschließend im Eigenschaftenfenster die zum Lesen und Aktualisieren von Daten verwendeten Befehle. Sie müssen das SelectCommand-Objekt konfigurieren. Wenn der Adapter zum Aktualisieren einer Datenquelle verwendet werden soll, müssen Sie außerdem die Objekte UpdateCommand, DeleteCommand und InsertCommand konfigurieren.

Legen Sie für jedes Befehlsobjekt die folgenden Eigenschaften fest.

Eigenschaft	Beschreibung
ActiveConnection	Legen Sie die Eigenschaft so fest, dass sie auf ein Verbindungsobjekt verweist. Sie können im Eigenschaftenfenster aus der ActiveConnection-Eigenschaft ein Verbindungsobjekt erstellen. Im Allgemeinen verweisen alle Befehlsobjekte auf dasselbe Verbindungsobjekt. Sie können für jeden Befehl jedoch auch eine andere Verbindung verwenden, wenn Ihre Anwendung dies erfordert.
CommandText	Entweder der Text einer SQL-Anweisung oder der Name einer gespeicherten Prozedur. Bei manchen Anbietern können Sie mehrere Anweisungen oder Namen von gespeicherten Prozeduren in die CommandText-Eigenschaft einbinden; die Anweisungen oder gespeicherten Prozeduren müssen dabei jedoch durch ein Semikolon (;) voneinander getrennt sein. Die Anweisungen oder Prozeduren werden sequenziell ausgeführt. Dies ist für solche Situationen nützlich, in denen eine SELECT-Anweisung nach einer UPDATE-Anweisung oder einer INSERT-Anweisung ausgeführt wird, um aktualisierte Datensätze und automatisch generierte Werte (z. B. Standardwerte oder Werte, die automatisch inkrementell erhöht werden) zu erhalten.
CommandType	Ein Wert, der angibt, wie der Wert der CommandText-Eigenschaft interpretiert werden soll: Text - der Befehl ist eine SQL-Anweisung. StoredProcedure - der Befehl ist ein Verweis auf eine gespeicherte Prozedur. TableDirect - der Text ist kein Befehl, sondern der Name einer Tabelle.
Parameter	Eine Auflistung von Objekten vom Typ Parameter, die Sie zum Übergeben von Werten an den Befehl konfigurieren. Im SelectCommand-Objekt kann nur dann eine Parameterauflistung erstellt werden, wenn der Befehl einen Platzhalter für Parameter enthält. Für die Objekte UpdateCommand, InsertCommand und DeleteCommand sind immer Parameter erforderlich. Ausführliche Informationen finden Sie unter Gewusst wie: Konfigurieren von Parametern für Datenadapter.

Ändern Sie die Zuordnungen, wenn die Spaltennamen in der Datenquelle und im Dataset nicht identisch sein sollen. Der Standardwert für die MissingMappingAction-Eigenschaft, Passthrough, generiert in der Datenquelle und im Dataset automatisch dieselben Namen. Weitere Informationen finden Sie unter Gewusst wie: Zuordnen von Datenquellspalten zu DataSet-Datentabellenspalten.

Wählen Sie im Menü Daten die Option DataSet generieren.

Tipp:
Wenn das Menü Daten nicht angezeigt wird, klicken Sie auf eine beliebige Stelle im Formular- oder Komponenten-Designer. Das Menü wird nur angezeigt, wenn der Fokus auf dem Designer liegt.

Zeigen Sie eine Vorschau der Ergebnisse an, wenn Sie sehen möchten, wie der Datenadapter ein Dataset füllt. Weitere Informationen finden Sie unter Gewusst wie: Vorschau von Datenadapterergebnissen.