GridTableStylesCollectionとは何？わかりやすく解説 Weblio辞書

すべての辞書から再検索する

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

索引トップ用語の索引ランキング

GridTableStylesCollection イベント

パブリックイベントパブリックイベント

	名前	説明
	CollectionChanged	コレクションが変更された場合に発生します。

参照

GridTableStylesCollection クラス

DataGrid コントロール内の DataGridTableStyle オブジェクトのコレクションを表します。

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

Visual Basic (宣言)

Public Class GridTableStylesCollection
    Inherits BaseCollection
    Implements IList, ICollection, IEnumerable

Visual Basic (使用法)

Dim instance As GridTableStylesCollection

public class GridTableStylesCollection : BaseCollection,
 IList, ICollection, IEnumerable

C++

public ref class GridTableStylesCollection
 : public BaseCollection, IList, ICollection, IEnumerable

public class GridTableStylesCollection extends
 BaseCollection implements IList, ICollection, 
    IEnumerable

JScript

public class GridTableStylesCollection extends
 BaseCollection implements IList, ICollection, 
    IEnumerable

解説

GridTableStylesCollection は DataGridTableStyle オブジェクトを格納します。DataGrid コントロールは、このオブジェクトを使用して DataSet 内の各 DataTable にカスタマイズされたグリッドスタイルを表示できます。

DataGrid コントロールでは、TableStyles プロパティは GridTableStylesCollection を返します。

既定では、GridTableStylesCollection には DataGridTableStyle オブジェクトが格納されていません。代わりに、DataGrid は、色、幅、および書式指定について既定の設定値を使用して各テーブルを表示します。また、各テーブルのすべての列が表示されます。DataGridTableStyle がコレクションに追加されると、DataGrid は MappingName を使用して、グリッドのデータを提供するオブジェクトを決定します。たとえば、データソースが 3 つの DataTable オブジェクトを格納する DataSet の場合、MappingName は、それらのオブジェクトのいずれかの TableName と一致する必要があります。MappingName がいずれの TableName 値とも一致しない場合は、既定の設定値を使用して各テーブルのデータが表示され、DataGridTableStyle の設定値は無視されます。

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

注意

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

使用例

2 つの DataGridTableStyle オブジェクトを作成し、各オブジェクトを DataGrid コントロールの TableStyles プロパティから返された GridTableStylesCollection に追加するコード例を次に示します。

Visual Basic

Private Sub AddCustomDataTableStyle()
   Dim ts1 As New DataGridTableStyle()
   ts1.MappingName = "Customers"
   ' Set other properties.
   ts1.AlternatingBackColor = Color.LightGray
   ' Add a GridColumnStyle and set its MappingName 
   ' to the name of a DataColumn in the DataTable. 
   ' Set the HeaderText and Width properties. 
     
   Dim boolCol As New DataGridBoolColumn()
   boolCol.MappingName = "Current"
   boolCol.HeaderText = "IsCurrent Customer"
   boolCol.Width = 150
   ts1.GridColumnStyles.Add(boolCol)
     
   ' Add a second column style.
   Dim TextCol As New DataGridTextBoxColumn()
   TextCol.MappingName = "custName"
   TextCol.HeaderText = "Customer Name"
   TextCol.Width = 250
   ts1.GridColumnStyles.Add(TextCol)
     
   ' Create the second table style with columns.
   Dim ts2 As New DataGridTableStyle()
   ts2.MappingName = "Orders"
     
   ' Set other properties.
   ts2.AlternatingBackColor = Color.LightBlue
     
   ' Create new ColumnStyle objects.
   Dim cOrderDate As New
 DataGridTextBoxColumn()
   cOrderDate.MappingName = "OrderDate"
   cOrderDate.HeaderText = "Order Date"
   cOrderDate.Width = 100
   ts2.GridColumnStyles.Add(cOrderDate)

   ' Use a PropertyDescriptor to create a formatted
   ' column. First get the PropertyDescriptorCollection
   ' for the data source and data member. 
   Dim pcol As System.ComponentModel.PropertyDescriptorCollection
 = _
   Me.BindingContext(myDataSet, "Customers.custToOrders").
 _
   GetItemProperties()

   ' Create a formatted column using a PropertyDescriptor.
   ' The formatting character "c" specifies a currency format.
 */     
     
   Dim csOrderAmount As _
   New DataGridTextBoxColumn(pcol("OrderAmount"),
 "c", True)
   csOrderAmount.MappingName = "OrderAmount"
   csOrderAmount.HeaderText = "Total"
   csOrderAmount.Width = 100
   ts2.GridColumnStyles.Add(csOrderAmount)
     
   ' Add the DataGridTableStyle instances to 
   ' the GridTableStylesCollection. 
   myDataGrid.TableStyles.Add(ts1)
   myDataGrid.TableStyles.Add(ts2)
