DataGrid.TableStyles Propiedad

Definición

Obtiene la colección de objetos DataGridTableStyle de la cuadrícula.Gets the collection of DataGridTableStyle objects for the grid.

public:
 property System::Windows::Forms::GridTableStylesCollection ^ TableStyles { System::Windows::Forms::GridTableStylesCollection ^ get(); };
public System.Windows.Forms.GridTableStylesCollection TableStyles { get; }
member this.TableStyles : System.Windows.Forms.GridTableStylesCollection
Public ReadOnly Property TableStyles As GridTableStylesCollection

Valor de propiedad

GridTableStylesCollection

GridTableStylesCollection que representa la colección de objetos DataGridTableStyle.A GridTableStylesCollection that represents the collection of DataGridTableStyle objects.

Ejemplos

En el ejemplo de código siguiente se crea una DataGridTableStyle para cada DataTable que se encuentra en un DataSety se establece el MappingName del DataGridTableStyle en el TableName de la DataTable.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. A continuación, se agrega el DataGridTableStyle al GridTableStylesCollection devuelto por la propiedad TableStyles.The DataGridTableStyle is then added to the GridTableStylesCollection returned by the TableStyles property. En el ejemplo también se imprime el MappingName de cada DataGridColumnStyle en el GridColumnStylesCollection devuelto por la propiedad GridColumnStyles de cada DataGridTableStyle de la GridTableStylesCollection.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 )
   {
      for each ( DataTable^ t in myDataSet->Tables )
      {
         DataGridTableStyle^ myGridTableStyle =
            gcnew DataGridTableStyle;
         myGridTableStyle->MappingName = t->TableName;
         myDataGrid->TableStyles->Add( myGridTableStyle );
         
         /* Note that DataGridColumnStyle objects will
            be created automatically for the first DataGridTableStyle
            when you add it to the GridTableStylesCollection.*/
      }
   }

   void PrintGridStyleInfo( DataGrid^ myDataGrid )
   {
      /* Print the MappingName of each DataGridTableStyle,
         and the MappingName of each DataGridColumnStyle. */
      for each ( DataGridTableStyle^ myGridStyle in
         myDataGrid->TableStyles )
      {
         Console::WriteLine( myGridStyle->MappingName );
         for each ( DataGridColumnStyle^ myColumnStyle in
            myGridStyle->GridColumnStyles )
         {
            Console::WriteLine( myColumnStyle->MappingName );
         }
      }
   }
private void AddTables(DataGrid myDataGrid, DataSet myDataSet){
   foreach(DataTable t in myDataSet.Tables){
      DataGridTableStyle myGridTableStyle = new 
      DataGridTableStyle();
      myGridTableStyle.MappingName = t.TableName;
      myDataGrid.TableStyles.Add(myGridTableStyle);

      /* 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 
   myDataGrid.TableStyles){
   Console.WriteLine(myGridStyle.MappingName);
   foreach(DataGridColumnStyle myColumnStyle in 
      myGridStyle.GridColumnStyles){
  Console.WriteLine(myColumnStyle.MappingName);
      }
   }
}
 
Private Sub AddTables(myDataGrid As DataGrid, _
myDataSet As DataSet )
    Dim t As DataTable 
    For Each t in myDataSet.Tables
       Dim myGridTableStyle As DataGridTableStyle  = new _
       DataGridTableStyle()
       myGridTableStyle.MappingName = t.TableName
       myDataGrid.TableStyles.Add(myGridTableStyle)
       ' Note that DataGridColumnStyle objects will
       ' be created automatically for the first DataGridTableStyle
       ' when you add it to the GridTableStylesCollection.*/
    Next
 End Sub
 Private Sub PrintGridStyleInfo(myDataGrid As DataGrid )
    Dim myGridStyle As DataGridTableStyle
    Dim myColumnStyle As DataGridColumnStyle
    
    for each myGridStyle in _
    myDataGrid.TableStyles
       Console.WriteLine(myGridStyle.MappingName)
       for each myColumnStyle in myGridStyle.GridColumnStyles
      Console.WriteLine(myColumnStyle.MappingName)
       Next
    Next
 End Sub    

Comentarios

Utilice la GridTableStylesCollection recuperada a través de la propiedad TableStyles para crear vistas personalizadas de cada tabla mostrada por el control System.Windows.Forms.DataGrid.Use the GridTableStylesCollection retrieved through the TableStyles property to create customized views of each table displayed by the System.Windows.Forms.DataGrid control.

De forma predeterminada, la colección devuelta por TableStyles propiedad no contiene ningún objeto DataGridTableStyle.By default, the collection returned by TableStyles property does not contain any DataGridTableStyle objects. Para crear un conjunto de vistas personalizadas:To create a set of customized views:

  1. Cree un DataGridTableStyle.Create a DataGridTableStyle.

  2. Establezca el MappingName del objeto de tabla de cuadrícula en el TableName de la DataTable.Set the MappingName of the grid table object to the TableName of the DataTable.

  3. Agregue DataGridColumnStyle objetos, uno para cada columna de la cuadrícula que desee mostrar, al GridColumnStylesCollection devuelto por la propiedad GridColumnStyles.Add DataGridColumnStyle objects, one for each grid column you want to show, to the GridColumnStylesCollection returned by the GridColumnStyles property.

  4. Establezca el MappingName de cada DataGridColumnStyle en la ColumnName de un DataColumn.Set the MappingName of each DataGridColumnStyle to the ColumnName of a DataColumn.

  5. Agregue el objeto DataGridTableStyle a la colección devuelta por TableStyles propiedad.Add the DataGridTableStyle object to the collection returned by TableStyles property.

Precaución

Cree siempre DataGridColumnStyle objetos y agréguelos a la GridColumnStylesCollection antes de agregar objetos de DataGridTableStyle al GridTableStylesCollection.Always create DataGridColumnStyle objects and add them to the GridColumnStylesCollection before adding DataGridTableStyle objects to the GridTableStylesCollection. Cuando se agrega un DataGridTableStyle vacío con un valor MappingName válido a la colección, se generan automáticamente DataGridColumnStyle objetos.When you add an empty DataGridTableStyle with a valid MappingName value to the collection, DataGridColumnStyle objects are automatically generated for you. Por consiguiente, se producirá una excepción si intenta agregar nuevos objetos de DataGridColumnStyle con valores de MappingName duplicados a la GridColumnStylesCollection.Consequently, an exception will be thrown if you try to add new DataGridColumnStyle objects with duplicate MappingName values to the GridColumnStylesCollection.

Se aplica a

Consulte también: