DataGrid.TableStyles 屬性
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
取得方格中 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,代表 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 物件。 若要建立一組自訂檢視:
MappingName將方格資料表物件的 設定為 TableName 的 DataTable 。
將 DataGridColumnStyle 您想要顯示之每個方格資料行的物件新增至 GridColumnStylesCollection 屬性所傳回的 GridColumnStyles 。
MappingName將 每個 DataGridColumnStyle 的 設定為 ColumnName 的 DataColumn 。
將 DataGridTableStyle 物件新增至 屬性傳回的 TableStyles 集合。
警告
一律先建立 DataGridColumnStyle 物件,並在將物件新增至 GridColumnStylesCollection 之前將其新增 DataGridTableStyle 至 GridTableStylesCollection 。 當您將具有有效 MappingName 值的空白 DataGridTableStyle 加入至集合時, DataGridColumnStyle 系統會自動為您產生 物件。 因此,如果您嘗試將具有重複 MappingName 值的新 DataGridColumnStyle 物件新增至 GridColumnStylesCollection ,就會擲回例外狀況。