Freigeben über


Gewusst wie: Zuordnen von Datenquellspalten zu DataSet-Datentabellenspalten

Aktualisiert: November 2007

Wenn Sie eine Zuordnung in einem Datenadapter erstellen, können Sie Entsprechungen zwischen den Spalten in der Datenquelle und den Spalten in einer Dataset-Tabelle einrichten. Weitere Informationen finden Sie unter Tabellenzuordnung in Datenadaptern.

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 TableAdapter finden Sie unter Übersicht über TableAdapters.

So ordnen Sie einer Dataset-Tabelle Datenquellspalten zu

  1. Erstellen Sie einen Datenadapter. Weitere Informationen finden Sie unter Erstellen von Datenadaptern.

  2. Wählen Sie den Datenadapter in einem Formular- oder Komponenten-Designer aus, und öffnen Sie das Eigenschaftenfenster.

  3. Klicken Sie neben der TableMappings-Eigenschaft auf die Schaltfläche mit den Auslassungszeichen (...). Das Dialogfeld Tabellenzuordnungen wird geöffnet.

  4. Wenn Sie einem bestehenden Dataset Spaltennamen aus der Datenquelle zuordnen möchten, aktivieren Sie Ein DataSet zum Vorschlagen von Tabellen- und Spaltennamen verwenden, und wählen Sie anschließend ein Dataset aus der Liste Dataset aus.

    Die in diesem Dataset verfügbaren Tabellen werden in der Liste Dataset-Tabelle aufgeführt, und die Spalten der ersten Tabelle im Dataset werden auf der rechten Seite des Datenblatts Spaltenzuordnungen eingetragen.

    Hinweis:

    Durch die Auswahl eines DataSets kann das Dialogfeld Zuordnungen Standardwerte für die zuzuordnenden DataSet-Spalten festlegen. Das Dataset ist nicht Teil der Informationen, die für die Zuordnungen im Adapter gepflegt werden. Außerdem können Sie dieselben Zuordnungen für mehrere Datasets verwenden.

  5. Wählen Sie unter Quelltabelle die Tabelle in der Datenquelle aus, für die eine Zuordnung erfolgen soll. Wenn nur eine Tabelle im Dataset enthalten ist, lautet der Standardwert Tabelle.

  6. Wählen Sie unter Dataset-Tabelle die Tabelle im Dataset aus, für die eine Zuordnung erfolgen soll. Wenn Sie in Schritt 3 ein zuzuordnendes Dataset ausgewählt haben, ist bereits ein Name enthalten. (Standardmäßig wird die erste Tabelle im Dataset als Tabelle bezeichnet.)

    Die Werte in den Listen Quellspalten und Dataset-Spalten werden auf der Grundlage Ihrer Auswahl (oder der Standardwerte) eingetragen. Das Raster gibt an, wie die Zuordnung ausgeführt wird: Alle Spalten auf der linken Seite werden den entsprechenden Spalten auf der rechten Seite zugeordnet.

  7. Passen Sie die Zuordnungen nach Bedarf an. Dies kann Folgendes einschließen:

    • Auswahl verschiedener Spalten in den Quell- oder den Dataset-Spaltenlisten, um die Spaltenzuordnungen zu ändern.

    • Entfernen von Spalten aus der Zuordnung. Dies könnte der Fall sein, wenn der Adapter mehr Spalten aus der Datenquelle zurückgibt, als Sie benötigen.

    • Hinzufügen von Spalten. Dies könnte der Fall sein, wenn Sie wissen, dass zur Laufzeit Spalten vorhanden sind, die während der Entwurfszeit nicht bestehen, wenn Sie eine Spalte löschen und diese nun wiederherstellen möchten oder wenn Sie die Abfrage des Adapters optimiert haben und die Zuordnungen daraufhin anpassen müssen.

  8. Klicken Sie auf OK, wenn Sie die Zuordnungen angepasst haben.

  9. Wenn Sie die Behandlung möglicher Fehlerbedingungen festlegen möchten, wählen Sie im Eigenschaftenfenster Optionen für die MissingMappingAction-Eigenschaft und die MissingSchemaAction-Eigenschaft aus. In der folgenden Tabelle sind einige allgemeine Einstellungen und deren Wirkung aufgeführt.

    MissingMappingAction

    MissingSchemaAction

    Wirkung

    Passthrough

    Add oder AddWithKey

    Wenn eine Spalte in der Quelle, aber nicht im Schema vorhanden ist und es keine Zuordnung dafür gibt, wird die Spalte beim Füllen des Datasets erstellt. Dies ist die Standardeinstellung. Sie ist sinnvoll, wenn Sie alle in der Quelle verfügbaren Spalten in das Dataset kopieren möchten.

    Ignore

    Ignore

    Wenn die Spalte nicht im Schema des Datasets definiert ist oder wenn es keine Zuordnung dafür gibt, werden keine Informationen von der Quelle in das Dataset kopiert. Diese Einstellung ist sinnvoll, wenn der Adapter mehr Informationen zurückgibt, als Sie im Dataset benötigen.

    Error

    Error

    Ein Laufzeitfehler wird ausgelöst, wenn der Adapter einer Dataset-Spalte keine Quellspalte zuordnen kann, weil die Zuordnung fehlt oder weil die Spalte nicht im Schema des Datasets enthalten ist. Diese Einstellung ist sinnvoll, wenn Sie mit einem streng definierten Schema arbeiten und sicher sein möchten, dass alle Abweichungen vom Schema gekennzeichnet werden.

Siehe auch

Konzepte

Einführung in Datenadapter

Tabellenzuordnung in Datenadaptern

Auffüllen eines 'DataSet' durch einen 'DataAdapter' (ADO.NET)

Neue Datenfeatures

Erstellen von Datenanwendungen mit Visual Studio

Weitere Ressourcen

'DataAdapters' und 'DataReaders' (ADO.NET)

Erstellen von Datenadaptern

Exemplarische Vorgehensweisen zur Arbeit mit Daten

ADO.NET