End Sub 'AddCustomDataTableStyle

private void AddCustomDataTableStyle(){
   DataGridTableStyle ts1 = new DataGridTableStyle();
   ts1.MappingName = "Customers";
   // Set other properties.
   ts1.AlternatingBackColor = Color.LightGray;

   /* Add a GridColumnStyle and set its MappingName 
   to the name of a DataColumn in the DataTable. 
   Set the HeaderText and Width properties. */
   
   DataGridColumnStyle boolCol = new DataGridBoolColumn();
   boolCol.MappingName = "Current";
   boolCol.HeaderText = "IsCurrent Customer";
   boolCol.Width = 150;
   ts1.GridColumnStyles.Add(boolCol);
   
   // Add a second column style.
   DataGridColumnStyle TextCol = new DataGridTextBoxColumn();
   TextCol.MappingName = "custName";
   TextCol.HeaderText = "Customer Name";
   TextCol.Width = 250;
   ts1.GridColumnStyles.Add(TextCol);

   // Create the second table style with columns.
   DataGridTableStyle ts2 = new DataGridTableStyle();
   ts2.MappingName = "Orders";

   // Set other properties.
   ts2.AlternatingBackColor = Color.LightBlue;
   
   // Create new ColumnStyle objects.
   DataGridColumnStyle cOrderDate = 
   new DataGridTextBoxColumn();
   cOrderDate.MappingName = "OrderDate";
   cOrderDate.HeaderText = "Order Date";
   cOrderDate.Width = 100;
   ts2.GridColumnStyles.Add(cOrderDate);

   /*Use a PropertyDescriptor to create a formatted
   column. First get the PropertyDescriptorCollection
   for the data source and data member. */
   System.ComponentModel.PropertyDescriptorCollection pcol = 
      this.BindingContext[myDataSet, "Customers.custToOrders"]
      .GetItemProperties();
 
   /* Create a formatted column using a PropertyDescriptor.
   The formatting character "c" specifies a currency format. */     
   DataGridColumnStyle csOrderAmount = 
   new DataGridTextBoxColumn(pcol["OrderAmount"], "c",
 true);
   csOrderAmount.MappingName = "OrderAmount";
   csOrderAmount.HeaderText = "Total";
   csOrderAmount.Width = 100;
   ts2.GridColumnStyles.Add(csOrderAmount);

   /* Add the DataGridTableStyle instances to 
   the GridTableStylesCollection. */
   myDataGrid.TableStyles.Add(ts1);
   myDataGrid.TableStyles.Add(ts2);
}

C++

