Freigeben über

Vorgehensweise: Hinzufügen von Tabellen und Spalten zum DataGrid-Steuerelement in Windows Forms

  • Artikel

Hinweis

Obwohl das DataGridView-Steuerelement das DataGrid-Steuerelement ersetzt und funktionell erweitert, wird das DataGrid-Steuerelement sowohl aus Gründen der Abwärtskompatibilität als auch, falls gewünscht, für die zukünftige Verwendung beibehalten. Weitere Informationen finden Sie unter Unterschiede zwischen dem DataGridView-Steuerelement und dem DataGrid-Steuerelement in Windows Forms.

Sie können Daten im Windows Forms-Steuerelement DataGrid in Tabellen und Spalten anzeigen, indem Sie DataGridTableStyle-Objekte erstellen und sie zum GridTableStylesCollection-Objekt hinzufügen, auf das über die TableStyles-Eigenschaft des DataGrid-Steuerelements zugegriffen wird. Jeder Tabellenstil zeigt den Inhalt der Datentabelle an, die in der MappingName-Eigenschaft des DataGridTableStyle-Objekts angegeben ist. Standardmäßig werden bei einer Tabelle, für die keine Spaltenformate angegeben sind, alle Spalten innerhalb dieser Datentabelle angezeigt. Sie können einschränken, welche Spalten der Tabelle angezeigt werden, indem Sie DataGridColumnStyle-Objekte zum GridColumnStylesCollection-Objekt hinzufügen, auf das über die GridColumnStyles-Eigenschaft jedes DataGridTableStyle-Objekts zugegriffen wird.

So fügen Sie einem DataGrid-Steuerelement programmgesteuert eine Tabelle und Spalte hinzu

  1. Um Daten in der Tabelle anzuzeigen, müssen Sie zunächst das DataGrid-Steuerelement an ein Dataset binden. Weitere Informationen finden Sie unter Vorgehensweise: Binden des DataGrid-Steuerelements in Windows Forms an eine Datenquelle.

    Achtung

    Wenn Sie Spaltenstile programmgesteuert festlegen, erstellen Sie stets DataGridColumnStyle-Objekte, und fügen Sie sie dem GridColumnStylesCollection-Objekt hinzu, ehe Sie DataGridTableStyle-Objekte dem GridTableStylesCollection-Objekt hinzufügen. Wenn Sie ein leeres DataGridTableStyle-Objekt zur Sammlung hinzufügen, werden automatisch DataGridColumnStyle-Objekte für Sie generiert. Daher wird eine Ausnahme ausgelöst, wenn Sie versuchen, neue DataGridColumnStyle-Objekte mit duplizierten MappingName-Werten zum GridColumnStylesCollection-Objekt hinzuzufügen.

  2. Deklarieren Sie einen neuen Tabellenstil, und legen Sie dessen Zuordnungsnamen fest.

    Dim ts1 As New DataGridTableStyle()
ts1.MappingName = "Customers"

    DataGridTableStyle ts1 = new DataGridTableStyle();
ts1.MappingName = "Customers";

    DataGridTableStyle* ts1 = new DataGridTableStyle();
ts1->MappingName = S"Customers";

  3. Deklarieren Sie einen neuen Spaltenstil, und legen Sie dessen Zuordnungsnamen und andere Eigenschaften fest.

    Dim myDataCol As New DataGridBoolColumn()
myDataCol.HeaderText = "My New Column"
myDataCol.MappingName = "Current"

    DataGridBoolColumn myDataCol = new DataGridBoolColumn();
myDataCol.HeaderText = "My New Column";
myDataCol.MappingName = "Current";

    DataGridBoolColumn^ myDataCol = gcnew DataGridBoolColumn();
myDataCol->HeaderText = "My New Column";
myDataCol->MappingName = "Current";

  4. Rufen Sie die Add-Methode des GridColumnStylesCollection-Objekts auf, um die Spalte zum Tabellenstil hinzuzufügen.

    ts1.GridColumnStyles.Add(myDataCol)

    ts1.GridColumnStyles.Add(myDataCol);

    ts1->GridColumnStyles->Add(myDataCol);

  5. Rufen Sie die Add-Methode des GridTableStylesCollection-Objekts auf, um den Tabellenstil zum Datenraster hinzuzufügen.

    DataGrid1.TableStyles.Add(ts1)

    dataGrid1.TableStyles.Add(ts1);

    dataGrid1->TableStyles->Add(ts1);

Weitere Informationen