Freigeben über


Dialogfeld "DataSet generieren"

Aktualisiert: November 2007

In diesem Dialogfeld finden Sie Optionen für das Generieren einer typisierten Dataset-Klasse aus Daten, die von einem oder mehreren Datenadaptern bereitgestellt werden. Verwenden Sie dieses Dialogfeld zu folgenden Zwecken:

  • Erstellen einer neuen typisierten Klasse.

  • Hinzufügen von Tabellen zu einer vorhandenen Dataset-Klasse oder Ändern der Spaltendefinitionen einer Tabelle, die bereits im Dataset vorhanden ist.

    Hinweis:

    Wenn Sie eine Tabelle aus einer DataSet-Klasse entfernen möchten, bearbeiten Sie das Schema des Datasets mit dem DataSet-Designer. Weitere Informationen finden Sie unter DataSet-Designer.

Die mit diesem Dialogfeld generierte typisierte DataSet-Klasse wird im Projekt in zwei Dateien gespeichert: einer XSD-Datei und einer dazugehörigen Klassendatei (z. B. .vb), die die Schemainformationen enthält.

Das Dialogfeld DataSet generieren kann angezeigt werden, indem Sie einen oder mehrere Datenadapter in einem Formular oder einer Komponente auswählen und anschließend im Kontextmenü auf den Befehl DataSet generieren klicken.

Elementliste der Benutzeroberfläche

  • DataSet auswählen
    Geben Sie an, ob eine neue Dataset-Klasse generiert oder eine bereits vorhandene erneut erstellt werden soll. Wählen Sie eine der folgenden Optionen:

    • Vorhanden   Mit dieser Option geben Sie an, dass Sie einer vorhandenen Dataset-Klasse eine Tabelle (erneut) hinzufügen möchten. Wählen Sie in der Liste das zu aktualisierende Dataset aus.

    • Neu   Mithilfe dieser Option können Sie einen Namen für eine neue DataSet-Klasse angeben.

  • Wählen Sie die Tabelle(n) aus, die zum DataSet hinzugefügt werden soll(en)
    Hier geben Sie an, welche Tabelle(n) Sie dem Dataset hinzufügen möchten. Die Liste der Tabellen wird aus den Datenadaptern in dem Formular oder der Komponente abgeleitet. (Im Normalfall greift jeder Datenadapter auf eine einzige Tabelle zu.) Die Namen der zu generierenden Tabellen werden aus der TableMappings-Eigenschaft des Adapters abgeleitet. Wenn keine Tabellenzuordnungen angegeben wurden, wird der Tabellenname aus der Datenquelle übergeben.

    Aktivieren Sie die Namen der Tabellen, die dem Dataset (wieder) hinzugefügt werden sollen.

    Hinweis:

    Wird der Name einer bereits im Dataset befindlichen Tabelle deaktiviert, wird er dennoch nicht aus dem Dataset entfernt. Das Deaktivieren des Namens bedeutet lediglich, dass diese Tabelle nicht erneut dem Dataset hinzugefügt wird.

    Wenn Sie ein vorhandenes Dataset durch Hinzufügen von Tabellen aktualisieren, geschieht Folgendes:

    • Befand sich die Tabelle vorher nicht im Dataset, wird ihre Definition mit dem Dataset zusammengeführt. Alle Tabellen, Beziehungen und anderen Strukturen, die bereits im Dataset vorhanden sind, bleiben intakt.

    • Befand sich die Tabelle vorher im Dataset, überschreibt die neue Tabellendefinition die vorhandene. Wenn die neue Tabellendefinition beispielsweise weniger Spalten enthält, werden die entsprechenden Spalten aus dem Dataset entfernt.

  • DataSet zu Designer hinzufügen
    Gibt an, ob dem aktuellen Formular eine Instanz dieses Datasets hinzugefügt werden soll. In folgenden Fällen wird von der Erstellung einer Instanz abgeraten:

    • Sie möchten das Dataset nicht auf dem aktuellen Formular verwenden (sondern Sie verwenden es in einer anderen Komponente).

    • Sie generieren die Dataset-Klasse nur, um eine Schemadatei zu erstellen.

    Für die Instanz des Datasets wird der Name des Datasets sowie eine laufende Nummer verwendet. Wenn das Dataset beispielsweise den Namen Dataset1 hat, ist der Name der ersten Instanz Dataset11, der Name der zweiten Instanz Dataset12 usw. Sie können den Namen einer Instanz im Formular oder in der Komponente im Eigenschaftenfenster ändern.

Siehe auch

Weitere Ressourcen

Erste Schritte mit dem Datenzugriff

Herstellen von Datenverbindungen in Visual Studio

Vorbereiten der Anwendung auf den Empfang von Daten

Abrufen von Daten für die Anwendung

Anzeigen von Daten in Formularen in Windows-Anwendungen

Bearbeiten von Daten in der Anwendung

Überprüfen von Daten

Speichern von Daten