DataGrid.TableStyles Свойство

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Исходный код:

DataGrid.cs

Возвращает коллекцию объектов для сетки DataGridTableStyle .

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

Значение свойства

GridTableStylesCollection

Объект, GridTableStylesCollection представляющий коллекцию DataGridTableStyle объектов.

Примеры

В следующем примере кода создается один DataGridTableStyle для каждогоDataTable, найденного в объектеDataSet, и задает DataGridTableStyleMappingName значение TableNameDataTableпараметра . Затем он DataGridTableStyle добавляется в GridTableStylesCollection возвращаемый свойством TableStyles объект. В примере также выводится MappingName каждый DataGridColumnStyle из GridColumnStylesCollection возвращаемых GridColumnStyles свойством каждого DataGridTableStyle из них.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

Комментарии

Используйте полученное GridTableStylesCollection свойство TableStyles для создания настраиваемых представлений каждой таблицы, отображаемой элементом System.Windows.Forms.DataGrid управления.

По умолчанию коллекция, возвращаемая свойством TableStyles , не содержит DataGridTableStyle объектов. Чтобы создать набор настраиваемых представлений, выполните приведенные действия.

1. Создайте DataGridTableStyle.

2. Задайте для объекта таблицы сетки значение ..

3. Добавьте DataGridColumnStyle объекты, по одному для каждого столбца сетки, который вы хотите показать, в GridColumnStylesCollection возвращаемый свойством GridColumnStyles .

4. Задайте для MappingName каждого DataGridColumnStyleColumnNameDataColumnиз них значение .

5. Добавьте объект в коллекцию DataGridTableStyle , возвращаемую свойством TableStyles .

Предостережение

Всегда создавайте объекты и добавляйте DataGridColumnStyle их в GridColumnStylesCollection него перед добавлением GridTableStylesCollectionDataGridTableStyle объектов. При добавлении пустого DataGridTableStyleMappingName значения в коллекцию DataGridColumnStyle объекты создаются автоматически. Следовательно, при попытке добавить новые DataGridColumnStyle объекты с повторяющимися MappingName значениями в объект GridColumnStylesCollectionбудет возникать исключение.

См. также раздел

• DataColumn
• DataTable
• DataGridTableStyle
• GridTableStylesCollection