void AddCustomDataTableStyle()
{
   DataGridTableStyle^ ts1 = gcnew DataGridTableStyle;
   ts1->MappingName = "Customers";
   
   // Set other properties.
   ts1->AlternatingBackColor = Color::LightGray;
   
   /* Add a GridColumnStyle and set its MappingName
     to the name of a DataColumn in the DataTable.
     Set the HeaderText and Width properties. */
   DataGridColumnStyle^ boolCol = gcnew DataGridBoolColumn;
   boolCol->MappingName = "Current";
   boolCol->HeaderText = "IsCurrent Customer";
   boolCol->Width = 150;
   ts1->GridColumnStyles->Add( boolCol );
   
   // Add a second column style.
   DataGridColumnStyle^ TextCol = gcnew DataGridTextBoxColumn;
   TextCol->MappingName = "custName";
   TextCol->HeaderText = "Customer Name";
   TextCol->Width = 250;
   ts1->GridColumnStyles->Add( TextCol );
   
   // Create the second table style with columns.
   DataGridTableStyle^ ts2 = gcnew DataGridTableStyle;
   ts2->MappingName = "Orders";
   
   // Set other properties.
   ts2->AlternatingBackColor = Color::LightBlue;
   
   // Create new ColumnStyle objects.
   DataGridColumnStyle^ cOrderDate = gcnew DataGridTextBoxColumn;
   cOrderDate->MappingName = "OrderDate";
   cOrderDate->HeaderText = "Order Date";
   cOrderDate->Width = 100;
   ts2->GridColumnStyles->Add( cOrderDate );
   
   /*Use a PropertyDescriptor to create a formatted
     column. First get the PropertyDescriptorCollection
     for the data source and data member. */
   System::ComponentModel::PropertyDescriptorCollection^ pcol = this->
       BindingContext[myDataSet, "Customers::custToOrders"]->
       GetItemProperties();
   
   /* Create a formatted column using a PropertyDescriptor.
     The formatting character S"c" specifies a currency format. */
   DataGridColumnStyle^ csOrderAmount =
      gcnew DataGridTextBoxColumn( pcol[ "OrderAmount" ],"c",true
 );
   csOrderAmount->MappingName = "OrderAmount";
   csOrderAmount->HeaderText = "Total";
   csOrderAmount->Width = 100;
   ts2->GridColumnStyles->Add( csOrderAmount );
   
   /* Add the DataGridTableStyle instances to
     the GridTableStylesCollection. */
   myDataGrid->TableStyles->Add( ts1 );
   myDataGrid->TableStyles->Add( ts2 );
}

private void AddCustomDataTableStyle()
{
    DataGridTableStyle ts1 = new DataGridTableStyle();
    ts1.set_MappingName("Customers");

    // Set other properties.
    ts1.set_AlternatingBackColor(Color.get_LightGray());

    /*  Add a GridColumnStyle and set its MappingName to the name
 of a 
        DataColumn in the DataTable. Set the HeaderText and Width
 
        properties.
     */
    DataGridColumnStyle boolCol = new DataGridBoolColumn();

    boolCol.set_MappingName("Current");
    boolCol.set_HeaderText("IsCurrent Customer");
    boolCol.set_Width(150);
    ts1.get_GridColumnStyles().Add(boolCol);

    // Add a second column style.
    DataGridColumnStyle TextCol = new DataGridTextBoxColumn();

    TextCol.set_MappingName("custName");
    TextCol.set_HeaderText("Customer Name");
    TextCol.set_Width(250);
    ts1.get_GridColumnStyles().Add(TextCol);

    // Create the second table style with columns.
    DataGridTableStyle ts2 = new DataGridTableStyle();
    ts2.set_MappingName("Orders");

    // Set other properties.
    ts2.set_AlternatingBackColor(Color.get_LightBlue());

    // Create new ColumnStyle objects.
    DataGridColumnStyle cOrderDate = new DataGridTextBoxColumn();

    cOrderDate.set_MappingName("OrderDate");
    cOrderDate.set_HeaderText("Order Date");
    cOrderDate.set_Width(100);
    ts2.get_GridColumnStyles().Add(cOrderDate);

    /*  Use a PropertyDescriptor to create a formatted column. First get
 the 
        the PropertyDescriptorCollection for the data source and
 data member. 
    */
    PropertyDescriptorCollection pcol = this.get_BindingContext().
        get_Item(myDataSet, "Customers.custToOrders").GetItemProperties();

    /*  Create a formatted column using a PropertyDescriptor.
        The formatting character "c" specifies a currency format.
     */
    DataGridColumnStyle csOrderAmount = new DataGridTextBoxColumn(pcol.
        get_Item("OrderAmount"), "c", true);

    csOrderAmount.set_MappingName("OrderAmount");
    csOrderAmount.set_HeaderText("Total");
    csOrderAmount.set_Width(100);
    ts2.get_GridColumnStyles().Add(csOrderAmount);

    /*  Add the DataGridTableStyle instances to 
        the GridTableStylesCollection. 
     */
    myDataGrid.get_TableStyles().Add(ts1);
    myDataGrid.get_TableStyles().Add(ts2);
} //AddCustomDataTableStyle

継承階層

