DataGrid.TableStyles Properti
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Mendapatkan kumpulan DataGridTableStyle objek untuk kisi.
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
Nilai Properti
GridTableStylesCollection yang mewakili kumpulan DataGridTableStyle objek.
Contoh
Contoh kode berikut membuat satu DataGridTableStyle untuk masing-masing DataTable yang ditemukan dalam DataSet, dan mengatur MappingName dari DataGridTableStyle ke TableName dari DataTable. DataGridTableStyle kemudian ditambahkan ke yang GridTableStylesCollection dikembalikan oleh TableStyles properti . Contoh juga mencetak masing-masing DataGridColumnStyle dalam GridColumnStylesCollection yang dikembalikan oleh GridColumnStyles properti masing-masing DataGridTableStyle di GridTableStylesCollection.MappingName
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
Keterangan
Gunakan yang GridTableStylesCollection diambil melalui TableStyles properti untuk membuat tampilan yang dikustomisasi dari setiap tabel yang System.Windows.Forms.DataGrid ditampilkan oleh kontrol.
Secara default, koleksi yang dikembalikan oleh TableStyles properti tidak berisi objek apa pun DataGridTableStyle . Untuk membuat sekumpulan tampilan yang dikustomisasi:
Buat DataGridTableStyle.
Atur MappingName objek tabel kisi ke TableName dari DataTable.
Tambahkan DataGridColumnStyle objek, satu untuk setiap kolom kisi yang ingin Anda tampilkan, ke yang GridColumnStylesCollection dikembalikan oleh GridColumnStyles properti .
Atur MappingName masing-masing DataGridColumnStyle ke ColumnName dari DataColumn.
DataGridTableStyle Tambahkan objek ke koleksi yang dikembalikan oleh TableStyles properti .
Perhatian
Selalu buat DataGridColumnStyle objek dan tambahkan ke GridColumnStylesCollection sebelum menambahkan DataGridTableStyle objek ke GridTableStylesCollection. Saat Anda menambahkan kosong DataGridTableStyle dengan nilai yang valid MappingName ke koleksi, DataGridColumnStyle objek secara otomatis dibuat untuk Anda. Akibatnya, pengecualian akan dilemparkan jika Anda mencoba menambahkan objek baru DataGridColumnStyle dengan nilai duplikat MappingName ke GridColumnStylesCollection.