DataGrid.TableStyles プロパティ

.NET Framework クラス ライブラリ リファレンス

DataGrid.TableStyles プロパティ

グリッドの DataGridTableStyle オブジェクトのコレクションを取得します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

<LocalizableAttribute(True)> _
Public ReadOnly Property
 TableStyles As GridTableStylesCollection

Visual Basic (使用法)

Dim instance As DataGrid
Dim value As GridTableStylesCollection

value = instance.TableStyles

C#

[LocalizableAttribute(true)] 
public GridTableStylesCollection TableStyles { get;
 }

C++

[LocalizableAttribute(true)] 
public:
property GridTableStylesCollection^ TableStyles {
    GridTableStylesCollection^ get ();
}

J#

/** @property */
public GridTableStylesCollection get_TableStyles ()

JScript

public function get TableStyles
 () : GridTableStylesCollection

プロパティ値
DataGridTableStyle オブジェクトのコレクションを表す GridTableStylesCollection。

解説

System.Windows.Forms.DataGrid コントロールによって表示される各テーブルのカスタマイズされたビューを作成するには、TableStyles プロパティで取得した GridTableStylesCollection を使用します。

既定では、TableStyles プロパティによって返されるコレクションは、DataGridTableStyle オブジェクトを格納していません。カスタマイズされた一連のビューを作成するには、次の操作を行います。

1. DataGridTableStyle を作成します。

2. グリッド テーブル オブジェクトの MappingName を、DataTable の TableName に設定します。

3. DataGridColumnStyle オブジェクトを GridColumnStyles プロパティによって返された GridColumnStylesCollection の、表示するグリッドの各列に 1 つ追加します。

4. 各 DataGridColumnStyle の MappingName を DataColumn の ColumnName に設定します。

5. DataGridTableStyle オブジェクトを TableStyles プロパティによって返されるコレクションに追加します。

注意
必ず DataGridColumnStyle オブジェクトを作成して GridColumnStylesCollection に追加してから、DataGridTableStyle オブジェクトを GridTableStylesCollection に追加します。有効な MappingName 値を持つ空の DataGridTableStyle をコレクションに追加すると、自動的に DataGridColumnStyle オブジェクトが生成されます。そのため、MappingName 値が重複する新しい DataGridColumnStyle オブジェクトを GridColumnStylesCollection に追加しようとすると、例外がスローされます。

使用例

DataSet で見つかった各 DataTable に DataGridTableStyle を 1 つ作成し、DataGridTableStyle の MappingName を DataTable の TableName に設定するコード例を次に示します。さらに、DataGridTableStyle は、TableStyles プロパティによって返された GridTableStylesCollection に追加されます。この例では、GridTableStylesCollection にある各 DataGridTableStyle の GridColumnStyles プロパティによって返された、GridColumnStylesCollection にある各 DataGridColumnStyle の MappingName も出力します。

Visual Basic

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    

C#

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);
      }
   }
}
 

C++

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 );
         }
      }
   }

J#

private void AddTables(DataGrid myDataGrid,
 DataSet myDataSet)
{
    DataTable t;
    for (int iCtr = 0; iCtr < myDataSet.get_Tables().get_Count();
 iCtr++) {
        t = myDataSet.get_Tables().get_Item(iCtr);
        DataGridTableStyle myGridTableStyle = new DataGridTableStyle();
        myGridTableStyle.set_MappingName(t.get_TableName());
        myDataGrid.get_TableStyles().Add(myGridTableStyle);
    }
} //AddTables

/*  Note that DataGridColumnStyle objects will
    be created automatically for the first DataGridTableStyle
    when you add it to the GridTableStylesCollection.
 */
private void PrintGridStyleInfo(DataGrid myDataGrid)
{
    DataGridTableStyle myGridStyle;
    for (int iCtr = 0; iCtr < myDataGrid.get_TableStyles().get_Count();
 
        iCtr++) {
        /*  Print the MappingName of each DataGridTableStyle,
            and the MappingName of each DataGridColumnStyle. 
         */
        myGridStyle = myDataGrid.get_TableStyles().get_Item(iCtr);
        Console.WriteLine(myGridStyle.get_MappingName());
        DataGridColumnStyle myColumnStyle;
        for (int iCtr1 = 0; 
            iCtr1 < myGridStyle.get_GridColumnStyles().get_Count();
            iCtr1++) {
            myColumnStyle = myGridStyle.get_GridColumnStyles().
                get_Item(iCtr1);
            Console.WriteLine(myColumnStyle.get_MappingName());
        }
    }
} //PrintGridStyleInfo

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
DataGrid クラス
DataGrid メンバ
System.Windows.Forms 名前空間
DataColumn
DataTable
DataGridTableStyle
GridTableStylesCollection