System.Object
   System.MarshalByRefObject
     System.Windows.Forms.BaseCollection
      System.Windows.Forms.GridTableStylesCollection

スレッドセーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッドセーフです。インスタンスメンバの場合は、スレッドセーフであるとは限りません。

プラットフォーム

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

参照

関連項目
GridTableStylesCollection メンバ
System.Windows.Forms 名前空間
DataGrid クラス
DataGridTableStyle.GridColumnStyles プロパティ

GridTableStylesCollection プロパティ

パブリックプロパティパブリックプロパティ

( プロテクトプロパティも参照)

	名前	説明
	Count	コレクション内の要素の合計数を取得します。 ( BaseCollection から継承されます。)
	IsReadOnly	コレクションが読み取り専用かどうかを示す値を取得します。 ( BaseCollection から継承されます。)
	IsSynchronized	ICollection へのアクセスの同期がとられているかどうかを示す値を取得します。 ( BaseCollection から継承されます。)
	Item	オーバーロードされます。指定した DataGridTableStyle を取得します。
	SyncRoot	BaseCollection へのアクセスを同期するために使用できるオブジェクトを取得します。 ( BaseCollection から継承されます。)

プロテクトプロパティ

	名前	説明
	List	オーバーライドされます。基になるリストを取得します。

明示的インターフェイスの実装

	名前	説明
	System.Collections.IList.Item	指定したインデックスにある要素を取得または設定します。

参照

GridTableStylesCollection メソッド

パブリックメソッドパブリックメソッド

