DataGrid.TableStyles Property


Gets the collection of DataGridTableStyle objects for the grid.

Namespace:   System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

public GridTableStylesCollection TableStyles { get; }

Property Value

Type: System.Windows.Forms.GridTableStylesCollection

A GridTableStylesCollection that represents the collection of DataGridTableStyle objects.

Use the GridTableStylesCollection retrieved through the TableStyles property to create customized views of each table displayed by the System.Windows.Forms.DataGrid control.

By default, the collection returned by TableStyles property does not contain any DataGridTableStyle objects. To create a set of customized views:

  1. Create a DataGridTableStyle.

  2. Set the MappingName of the grid table object to the TableName of the DataTable.

  3. Add DataGridColumnStyle objects, one for each grid column you want to show, to the GridColumnStylesCollection returned by the GridColumnStyles property.

  4. Set the MappingName of each DataGridColumnStyle to the ColumnName of a DataColumn.

  5. Add the DataGridTableStyle object to the collection returned by TableStyles property.


Always create DataGridColumnStyle objects and add them to the GridColumnStylesCollection before adding DataGridTableStyle objects to the GridTableStylesCollection. When you add an empty DataGridTableStyle with a valid MappingName value to the collection, DataGridColumnStyle objects are automatically generated for you. Consequently, an exception will be thrown if you try to add new DataGridColumnStyle objects with duplicate MappingName values to the GridColumnStylesCollection.

The following code example creates one DataGridTableStyle for each DataTable found in a DataSet, and sets the MappingName of the DataGridTableStyle to the TableName of the DataTable. The DataGridTableStyle is then added to the GridTableStylesCollection returned by the TableStyles property. The example also prints the MappingName of each DataGridColumnStyle in the GridColumnStylesCollection returned by the GridColumnStyles property of each DataGridTableStyle in the GridTableStylesCollection.

private void AddTables(DataGrid myDataGrid, DataSet myDataSet){
   foreach(DataTable t in myDataSet.Tables){
      DataGridTableStyle myGridTableStyle = new 
      myGridTableStyle.MappingName = t.TableName;

      /* Note that DataGridColumnStyle objects will
      be created automatically for the first DataGridTableStyle
      when you add it to the GridTableStylesCollection.*/
private void PrintGridStyleInfo(DataGrid myDataGrid){
   /* Print the MappingName of each DataGridTableStyle,
   and the MappingName of each DataGridColumnStyle. */
   foreach(DataGridTableStyle myGridStyle in 
   foreach(DataGridColumnStyle myColumnStyle in 

.NET Framework
Available since 1.1
Return to top