GridTableStylesCollection クラス

定義

DataGrid コントロールに含まれる DataGridTableStyle オブジェクトのコレクションを表します。Represents a collection of DataGridTableStyle objects in the DataGrid control.

public ref class GridTableStylesCollection : System::Windows::Forms::BaseCollection, System::Collections::IList
[System.ComponentModel.ListBindable(false)]
public class GridTableStylesCollection : System.Windows.Forms.BaseCollection, System.Collections.IList
type GridTableStylesCollection = class
    inherit BaseCollection
    interface IList
    interface ICollection
    interface IEnumerable
Public Class GridTableStylesCollection
Inherits BaseCollection
Implements IList
継承
GridTableStylesCollection
属性
実装

次のコード例ではDataGridTableStyle 、2つのオブジェクトをGridTableStylesCollection作成し、 TableStyles DataGridコントロールのプロパティによって返されるにそれぞれを追加します。The following code example creates two DataGridTableStyle objects and adds each to the GridTableStylesCollection returned by the TableStyles property of a DataGrid control.

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

注釈

DataTable DataGridTableStyle DataGridには、コントロールがの各に対してカスタマイズDataSetされたグリッドスタイルを表示できるようにするオブジェクトが含まれています。GridTableStylesCollectionThe GridTableStylesCollection contains DataGridTableStyle objects that allows the DataGrid control to display a customized grid style for each DataTable in a DataSet.

コントロールでTableStylesGridTableStylesCollection、プロパティはを返します。 DataGridOn the DataGrid control, the TableStyles property returns the GridTableStylesCollection.

既定では、 GridTableStylesCollectionにはDataGridTableStyleオブジェクトが含まれていません。By default, the GridTableStylesCollection does not contain any DataGridTableStyle objects. 代わりに、にDataGridよって、色、幅、および書式設定の既定の設定を使用して各テーブルが表示されます。Instead, the DataGrid displays each table using default settings for color, width, and formatting. 各テーブルのすべての列が表示されます。All columns of each table are displayed. がコレクションに追加されると、はをMappingName 使用して、どのオブジェクトがグリッドのデータを提供するかを判断します。DataGrid DataGridTableStyleWhen a DataGridTableStyle is added to the collection, the DataGrid uses the MappingName to determine which object supplies the data for the grid. たとえば、 DataSetデータソースが3つDataTableのオブジェクトを含むである場合、 MappingNameはいずれかTableNameのオブジェクトのと一致する必要があります。For example, if the data source is a DataSet that contains three DataTable objects, the MappingName must match the TableName of one of the objects. がいずれDataGridTableStyleの値とも一致しない場合は、各テーブルのデータを表示するために既定の設定が使用され、設定は無視されます。 MappingName TableNameIf the MappingName does not match any of the TableName values, the default settings will be used to display data for each table, and the DataGridTableStyle settings will be ignored.

注意事項

オブジェクトをDataGridColumnStyleに追加GridColumnStylesCollection DataGridTableStyle する前に、常にオブジェクトを作成し、にGridTableStylesCollection追加します。Always create DataGridColumnStyle objects and add them to the GridColumnStylesCollection before adding DataGridTableStyle objects to the GridTableStylesCollection. 有効DataGridTableStyle DataGridColumnStyleな値を持つ空のをコレクションに追加すると、オブジェクトが自動的に生成されます。 MappingNameWhen you add an empty DataGridTableStyle with a valid MappingName value to the collection, DataGridColumnStyle objects are automatically generated for you. その結果、重複DataGridColumnStyle MappingNameする値GridColumnStylesCollectionを持つ新しいオブジェクトをに追加しようとすると、例外がスローされます。Consequently, an exception will be thrown if you try to add new DataGridColumnStyle objects with duplicate MappingName values to the GridColumnStylesCollection. または、 ClearメソッドGridColumnStylesCollectionを使用してをクリアします。Alternatively, clear the GridColumnStylesCollection using the Clear method.

プロパティ

Count

コレクション内の要素の合計数を取得します。Gets the total number of elements in the collection.

(継承元 BaseCollection)
IsReadOnly

コレクションが読み取り専用かどうかを示す値を取得します。Gets a value indicating whether the collection is read-only.

(継承元 BaseCollection)
IsSynchronized

ICollection へのアクセスの同期がとられているかどうかを示す値を取得します。Gets a value indicating whether access to the ICollection is synchronized.

(継承元 BaseCollection)
Item[Int32]

インデックスで指定した DataGridTableStyle を取得します。Gets the DataGridTableStyle specified by index.

Item[String]

指定された名前を持つ DataGridTableStyle を取得します。Gets the DataGridTableStyle with the specified name.

List

基になるリストを取得します。Gets the underlying list.

SyncRoot

BaseCollection へのアクセスを同期するために使用できるオブジェクトを取得します。Gets an object that can be used to synchronize access to the BaseCollection.

(継承元 BaseCollection)

メソッド

Add(DataGridTableStyle)

DataGridTableStyle をコレクションに追加します。Adds a DataGridTableStyle to this collection.

AddRange(DataGridTableStyle[])

テーブル スタイルの配列をコレクションに追加します。Adds an array of table styles to the collection.

Clear()

