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

  • Artikel

Aktualisiert: November 2007

Hinweis:

Obwohl das DataGrid-Steuerelement durch das DataGridView-Steuerelement ersetzt und funktionell erweitert wird, 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 DataGrid-Steuerelement von Windows Forms in Tabellen und Spalten anzeigen, indem Sie DataGridTableStyle-Objekte erstellen und diese dem GridTableStylesCollection-Objekt hinzufügen, auf das Sie mithilfe der TableStyles-Eigenschaft des DataGrid-Steuerelements zugreifen können. Jedes Tabellenformat zeigt den Inhalt einer beliebigen in der MappingName-Eigenschaft des DataGridTableStyle-Objekts festgelegten Datentabelle an. Standardmäßig zeigt ein Tabellenformat, in dem keine Spaltenformate festgelegt sind, alle Spalten der Datentabelle an. Sie können die angezeigten Spalten der Tabelle beschränken, indem Sie dem GridColumnStylesCollection-Objekt, auf das mithilfe der GridColumnsStyles-Eigenschaft eines jeden DataGridTablesStyle-Objekts zugegriffen werden kann, DataGridColumnStyle-Objekte hinzufügen.

So fügen Sie programmgesteuert eine Tabelle und eine Spalte hinzu

  1. Um in der Tabelle Daten anzeigen zu können, müssen Sie das DataGrid-Steuerelement zunächst an ein Dataset binden. Weitere Informationen finden Sie unter Gewusst wie: Binden des DataGrid-Steuerelements in Windows Forms an eine Datenquelle.

    Vorsicht:

    Wenn Sie Spaltenformate programmgesteuert festlegen, erstellen Sie immer DataGridColumnStyle-Objekte und fügen sie dem GridColumnStylesCollection-Objekt hinzu, bevor Sie dem GridTableStylesCollection-Objekt DataGridTableStyle-Objekte hinzufügen. Wenn Sie der Auflistung ein leeres DataGridTableStyle-Objekt hinzufügen, werden DataGridColumnStyle-Objekte automatisch erstellt. In Folge dessen wird eine Ausnahme ausgelöst, wenn Sie versuchen, dem GridColumnStylesCollection-Objekt neue DataGridColumnStyle-Objekte mit doppelten MappingName-Werten hinzuzufügen.

  2. Deklarieren Sie ein neues Tabellenformat, und legen Sie seinen 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 ein neues Spaltenformat, und legen Sie seinen Zuordnungsnamen und weitere 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 zum Hinzufügen der Spalte zum Tabellenformat die Add-Methode des GridColumnStylesCollection-Objekts auf

    ts1.GridColumnStyles.Add(myDataCol)

    ts1.GridColumnStyles.Add(myDataCol);

    ts1->GridColumnStyles->Add(myDataCol);

  5. Rufen Sie zum Hinzufügen der Spalte zum Datenraster die Add-Methode des GridTableStylesCollection-Objekts auf

    DataGrid1.TableStyles.Add(ts1)

    dataGrid1.TableStyles.Add(ts1);

    dataGrid1->TableStyles->Add(ts1);

Siehe auch

Aufgaben

Gewusst wie: Löschen oder Ausblenden von Spalten aus dem DataGrid-Steuerelement in Windows Forms

Weitere Ressourcen

DataGrid-Steuerelement (Windows Forms)