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

Примеры

В следующем примере кода создаются два DataGridTableStyle экземпляра и присваивается свойству MappingName каждого объекта TableName значение объекта DataTable в DataSet. Затем в примере добавляются DataGridColumnStyle объекты в GridColumnStylesCollection объект каждого DataGridTableStyleобъекта . Пример выполнения см. в 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. Чтобы указать, какой DataGridTableStyle из них используется при отображении данных из определенного DataTableобъекта , присвойте MappingName свойству TableNameDataTableзначение .

Объект , GridTableStylesCollection полученный с помощью TableStyles свойства , содержит все объекты, DataGridTableStyle используемые элементом System.Windows.Forms.DataGrid управления . Коллекция может содержать любое необходимое количество DataGridTableStyle объектов, однако MappingName каждый из них должен быть уникальным. Во время выполнения это позволяет заменить разные DataGridTableStyle данные в зависимости от предпочтений пользователя. Для этого выполните следующие действия.

1. Заполните объект объектами GridTableStylesCollectionDataGridTableStyle . Если в объекте существует объект , значение свойства которого MappingName равно свойству DataTableDataTable объектаTableName, отображается с этим DataGridTableStyle.DataGridTableStyleGridTableStylesCollection Если с DataGridTableStyle соответствующим MappingNameзначением не существует , DataTable отображается со стилем по умолчанию для таблиц сетки данных.

2. Если требуется другой стиль сетки Item , используйте свойство , чтобы выбрать соответствующий DataGridTableStyle (передать TableNameItem[] в свойство ) и задать MappingName для возвращаемого объекта новое значение.

3. Используйте свойство , Item[] чтобы выбрать нужный DataGridTableStyleобъект и присвоить TableName ей MappingName значение .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 Если объект содержит DataTable объекты, связанные с помощью DataRelation объектов , и отображаемая DataTable в данный момент таблица является дочерней таблицейDataMember, объект вернет строку в виде TableName.RelationName (в простейшем случае). DataTable Если объект находится ниже в иерархии, строка будет состоять из имени родительской таблицы, за которой следуют значения, необходимые RelationName для достижения уровня таблицы. Например, представьте себе три DataTable объекта в иерархической связи с именами (сверху вниз) Regions, Customersи , а Ordersтакже два DataRelation объекта с именами RegionsToCustomers и CustomersToOrders, DataMember свойство вернет "Regions.RegionsToCustomers.CustomersToOrders". Однако затем MappingName будет иметь значение "Orders".

Коллекция DataGridTableStyle объектов возвращается через TableStyles свойство объекта System.Windows.Forms.DataGrid.

DataGridTableStyle При отображении параметры для DataGridTableStyle будут переопределять параметры элемента System.Windows.Forms.DataGrid управления . Если значение не задано для определенного DataGridTableStyleSystem.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.MappingNametypename значение , где typename заменяется именем типа объекта. Также обратите внимание, что в свойстве MappingName учитывается регистр; имя типа должно быть точно совпадать. Пример см. в MappingName свойстве .

Можно также привязать DataGrid к ArrayList. Особенность заключается в ArrayList том, что он может содержать объекты нескольких типов, но DataGrid может привязаться к такому списку только в том случае, если все элементы в списке имеют тот же тип, что и первый элемент. Это означает, что все объекты должны быть одного типа или наследоваться от того же класса, что и первый элемент в списке. Например, если первым элементом в списке является , вторым элементом Controlможет быть TextBox (который наследуется от Control). Если, с другой стороны, первым элементом TextBoxявляется , второй объект не может быть Control. Кроме того, ArrayList объект должен содержать элементы, если он привязан, а объекты в должны содержать открытые DataGridTableStyle свойства. ArrayList Пустое приведет к пустой сетке. При привязке ArrayListк свойству присвойте MappingName свойству DataGridTableStyle значение ArrayList (имя типа).

Конструкторы

Поля

Свойства

Методы

События

Применяется к

См. также раздел

• DataGrid
• DataGridColumnStyle
• GridColumnStylesCollection
• GridTableStylesCollection