コレクションを空にします。Clears the collection.

Contains(DataGridTableStyle)

指定した GridTableStylesCollectionDataGridTableStyle に格納されているかどうかを示す値を取得します。Gets a value indicating whether the GridTableStylesCollection contains the specified DataGridTableStyle.

Contains(String)

名前で指定した GridTableStylesCollectionDataGridTableStyle に格納されているかどうかを示す値を取得します。Gets a value indicating whether the GridTableStylesCollection contains the DataGridTableStyle specified by name.

CopyTo(Array, Int32)

現在の 1 次元 Array のすべての要素を、指定した 1 次元 ArrayArray の指定したコピー先インデックスを開始位置としてコピーします。Copies all the elements of the current one-dimensional Array to the specified one-dimensional Array starting at the specified destination Array index.

(継承元 BaseCollection)
CreateObjRef(Type)

リモート オブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(継承元 MarshalByRefObject)
Equals(Object)

指定したオブジェクトが、現在のオブジェクトと等しいかどうかを判断します。Determines whether the specified object is equal to the current object.

(継承元 Object)
GetEnumerator()

コレクションのメンバーを反復処理できるオブジェクトを取得します。Gets the object that enables iterating through the members of the collection.

(継承元 BaseCollection)
GetHashCode()

既定のハッシュ関数として機能します。Serves as the default hash function.

(継承元 Object)
GetLifetimeService()

対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービス オブジェクトを取得します。Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(継承元 MarshalByRefObject)
GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(継承元 Object)
InitializeLifetimeService()

このインスタンスの有効期間ポリシーを制御する有効期間サービス オブジェクトを取得します。Obtains a lifetime service object to control the lifetime policy for this instance.

(継承元 MarshalByRefObject)
MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(継承元 Object)
MemberwiseClone(Boolean)

現在の MarshalByRefObject オブジェクトの簡易コピーを作成します。Creates a shallow copy of the current MarshalByRefObject object.

(継承元 MarshalByRefObject)
OnCollectionChanged(CollectionChangeEventArgs)

CollectionChanged イベントを発生させます。Raises the CollectionChanged event.

Remove(DataGridTableStyle)

指定した DataGridTableStyle を削除します。Removes the specified DataGridTableStyle.

RemoveAt(Int32)

指定したインデックス位置にある DataGridTableStyle を削除します。Removes a DataGridTableStyle at the specified index.

ToString()

現在のオブジェクトを表す文字列を返します。Returns a string that represents the current object.

(継承元 Object)

イベント

CollectionChanged

コレクションが変更されたときに発生します。Occurs when the collection has changed.

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

ICollection.CopyTo(Array, Int32)

コレクションを互換性のある 1 次元の Array にコピーします。コピー操作は、コピー先の配列の指定したインデックスから始まります。Copies the collection to a compatible one-dimensional Array, starting at the specified index of the target array.

ICollection.Count

コレクション内の項目の数を取得します。Gets the number of items in the collection.

ICollection.IsSynchronized

GridTableStylesCollection へのアクセスが同期されている (スレッド セーフである) かどうかを示す値を取得します。Gets a value indicating whether access to the GridTableStylesCollection is synchronized (thread safe).

ICollection.SyncRoot

コレクションへのアクセスを同期するために使用できるオブジェクトを取得します。Gets an object that can be used to synchronize access to the collection.

IEnumerable.GetEnumerator()

コレクションの列挙子を返します。Returns an enumerator for the collection.

IList.Add(Object)

DataGridTableStyle をコレクションに追加します。Adds a DataGridTableStyle to this collection.

IList.Clear()

コレクションを空にします。Clears the collection.

IList.Contains(Object)

ある要素がコレクション内に存在するかどうかを判断します。Determines whether an element is in the collection.

IList.IndexOf(Object)

指定したオブジェクトがコレクション内で最初に出現する位置の、0 から始まるインデックスを返します。Returns the zero-based index of the first occurrence of the specified object in the collection.

IList.Insert(Int32, Object)

Insert(Int32, Object) メソッドを実装します。Implements the Insert(Int32, Object) method. 常に NotSupportedException をスローします。Always throws NotSupportedException.

IList.IsFixedSize

コレクションが固定サイズかどうかを示す値を取得します。Gets a value indicating whether the collection has a fixed size.

IList.IsReadOnly

コレクションが読み取り専用かどうかを示す値を取得します。Gets a value indicating whether the collection is read-only.

IList.Item[Int32]

指定したインデックスにある要素を取得または設定します。Gets or sets the element at the specified index.

IList.Remove(Object)

指定した DataGridTableStyle を削除します。Removes the specified DataGridTableStyle.

IList.RemoveAt(Int32)

指定したインデックスの DataGridColumnStyle をコレクションから削除します。Removes the DataGridColumnStyle with the specified index from the collection.

拡張メソッド

Cast<TResult>(IEnumerable)

IEnumerable の要素を、指定した型にキャストします。Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

指定された型に基づいて IEnumerable の要素をフィルター処理します。Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

クエリの並列化を有効にします。Enables parallelization of a query.

AsQueryable(IEnumerable)

IEnumerableIQueryable に変換します。Converts an IEnumerable to an IQueryable.

適用対象

こちらもご覧ください