如何：將資料表和資料行加入至 Windows Form DataGrid 控制項

備註

ToolStrip 控制項會取代 ToolBar 控制項並加入其他功能，不過您也可以選擇保留 ToolBar 控制項，以提供回溯相容性及未來使用。 如需詳細資訊，請參閱 Windows Forms DataGridView 和 DataGrid 控制項之間的差異。

您可以在資料表和資料行的 Windows Forms DataGrid 控制項中顯示資料，方法是建立 DataGridTableStyle 物件，並將其新增至 GridTableStylesCollection 物件，而該物件是透過 DataGrid 控制項的 TableStyles 屬性來存取。 每個表格樣式都會在 DataGridTableStyle 物件的 MappingName 屬性中顯示指定之任何資料表格的內容。 根據預設，沒有指定資料行樣式的表格樣式會顯示該表格中的所有資料行。 您可以將 DataGridColumnStyle 物件新增至 GridColumnStylesCollection 物件，藉以限制資料表中出現的資料行，這是透過每個 DataGridTableStyle 物件的 GridColumnStyles 属性來存取。

以程式設計方式將資料表和資料行新增至 DataGrid

1. 若要在表格中顯示資料，您必須先將 DataGrid 控制項繫結至資料集。 如需詳細資訊，請參閱操作說明：將 Windows Forms DataGrid 控制項繫結至資料來源 (部分機器翻譯)。

   謹慎

   以程式設計方式指定資料行樣式時，請一律建立 DataGridColumnStyle 物件，並將其新增至 GridColumnStylesCollection 物件，然後再將 DataGridTableStyle 物件新增至 GridTableStylesCollection 物件。 當您將空白的 DataGridTableStyle 物件新增至集合時，系統會自動為您產生 DataGridColumnStyle 物件。 因此，如果您嘗試將具有重複 MappingName 值的新 DataGridColumnStyle 物件新增至 GridColumnStylesCollection 物件，就會擲回例外狀況。

2. 宣告新的表格樣式並設定其對應名稱。

   Dim ts1 As New DataGridTableStyle()
   ts1.MappingName = "Customers"
   

   DataGridTableStyle ts1 = new DataGridTableStyle();
   ts1.MappingName = "Customers";
   

   DataGridTableStyle* ts1 = new DataGridTableStyle();
   ts1->MappingName = S"Customers";
   

3. 宣告新的資料行樣式，並設定其對應名稱和其他屬性。

   Dim myDataCol As New DataGridBoolColumn()
   myDataCol.HeaderText = "My New Column"
   myDataCol.MappingName = "Current"
   

   DataGridBoolColumn myDataCol = new DataGridBoolColumn();
   myDataCol.HeaderText = "My New Column";
   myDataCol.MappingName = "Current";
   

   DataGridBoolColumn^ myDataCol = gcnew DataGridBoolColumn();
   myDataCol->HeaderText = "My New Column";
   myDataCol->MappingName = "Current";
   

4. 呼叫 GridColumnStylesCollection 物件的 Add 方法，以將資料行新增至表格樣式

   ts1.GridColumnStyles.Add(myDataCol)
   

   ts1.GridColumnStyles.Add(myDataCol);
   

   ts1->GridColumnStyles->Add(myDataCol);
   

5. 呼叫 GridTableStylesCollection 物件的 Add 方法，以將表格樣式新增至資料格。

   DataGrid1.TableStyles.Add(ts1)
   

   dataGrid1.TableStyles.Add(ts1);
   

   dataGrid1->TableStyles->Add(ts1);
   

另請參閱

• DataGrid 控制項
• 如何：刪除或隱藏 Windows Forms DataGrid 控制項中的資料行