( プロテクトメソッドも参照)

	名前	説明
	Add	DataGridTableStyle をコレクションに追加します。
	AddRange	テーブルスタイルの配列をコレクションに追加します。
	Clear	コレクションを空にします。
	Contains	オーバーロードされます。指定した DataGridTableStyle が GridTableStylesCollection に格納されているかどうかを示す値を取得します。
	CopyTo	指定したコピー先の Array インデックスを開始位置として、現在の 1 次元 Array のすべての要素を指定した 1 次元 Array にコピーします。 ( BaseCollection から継承されます。)
	CreateObjRef	リモートオブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。 ( MarshalByRefObject から継承されます。)
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetEnumerator	コレクションのメンバを反復処理できるオブジェクトを取得します。 ( BaseCollection から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュアルゴリズムや、ハッシュテーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetLifetimeService	対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービスオブジェクトを取得します。 ( MarshalByRefObject から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	InitializeLifetimeService	対象のインスタンスの有効期間ポリシーを制御する、有効期間サービスオブジェクトを取得します。 ( MarshalByRefObject から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	Remove	指定した DataGridTableStyle を削除します。
	RemoveAt	指定したインデックス位置にある DataGridTableStyle を削除します。
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクトメソッド

	名前	説明
	Finalize	Object がガベージコレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	MemberwiseClone	オーバーロードされます。 ( MarshalByRefObject から継承されます。)
	OnCollectionChanged	CollectionChanged イベントを発生させます。

明示的インターフェイスの実装

	名前	説明
	System.Collections.ICollection.CopyTo	コレクションを互換性のある 1 次元の Array にコピーします。コピー操作は、コピー先の配列の指定したインデックスから始まります。
	System.Collections.IEnumerable.GetEnumerator	コレクションの列挙子を返します。
	System.Collections.IList.Add	DataGridTableStyle をコレクションに追加します。
	System.Collections.IList.Clear	コレクションを空にします。
	System.Collections.IList.Contains	ある要素がコレクション内に存在するかどうかを判断します。
	System.Collections.IList.IndexOf	コレクション内にある指定したオブジェクトのうち、最初に出現する値の、0 から始まるインデックス番号を返します。
	System.Collections.IList.Insert	Insert メソッドを実装します。常に NotSupportedException をスローします。
	System.Collections.IList.Remove	指定した DataGridTableStyle を削除します。
	System.Collections.IList.RemoveAt	指定したインデックスの DataGridColumnStyle をコレクションから削除します。

参照

GridTableStylesCollection メンバ

DataGrid コントロール内の DataGridTableStyle オブジェクトのコレクションを表します。

GridTableStylesCollection データ型で公開されるメンバを以下の表に示します。

パブリックプロパティ

( プロテクトプロパティも参照)

	名前	説明
	Count	コレクション内の要素の合計数を取得します。(BaseCollection から継承されます。)
	IsReadOnly	コレクションが読み取り専用かどうかを示す値を取得します。(BaseCollection から継承されます。)
	IsSynchronized	ICollection へのアクセスの同期がとられているかどうかを示す値を取得します。(BaseCollection から継承されます。)
	Item	オーバーロードされます。指定した DataGridTableStyle を取得します。
	SyncRoot	BaseCollection へのアクセスを同期するために使用できるオブジェクトを取得します。(BaseCollection から継承されます。)

プロテクトプロパティ

	名前	説明
	List	オーバーライドされます。基になるリストを取得します。

パブリックメソッド

( プロテクトメソッドも参照)

	名前	説明
	Add	DataGridTableStyle をコレクションに追加します。
	AddRange	テーブルスタイルの配列をコレクションに追加します。
	Clear	コレクションを空にします。
	Contains	オーバーロードされます。指定した DataGridTableStyle が GridTableStylesCollection に格納されているかどうかを示す値を取得します。
	CopyTo	指定したコピー先の Array インデックスを開始位置として、現在の 1 次元 Array のすべての要素を指定した 1 次元 Array にコピーします。 (BaseCollection から継承されます。)
	CreateObjRef	リモートオブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。 (MarshalByRefObject から継承されます。)
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetEnumerator	コレクションのメンバを反復処理できるオブジェクトを取得します。 (BaseCollection から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュアルゴリズムや、ハッシュテーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetLifetimeService	対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービスオブジェクトを取得します。 (MarshalByRefObject から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	InitializeLifetimeService	対象のインスタンスの有効期間ポリシーを制御する、有効期間サービスオブジェクトを取得します。 (MarshalByRefObject から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	Remove	指定した DataGridTableStyle を削除します。
	RemoveAt	指定したインデックス位置にある DataGridTableStyle を削除します。
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクトメソッド

	名前	説明
	Finalize	Object がガベージコレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	MemberwiseClone	オーバーロードされます。 ( MarshalByRefObject から継承されます。)
	OnCollectionChanged	CollectionChanged イベントを発生させます。

パブリックイベント

	名前	説明
	CollectionChanged	コレクションが変更された場合に発生します。

明示的インターフェイスの実装

	名前	説明
	System.Collections.ICollection.CopyTo	コレクションを互換性のある 1 次元の Array にコピーします。コピー操作は、コピー先の配列の指定したインデックスから始まります。
	System.Collections.IEnumerable.GetEnumerator	コレクションの列挙子を返します。
	System.Collections.IList.Add	DataGridTableStyle をコレクションに追加します。
	System.Collections.IList.Clear	コレクションを空にします。
	System.Collections.IList.Contains	ある要素がコレクション内に存在するかどうかを判断します。
	System.Collections.IList.IndexOf	コレクション内にある指定したオブジェクトのうち、最初に出現する値の、0 から始まるインデックス番号を返します。
	System.Collections.IList.Insert	Insert メソッドを実装します。常に NotSupportedException をスローします。
	System.Collections.IList.Remove	指定した DataGridTableStyle を削除します。
	System.Collections.IList.RemoveAt	指定したインデックスの DataGridColumnStyle をコレクションから削除します。
	System.Collections.IList.Item	指定したインデックスにある要素を取得または設定します。

参照

GridTableStylesCollectionとは？わかりやすく解説

GridTableStylesCollection イベント

関連項目

GridTableStylesCollection クラス

GridTableStylesCollection プロパティ

関連項目

GridTableStylesCollection メソッド

関連項目

GridTableStylesCollection メンバ

関連項目

「GridTableStylesCollection」の関連用語


	© 2025 Microsoft.All rights reserved.

GridTableStylesCollectionとは？ わかりやすく解説

GridTableStylesCollection イベント

関連項目

GridTableStylesCollection クラス

GridTableStylesCollection プロパティ

関連項目

GridTableStylesCollection メソッド

関連項目

GridTableStylesCollection メンバ

関連項目

急上昇のことば

「GridTableStylesCollection」の関連用語

GridTableStylesCollectionとは？わかりやすく解説