DataGridTableStyle クラス

定義

public ref class DataGridTableStyle : System::ComponentModel::Component, System::Windows::Forms::IDataGridEditingService

public class DataGridTableStyle : System.ComponentModel.Component, System.Windows.Forms.IDataGridEditingService

type DataGridTableStyle = class
    inherit Component
    interface IDataGridEditingService

Public Class DataGridTableStyle
Inherits Component
Implements IDataGridEditingService

継承

Object

MarshalByRefObject

Component

DataGridTableStyle

実装

IDataGridEditingService

例

次のコード例では、2 つのDataGridTableStyleインスタンスを作成し、各オブジェクトの を MappingName 内DataSetの の DataTable にTableName設定します。 次に、各 DataGridTableStyleの にオブジェクトをGridColumnStylesCollection追加DataGridColumnStyleします。 を実行する例については、 の例を System.Windows.Forms.DataGrid 参照してください。

void AddCustomDataTableStyle()
{
   
   /* Create a new DataGridTableStyle and set
         its MappingName to the TableName of a DataTable. */
   DataGridTableStyle^ ts1 = gcnew DataGridTableStyle;
   ts1->MappingName = "Customers";
   
   /* 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";
   
   // Change the colors.
   ts2->ForeColor = Color::Yellow;
   ts2->AlternatingBackColor = Color::Blue;
   ts2->BackColor = Color::Blue;
   
   // Create new DataGridColumnStyle objects.
   DataGridColumnStyle^ cOrderDate = gcnew DataGridTextBoxColumn;
   cOrderDate->MappingName = "OrderDate";
   cOrderDate->HeaderText = "Order Date";
   cOrderDate->Width = 100;
   ts2->GridColumnStyles->Add( cOrderDate );
   PropertyDescriptorCollection^ pcol = this->BindingContext[ myDataSet,"Customers.custToOrders" ]->GetItemProperties();
   DataGridColumnStyle^ csOrderAmount = gcnew DataGridTextBoxColumn( pcol[ "OrderAmount" ],"c",true );
   csOrderAmount->MappingName = "OrderAmount";
   csOrderAmount->HeaderText = "Total";
   csOrderAmount->Width = 100;
   ts2->GridColumnStyles->Add( csOrderAmount );
   
   // Add the DataGridTableStyle objects to the collection.
   myDataGrid->TableStyles->Add( ts1 );
   myDataGrid->TableStyles->Add( ts2 );
}

private void AddCustomDataTableStyle()
   {
      /* Create a new DataGridTableStyle and set
      its MappingName to the TableName of a DataTable. */
      DataGridTableStyle ts1 = new DataGridTableStyle();
      ts1.MappingName = "Customers";

      /* 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";
      // Change the colors.
      ts2.ForeColor = Color.Yellow;
      ts2.AlternatingBackColor = Color.Blue;
      ts2.BackColor = Color.Blue;
      
      // Create new DataGridColumnStyle objects.
      DataGridColumnStyle cOrderDate = 
      new DataGridTextBoxColumn();
      cOrderDate.MappingName = "OrderDate";
      cOrderDate.HeaderText = "Order Date";
      cOrderDate.Width = 100;
      ts2.GridColumnStyles.Add(cOrderDate);

      PropertyDescriptorCollection pcol = this.BindingContext
      [myDataSet, "Customers.custToOrders"].GetItemProperties();
      
      DataGridColumnStyle csOrderAmount = 
      new DataGridTextBoxColumn(pcol["OrderAmount"], "c", true);
      csOrderAmount.MappingName = "OrderAmount";
      csOrderAmount.HeaderText = "Total";
      csOrderAmount.Width = 100;
      ts2.GridColumnStyles.Add(csOrderAmount);

      // Add the DataGridTableStyle objects to the collection.
      myDataGrid.TableStyles.Add(ts1);
      myDataGrid.TableStyles.Add(ts2);
   }

Private Sub AddCustomDataTableStyle()
    ' Create a new DataGridTableStyle and set
    ' its MappingName to the TableName of a DataTable. 
    Dim ts1 As New DataGridTableStyle()
    ts1.MappingName = "Customers"
    
    ' 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"

    ' Change the colors.
    ts2.ForeColor = Color.Yellow
    ts2.AlternatingBackColor = Color.Blue
    ts2.BackColor = Color.Blue
    
    ' Create new DataGridColumnStyle objects.
    Dim cOrderDate As New DataGridTextBoxColumn()
    cOrderDate.MappingName = "OrderDate"
    cOrderDate.HeaderText = "Order Date"
    cOrderDate.Width = 100
    ts2.GridColumnStyles.Add(cOrderDate)
    
    Dim pcol As PropertyDescriptorCollection = Me.BindingContext(myDataSet, "Customers.custToOrders").GetItemProperties()
    
    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 objects to the collection.
    myDataGrid.TableStyles.Add(ts1)
    myDataGrid.TableStyles.Add(ts2)
End Sub

注釈

コントロールは System.Windows.Forms.DataGrid 、グリッドの形式でデータを表示します。 DataGridTableStyleは、描画されたグリッドのみを表すクラスです。 このグリッドは、 クラスと DataTable 混同しないでください。これは、グリッドのデータソースとして考えられます。 代わりに、 は DataGridTableStyle コントロールで描画されるグリッドを厳密に表します。 したがって、 を DataGridTableStyle 使用して、各 DataTableのグリッドの外観を制御できます。 特定DataTableの からのデータを表示するときに使用するDataGridTableStyleを指定するには、 を MappingName の DataTableにTableName設定します。

GridTableStylesCollectionプロパティを通じて取得された にはTableStyles、コントロールによって使用されるすべてのDataGridTableStyleオブジェクトがSystem.Windows.Forms.DataGrid含まれます。 コレクションには必要な数の DataGridTableStyle オブジェクトを含めることができますが、それぞれの オブジェクトは MappingName 一意である必要があります。 実行時に、これにより、ユーザーの好みに応じて、同じデータに対して別 DataGridTableStyle の を置き換えることができます。 これを行うには、次の手順を実行します。

1. オブジェクトを設定DataGridTableStyleしますGridTableStylesCollection。 DataGridTableStyleプロパティ値がオブジェクトTableNameの プロパティとMappingName等しい が にGridTableStylesCollection存在するDataTable場合は、 DataTable がこの DataGridTableStyleと共に表示されます。 一致する MappingNameDataTable が存在しないDataGridTableStyle場合、 はデータ グリッド テーブルの既定のスタイルで表示されます。

2. 別のグリッド スタイルが必要な場合は、 プロパティをItem使用して適切なDataGridTableStyleを選択し (プロパティに をTableNameItem[]渡す)、返されたオブジェクトの をMappingName新しい値に設定します。

3. プロパティを Item[] 使用して目的 DataGridTableStyleの を選択し、その を MappingName の に TableName 設定します DataTable。

現在表示されているのを DataGridTableStyle 確認するには、 の DataSource プロパティと DataMember プロパティを System.Windows.Forms.DataGrid 使用して を CurrencyManager返します。 データ ソースで インターフェイスが実装されている ITypedList 場合は、 メソッドを GetListName 使用して現在のテーブルの を MappingName 返すことができます。 これは、次の C# コードに示されています。

private void PrintCurrentListName(DataGrid myDataGrid){  
 CurrencyManager myCM = (CurrencyManager)  
 BindingContext[myDataGrid.DataSource, myDataGrid.DataMember];  
 IList myList = myCM.List;  
 ITypedList thisList = (ITypedList) myList;  
 Console.WriteLine(thisList.GetListName(null));  
}  

に DataSet オブジェクトにDataRelation関連するオブジェクトが含まれておりDataTable、現在表示されている DataTable が子テーブルの場合、 DataMember は TableName.RelationName の形式で文字列を返します (最も簡単な場合)。 DataTableが階層のさらに下にある場合、文字列は親テーブルの名前の後にテーブルのレベルに到達するために必要なRelationName値で構成されます。 たとえば、(上から下) CustomersOrdersRegions、 という名前の階層関係にある 3 つのDataTableオブジェクトと、 および CustomersToOrdersDataMember という名前RegionsToCustomersの 2 つのDataRelationオブジェクトを想像すると、プロパティは "Regions.RegionsToCustomers.CustomersToOrders" を返します。 ただし、 MappingName は "Orders" になります。

オブジェクトのDataGridTableStyleコレクションは、 の プロパティSystem.Windows.Forms.DataGridをTableStyles通じて返されます。

DataGridTableStyleが表示されると、 のDataGridTableStyle設定によってコントロールの設定がSystem.Windows.Forms.DataGridオーバーライドされます。 特定 DataGridTableStyle のプロパティに値が設定されていない場合は、 System.Windows.Forms.DataGrid 代わりにコントロールの値が使用されます。 次の一覧は、コントロールのプロパティを DataGridColumnStyle オーバーライド System.Windows.Forms.DataGrid するように設定できるプロパティを示しています。

• AllowSorting

• AlternatingBackColor

• BackColor

• ColumnHeadersVisible

• ForeColor

• GridLineColor

• GridLineStyle

• HeaderBackColor

• HeaderFont

• HeaderForeColor

• LinkColor

• PreferredColumnWidth

• PreferredRowHeight

• ReadOnly

• RowHeadersVisible

• RowHeaderWidth

• SelectionBackColor

• SelectionForeColor

をオブジェクトの DataGrid 厳密に型指定された配列にバインドするには、オブジェクト型にパブリック プロパティが含まれている必要があります。 配列を表示する を DataGridTableStyle 作成するには、 プロパティを DataGridTableStyle.MappingName に typename 設定します。ここで typename 、 はオブジェクト型の名前に置き換えられます。 また、 MappingName プロパティでは大文字と小文字が区別されます。型名は正確に一致する必要があります。 例については、 MappingName プロパティを参照してください。

を にArrayListバインドDataGridすることもできます。 の特徴は、複数の ArrayList 型のオブジェクトを含めることができるが、 は、リスト内のすべての項目が DataGrid 最初の項目と同じ型の場合にのみ、そのようなリストにバインドできることです。 つまり、すべてのオブジェクトが同じ型であるか、リスト内の最初の項目と同じクラスから継承する必要があります。 たとえば、リスト内の最初の項目が の場合、Control2 番目の項目は ( からControl継承される) である可能性がありますTextBox。 一方、最初の項目が の TextBox場合、2 番目のオブジェクトを に Controlすることはできません。 さらに、 ArrayList にバインドされている場合は 項目が含まれている必要があり、 内の オブジェクトにはパブリック プロパティが DataGridTableStyle 含まれている必要があります。 空 ArrayList の場合、グリッドは空になります。 にArrayListバインドする場合は、 の DataGridTableStyle を MappingName "ArrayList" (型名) に設定します。

コンストラクター

フィールド

プロパティ

メソッド

イベント

適用対象

こちらもご覧ください

• DataGrid
• DataGridColumnStyle
• GridColumnStylesCollection
• GridTableStylesCollection