DataGrid.TableStyles プロパティ

定義

グリッドの DataGridTableStyle オブジェクトのコレクションを取得します。Gets the collection of DataGridTableStyle objects for the grid.

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 オブジェクトのコレクションを表す DataGridTableStyleA GridTableStylesCollection that represents the collection of DataGridTableStyle objects.

次のコード例では、DataSet にある DataTable ごとに1つの DataGridTableStyle を作成し、@no__t の @no__t を @no__t の 6 @no__t に設定します。The following code example creates one DataGridTableStyle for each DataTable found in a DataSet, and sets the MappingName of the DataGridTableStyle to the TableName of the DataTable. 次に、DataGridTableStyleTableStyles プロパティによって返される GridTableStylesCollection に追加されます。The DataGridTableStyle is then added to the GridTableStylesCollection returned by the TableStyles property. この例では、DataGridTableStyle の各 @no__t の GridColumnStyles プロパティによって返された GridColumnStylesCollection の各 DataGridColumnStyle の @no__t 0 も出力します。The example also prints the MappingName of each DataGridColumnStyle in the GridColumnStylesCollection returned by the GridColumnStyles property of each DataGridTableStyle in the GridTableStylesCollection.

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    

注釈

@No__t-1 プロパティから取得した @no__t 0 を使用して、System.Windows.Forms.DataGrid コントロールによって表示される各テーブルのカスタマイズされたビューを作成します。Use the GridTableStylesCollection retrieved through the TableStyles property to create customized views of each table displayed by the System.Windows.Forms.DataGrid control.

既定では、TableStyles プロパティによって返されるコレクションには、DataGridTableStyle のオブジェクトは含まれません。By default, the collection returned by TableStyles property does not contain any DataGridTableStyle objects. カスタマイズされた一連のビューを作成するには、次のようにします。To create a set of customized views:

  1. DataGridTableStyle を作成します。Create a DataGridTableStyle.

  2. Grid テーブルオブジェクトの MappingName を、DataTableTableName に設定します。Set the MappingName of the grid table object to the TableName of the DataTable.

  3. 表示する各グリッド列に1つずつ @no__t 0 オブジェクトを、GridColumnStyles プロパティによって返される GridColumnStylesCollection に追加します。Add DataGridColumnStyle objects, one for each grid column you want to show, to the GridColumnStylesCollection returned by the GridColumnStyles property.

  4. DataGridColumnStyleMappingNameDataColumn の @no__t に設定します。Set the MappingName of each DataGridColumnStyle to the ColumnName of a DataColumn.

  5. @No__t-1 プロパティによって返されるコレクションに DataGridTableStyle オブジェクトを追加します。Add the DataGridTableStyle object to the collection returned by TableStyles property.

注意事項

@No__t-2 オブジェクトを GridTableStylesCollection に追加する前に、常に @no__t 0 のオブジェクトを作成し、GridColumnStylesCollection に追加します。Always create DataGridColumnStyle objects and add them to the GridColumnStylesCollection before adding DataGridTableStyle objects to the GridTableStylesCollection. 有効な MappingName の値を持つ空の DataGridTableStyle をコレクションに追加すると、DataGridColumnStyle のオブジェクトが自動的に生成されます。When you add an empty DataGridTableStyle with a valid MappingName value to the collection, DataGridColumnStyle objects are automatically generated for you. その結果、MappingName の値が重複する新しい DataGridColumnStyle オブジェクトを GridColumnStylesCollection に追加しようとすると、例外がスローされます。Consequently, an exception will be thrown if you try to add new DataGridColumnStyle objects with duplicate MappingName values to the GridColumnStylesCollection.

適用対象

こちらもご覧ください