DataGrid.TableStyles 屬性

定義

命名空間:

System.Windows.Forms

組件:

System.Windows.Forms.dll

取得方格中 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 ，並將 的 DataGridTableStyle 設定 MappingName 為 TableName 的 DataTable 。 DataTableDataSet 接著，會將 DataGridTableStyle 新增至 GridTableStylesCollection 屬性所傳回的 TableStyles 。 此範例也會列印 MappingName 中 每個 GridColumnStylesCollectionDataGridColumnStyle 的 屬性 DataGridTableStyleGridTableStylesCollection 所 GridColumnStyles 傳回之 的 。

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. MappingName將方格資料表物件的 設定為 TableName 的 DataTable 。

3. 將 DataGridColumnStyle 您想要顯示之每個方格資料行的物件新增至 GridColumnStylesCollection 屬性所傳回的 GridColumnStyles 。

4. MappingName將 每個 DataGridColumnStyle 的 設定為 ColumnName 的 DataColumn 。

5. 將 DataGridTableStyle 物件新增至 屬性傳回的 TableStyles 集合。

警告

一律先建立 DataGridColumnStyle 物件，並在將物件新增至 GridColumnStylesCollection 之前將其新增 DataGridTableStyle 至 GridTableStylesCollection 。 當您將具有有效 MappingName 值的空白 DataGridTableStyle 加入至集合時， DataGridColumnStyle 系統會自動為您產生 物件。 因此，如果您嘗試將具有重複 MappingName 值的新 DataGridColumnStyle 物件新增至 GridColumnStylesCollection ，就會擲回例外狀況。

另請參閱

• DataColumn
• DataTable
• DataGridTableStyle
• GridTableStylesCollection