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 .The following code example creates two DataGridTableStyle instances and sets the MappingName of each object to the TableName of a DataTable in a DataSet. Затем в примере добавляются DataGridColumnStyle объекты для GridColumnStylesCollection каждого из них DataGridTableStyle .The example then adds DataGridColumnStyle objects to the GridColumnStylesCollection of each DataGridTableStyle. Пример, который выполняется, см. в System.Windows.Forms.DataGrid примере.For an example that runs, see the System.Windows.Forms.DataGrid example.

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Элемент управления отображает данные в виде сетки.The System.Windows.Forms.DataGrid control displays data in the form of a grid. DataGridTableStyle— Это класс, представляющий только отрисованную сетку.The DataGridTableStyle is a class that represents the drawn grid only. Эту сетку не следует путать с DataTable классом, который является возможным источником данных для сетки.This grid should not be confused with the DataTable class, which is a possible source of data for the grid. Вместо этого DataGridTableStyle строго представляет сетку в том виде, в котором она закрашивается в элементе управления.Instead, the DataGridTableStyle strictly represents the grid as it is painted in the control. Таким образом, с помощью можно DataGridTableStyle управлять внешним видом сетки для каждого из них DataTable .Therefore, through the DataGridTableStyle you can control the appearance of the grid for each DataTable. Чтобы указать, какой параметр DataGridTableStyle используется при отображении данных из определенного DataTable объекта, задайте для значение свойства MappingName TableName DataTable .To specify which DataGridTableStyle is used when displaying data from a particular DataTable, set the MappingName to the TableName of a DataTable.

Объект, GridTableStylesCollection полученный с помощью TableStyles свойства, содержит все DataGridTableStyle объекты, используемые System.Windows.Forms.DataGrid элементом управления.The GridTableStylesCollection retrieved through the TableStyles property contains all the DataGridTableStyle objects used by a System.Windows.Forms.DataGrid control. Коллекция может содержать столько DataGridTableStyle объектов, сколько требуется, однако MappingName каждый из них должен быть уникальным.The collection can contain as many DataGridTableStyle objects as you need, however the MappingName of each must be unique. Во время выполнения это позволяет заменить DataGridTableStyle одни и те же данные в зависимости от предпочтений пользователя.At run time, this allows you to substitute a different DataGridTableStyle for the same data, depending on the user's preference. Выполните указанные ниже действия.To do this:

1. Заполните GridTableStylesCollection DataGridTableStyle объекты объектами.Populate the GridTableStylesCollection with DataGridTableStyle objects. Если DataGridTableStyle свойство существует в GridTableStylesCollection MappingName свойстве, значение которого равно DataTable TableName свойству объекта, то DataTable отображается с этим объектом DataGridTableStyle .If a DataGridTableStyle exists in the GridTableStylesCollection whose MappingName property value equals the DataTable object's TableName property, the DataTable is displayed with this DataGridTableStyle. Если DataGridTableStyle с соответствующим именем не существует MappingName , DataTable отображается с использованием стиля по умолчанию для таблиц сетки данных.If no DataGridTableStyle exists with a matching MappingName, the DataTable is displayed with the default style for data grid tables.

2. Если требуется другой стиль сетки, используйте Item свойство, чтобы выбрать соответствующий параметр DataGridTableStyle (передать в TableName Item[] свойство) и присвоить MappingName возвращаемому объекту новое значение.When a different grid style is needed, use the Item property to select the appropriate DataGridTableStyle (pass the TableName to the Item[] property) and set the MappingName of the returned object to a new value.

3. Используйте Item[] свойство, чтобы выбрать нужное значение DataGridTableStyle , и задайте для него значение свойства MappingName TableName DataTable .Use the Item[] property to select the desired DataGridTableStyle, and set its MappingName to the TableName of the DataTable.

Чтобы определить DataGridTableStyle , какие в настоящий момент отображаются, DataSource Используйте DataMember Свойства и объекта, System.Windows.Forms.DataGrid чтобы получить CurrencyManager .To determine which DataGridTableStyle is currently displayed, use the DataSource and DataMember properties of the System.Windows.Forms.DataGrid to return a CurrencyManager. Если источник данных реализует ITypedList интерфейс, можно использовать GetListName метод для возврата MappingName текущей таблицы.If the data source implements the ITypedList interface, you can use the GetListName method to return the MappingName of the current table. Это показано в следующем коде C#:This is shown in the C# code below:

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. релатионнаме (в самом простом случае).If the DataSet contains DataTable objects related through DataRelation objects, and the currently displayed DataTable is a child table, the DataMember will return a string in the form of TableName.RelationName (in the simplest case). Если объект DataTable находится дальше в иерархии, строка будет состоять из имени родительской таблицы, за которым следуют необходимые значения, RelationName необходимые для достижения уровня таблицы.If the DataTable is further down in the hierarchy, the string will consist of the parent table's name followed by the necessary RelationName values required to reach the table's level. Например, представьте три DataTable объекта в иерархической связи с именами (сверху вниз) Regions , Customers , и и Orders два DataRelation объекта с именем RegionsToCustomers и CustomersToOrders , DataMember свойство будет возвращать "regions. регионстокустомерс. кустомерстурдерс".For example, imagine three DataTable objects in a hierarchical relationship named (top to bottom) Regions, Customers, and Orders, and two DataRelation objects named RegionsToCustomers and CustomersToOrders, the DataMember property will return "Regions.RegionsToCustomers.CustomersToOrders". Тем не менее, MappingName затем будет «Orders».However, the MappingName will then be "Orders".

