DataGrid.TableStyles Propriedade

Definição

Obtém a coleção de objetos DataGridTableStyle para a grade.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 da propriedade

Um GridTableStylesCollection que representa uma coleção de objetos DataGridTableStyle.A GridTableStylesCollection that represents the collection of DataGridTableStyle objects.

Exemplos

O exemplo de código a seguir cria um DataGridTableStyle para cada DataTable encontrado em um DataSet e define o MappingName do DataGridTableStyle para o TableName do 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. Em seguida, o DataGridTableStyle é adicionado ao GridTableStylesCollection retornado pela propriedade TableStyles.The DataGridTableStyle is then added to the GridTableStylesCollection returned by the TableStyles property. O exemplo também imprime o MappingName de cada DataGridColumnStyle no GridColumnStylesCollection retornado pela propriedade GridColumnStyles de cada DataGridTableStyle no 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    

Comentários

Use o GridTableStylesCollection recuperado por meio da propriedade TableStyles para criar exibições personalizadas de cada tabela exibida pelo controle 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.

Por padrão, a coleção retornada pela propriedade TableStyles não contém nenhum objeto DataGridTableStyle.By default, the collection returned by TableStyles property does not contain any DataGridTableStyle objects. Para criar um conjunto de exibições personalizadas:To create a set of customized views:

  1. Criará um DataGridTableStyle.Create a DataGridTableStyle.

  2. Defina o MappingName do objeto de tabela de grade como o TableName do DataTable.Set the MappingName of the grid table object to the TableName of the DataTable.

  3. Adicione objetos DataGridColumnStyle, um para cada coluna de grade que você deseja mostrar ao GridColumnStylesCollection retornado pela propriedade GridColumnStyles.Add DataGridColumnStyle objects, one for each grid column you want to show, to the GridColumnStylesCollection returned by the GridColumnStyles property.

  4. Defina o MappingName de cada DataGridColumnStyle para o ColumnName de um DataColumn.Set the MappingName of each DataGridColumnStyle to the ColumnName of a DataColumn.

  5. Adicione o objeto DataGridTableStyle à coleção retornada pela propriedade TableStyles.Add the DataGridTableStyle object to the collection returned by TableStyles property.

Cuidado

Sempre Crie objetos DataGridColumnStyle e adicione-os ao GridColumnStylesCollection antes de adicionar objetos DataGridTableStyle ao GridTableStylesCollection.Always create DataGridColumnStyle objects and add them to the GridColumnStylesCollection before adding DataGridTableStyle objects to the GridTableStylesCollection. Quando você adiciona um DataGridTableStyle vazio com um valor de MappingName válido à coleção, os objetos DataGridColumnStyle são gerados automaticamente para você.When you add an empty DataGridTableStyle with a valid MappingName value to the collection, DataGridColumnStyle objects are automatically generated for you. Consequentemente, uma exceção será gerada se você tentar adicionar novos objetos DataGridColumnStyle com valores de MappingName duplicados para o GridColumnStylesCollection.Consequently, an exception will be thrown if you try to add new DataGridColumnStyle objects with duplicate MappingName values to the GridColumnStylesCollection.

Aplica-se a

Veja também