Dialogfeld "Datenadaptervorschau"

Artikel
08/10/2011

In diesem Dialogfeld sehen Sie, wie Daten in ein Dataset geladen werden, wenn das SelectCommand-Objekt eines Adapters aufgerufen wird. Mithilfe dieses Dialogfelds können Sie testen, ob der Adapter die erwarteten Daten zurückgibt, die Tabellenzuordnungen korrekt funktionieren und beim Einlesen von Daten in das Dataset keine Fehler auftreten. Außerdem können Sie in diesem Dialogfeld die Auswirkungen der Übergabe unterschiedlicher Parameterwerte an den Adapter testen.

Tipp

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 Ändern von Daten zwischen der Anwendung und einer Datenbank vereinfachen. Weitere Informationen zum Verwenden von TableAdapter finden Sie unter Übersicht über TableAdapters.

Eine Vorschau auf einen Datenadapter ist besonders hilfreich, wenn Sie den Datenadapter zum Füllen eines Datasets verwenden möchten, das nicht direkt aus dem Adapter generiert wurde.

Das Dialogfeld wird angezeigt, wenn Sie eine der folgenden Aktionen ausführen:

Klicken Sie im Menü Daten auf Datenvorschau. Dieses Menü ist nur verfügbar, wenn einem Formular oder einer Komponente ein Datenadapter hinzugefügt wurde.
Klicken Sie am unteren Rand des Eigenschaftenfensters auf den Link Datenvorschau. Dieser Link ist verfügbar, wenn Eigenschaften für einen Datenadapter angezeigt werden.

Liste der Benutzeroberflächenelemente

Datenadapter
Eine Liste der Datenadapter, die in dem aktuellen Formular oder der Komponente verfügbar sind. Wählen Sie den anzuzeigenden Adapter aus. Wenn Sie überprüfen möchten, welche Auswirkungen die Verwendung aller Datenadapter hat, klicken Sie auf <Alle Datenadapter>.
DataSet füllen
Der entsprechende Befehl wird ausgeführt, und die Daten werden im Feld Ergebnisse angezeigt.

Wenn ein Fehler auftritt, während der Datenadapter Daten in das Dataset lädt, wird der Fehler in einem Meldungsfeld angezeigt. Folgende Fehler sind möglich:
- Datentypenkonflikte.
- Syntaxfehler in der SQL‑Anweisung oder gespeicherten Prozedur, die ausgeführt wird.
- Fehler bei Tabellenzuordnungen. Wenn z. B. die MissingMappingAction-Eigenschaft oder die MissingSchemaAction-Eigenschaft eines Adapters den Wert Error aufweisen und die Tabellenzuordnungen nicht vollständig beschreiben, wie mit nicht übereinstimmenden Spaltennamen in der Datenbank und im Dataset verfahren werden soll, wird ein Fehler ausgelöst.
- Verbindungsprobleme.
Parameter
Hier werden die Parameter angezeigt, die für die SQL-SELECT-Anweisung oder die gespeicherte Prozedur benötigt werden, auf die im SelectCommand-Objekt des bzw. der angegebenen Datenadapter(s) verwiesen wird. Falls keine Parameter erforderlich sind, ist das Datenblatt leer.

Jeder Parameter wird als Zeile im Datenblatt mit dem zugehörigen Parameternamen und dem Datentyp angezeigt. Geben Sie einen Wert für jeden Parameter im Feld Wert ein. Falls der Parameter dies zulässt, können Sie auch in der Dropdownliste des Felds Wert den Eintrag <Standard> oder <Null> auswählen.
Ziel-Dataset
Gibt das Dataset an, in das der Befehl für die Vorschau Daten laden soll. Sie können eines der im Projekt verfügbaren Datasets auswählen oder ein nicht typisiertes Dataset (ein Dataset ohne Schema) eingeben.
Datentabellen
Eine Liste der Datentabellen im Dataset. Wählen Sie einen Tabellennamen aus, um die Datensätze anzuzeigen, die durch den Datenadapter geladen werden. (In der Regel füllt jeder Datenadapter eine Tabelle im Dataset.) Wurden mehrere Tabellen gefüllt, können Sie in dieser Liste eine Tabelle auswählen, um die Ergebnisse für diese Tabelle abzurufen.
Ergebnisse
Hier werden die Daten im Dataset angezeigt. Sie sehen hier, wie die Daten nach der Rückgabe aus der Datenbank und nach dem Anwenden etwaiger Tabellenzuordnungen angezeigt werden. Die Daten in diesem Datenblatt sind schreibgeschützt.

Umfasst das Ergebnis mehrere Tabellen, können Sie den Inhalt einer bestimmten Tabelle anzeigen, indem Sie den Tabellennamen in der Liste Datentabellen auswählen.
Ergebnisse löschen
Entfernt alle Daten aus der ausgewählten Tabelle. Wenn Sie alle Tabellen löschen möchten, wählen Sie jede einzelne Tabelle in der Liste Datentabellen aus und klicken jeweils auf Ergebnisse löschen.