DataGrid.TableStyles Свойство

Определение

Получает коллекцию объектов DataGridTableStyle для сетки.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

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

GridTableStylesCollection

Объект GridTableStylesCollection, представляющий коллекцию объектов DataGridTableStyle.A GridTableStylesCollection that represents the collection of DataGridTableStyle objects.

Примеры

В следующем примере кода создается DataGridTableStyle объект для каждого DataTable найденного в элементе DataSet , и задается значение в свойстве MappingName DataGridTableStyle TableName объекта 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. DataGridTableStyleЗатем добавляется в объект, GridTableStylesCollection возвращаемый TableStyles свойством.The DataGridTableStyle is then added to the GridTableStylesCollection returned by the TableStyles property. В этом примере также выводится MappingName каждый из DataGridColumnStyle в, GridColumnStylesCollection возвращаемом GridColumnStyles свойством каждого DataGridTableStyle в 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    

Комментарии

Используйте GridTableStylesCollection свойство, полученное с помощью TableStyles свойства, для создания настраиваемых представлений каждой таблицы, отображаемой 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.

По умолчанию коллекция, возвращаемая TableStyles свойством, не содержит DataGridTableStyle объектов.By default, the collection returned by TableStyles property does not contain any DataGridTableStyle objects. Чтобы создать набор настраиваемых представлений, выполните следующие действия.To create a set of customized views:

  1. Создайте таблицу DataGridTableStyle.Create a DataGridTableStyle.

  2. Задайте MappingName для объекта таблицы сетки значение TableName из DataTable .Set the MappingName of the grid table object to the TableName of the DataTable.

  3. Добавьте DataGridColumnStyle объекты, по одному для каждого столбца сетки, который требуется отобразить, в объект, GridColumnStylesCollection возвращаемый GridColumnStyles свойством.Add DataGridColumnStyle objects, one for each grid column you want to show, to the GridColumnStylesCollection returned by the GridColumnStyles property.

  4. Задайте для MappingName каждого из значение DataGridColumnStyle ColumnName DataColumn .Set the MappingName of each DataGridColumnStyle to the ColumnName of a DataColumn.

  5. Добавьте DataGridTableStyle объект в коллекцию, возвращенную TableStyles свойством.Add the DataGridTableStyle object to the collection returned by TableStyles property.

Внимание!

Всегда создавайте DataGridColumnStyle объекты и добавляйте их в, GridColumnStylesCollection прежде чем добавлять DataGridTableStyle объекты в GridTableStylesCollection .Always create DataGridColumnStyle objects and add them to the GridColumnStylesCollection before adding DataGridTableStyle objects to the GridTableStylesCollection. При добавлении DataGridTableStyle в коллекцию пустого значения с допустимым MappingName значением объекты создаются DataGridColumnStyle автоматически.When you add an empty DataGridTableStyle with a valid MappingName value to the collection, DataGridColumnStyle objects are automatically generated for you. Следовательно, при попытке добавления новых DataGridColumnStyle объектов с повторяющимися значениями в объект возникнет исключение MappingName GridColumnStylesCollection .Consequently, an exception will be thrown if you try to add new DataGridColumnStyle objects with duplicate MappingName values to the GridColumnStylesCollection.

Применяется к

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