Коллекция DataGridTableStyle объектов возвращается через TableStyles свойство объекта System.Windows.Forms.DataGrid .The collection of DataGridTableStyle objects is returned through the TableStyles property of the System.Windows.Forms.DataGrid.

Если DataGridTableStyle отображается, параметры для DataGridTableStyle элемента управления будут переопределены System.Windows.Forms.DataGrid .When a DataGridTableStyle is displayed, the settings for the DataGridTableStyle will override the settings for the System.Windows.Forms.DataGrid control. Если значение не задано для конкретного DataGridTableStyle свойства, System.Windows.Forms.DataGrid вместо него будет использоваться значение элемента управления.If a value is not set for a particular DataGridTableStyle property, the System.Windows.Forms.DataGrid control's value will be used instead. В следующем списке показаны DataGridColumnStyle свойства, которые можно задать для переопределения System.Windows.Forms.DataGrid свойств элемента управления:The following list shows the DataGridColumnStyle properties that can be set to override System.Windows.Forms.DataGrid control properties:

• AllowSorting

• AlternatingBackColor

• BackColor

• ColumnHeadersVisible

• ForeColor

• GridLineColor

• GridLineStyle

• HeaderBackColor

• HeaderFont

• HeaderForeColor

• LinkColor

• PreferredColumnWidth

• PreferredRowHeight

• ReadOnly

• RowHeadersVisible

• RowHeaderWidth

• SelectionBackColor

• SelectionForeColor

Для привязки DataGrid к строго типизированному массиву объектов тип объекта должен содержать открытые свойства.To bind the DataGrid to a strongly typed array of objects, the object type must contain public properties. Чтобы создать объект DataGridTableStyle , отображающий массив, установите DataGridTableStyle.MappingName для свойства значение typename WHERE, которое typename заменяется именем типа объекта.To create a DataGridTableStyle that displays the array, set the DataGridTableStyle.MappingName property to typename where typename is replaced by the name of the object type. Также обратите внимание, что в MappingName свойстве учитывается регистр; имя типа должно точно совпадать.Also note that the MappingName property is case-sensitive; the type name must be matched exactly. Пример см MappingName . в свойстве.See the MappingName property for an example.

Можно также привязать DataGrid к ArrayList .You can also bind the DataGrid to an ArrayList. Функция в заключается в том ArrayList , что она может содержать объекты нескольких типов, но DataGrid может быть привязана только к такому списку, только если все элементы в списке имеют тот же тип, что и первый элемент.A feature of the ArrayList is that it can contain objects of multiple types, but the DataGrid can only bind to such a list when all items in the list are of the same type as the first item. Это означает, что все объекты должны быть одного типа или наследоваться от того же класса, что и первый элемент в списке.This means that all objects must either be of the same type, or they must inherit from the same class as the first item in the list. Например, если первый элемент в списке — Control , то второй элемент может быть объектом TextBox (который наследуется от Control ).For example, if the first item in a list is a Control, the second item could be a TextBox (which inherits from Control). Если, с другой стороны, первый элемент — TextBox , второй объект не может быть Control .If, on the other hand, the first item is a TextBox, the second object cannot be a Control. Кроме того, элемент ArrayList должен содержать в нем элементы, если он привязан, а объекты в DataGridTableStyle должны иметь открытые свойства.Further, the ArrayList must have items in it when it is bound and the objects in the DataGridTableStyle must contain public properties. Пустая ArrayList Сетка приведет к пустой сетке.An empty ArrayList will result in an empty grid. При привязке к ArrayList присвойте свойству значение MappingName DataGridTableStyle ArrayList (имя типа).When binding to an ArrayList, set the MappingName of the DataGridTableStyle to "ArrayList" (the type name).

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

Поля

Свойства

Методы

События

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

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

• DataGrid
• DataGridColumnStyle
• GridColumnStylesCollection
• GridTableStylesCollection