DataGridTableStyle Класс

Определение

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

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

[System.ComponentModel.Browsable(false)]
[System.Obsolete("`DataGrid` is provided for binary compatibility with .NET Framework and is not intended to be used directly from your code. Use `DataGridView` instead.", false, DiagnosticId="WFDEV006", UrlFormat="https://aka.ms/winforms-warnings/{0}")]
public class DataGridTableStyle : System.ComponentModel.Component, System.Windows.Forms.IDataGridEditingService

type DataGridTableStyle = class
    inherit Component
    interface IDataGridEditingService

[<System.ComponentModel.Browsable(false)>]
[<System.Obsolete("`DataGrid` is provided for binary compatibility with .NET Framework and is not intended to be used directly from your code. Use `DataGridView` instead.", false, DiagnosticId="WFDEV006", UrlFormat="https://aka.ms/winforms-warnings/{0}")>]
type DataGridTableStyle = class
    inherit Component
    interface IDataGridEditingService

Public Class DataGridTableStyle
Inherits Component
Implements IDataGridEditingService

Наследование

Object

MarshalByRefObject

Component

DataGridTableStyle

Атрибуты

BrowsableAttribute ObsoleteAttribute

Реализации

IDataGridEditingService

Примеры

Следующий пример кода создает два DataGridTableStyle экземпляра и задает MappingName для каждого объекта TableName значение a 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 для DataTableTableName параметра значение .

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

1. GridTableStylesCollection DataGridTableStyle Заполните объекты. DataGridTableStyle Если в GridTableStylesCollectionMappingName значении свойства объекта имеется значение, равное DataTable свойству объектаTableName, DataTable отображается с этим DataGridTableStyleзначением. Если сопоставление отсутствует DataGridTableStyleMappingName, DataTable отображается стиль по умолчанию для таблиц сетки данных.

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

3. Item[] Используйте свойство, чтобы выбрать нужный DataGridTableStyleобъект и задать для нее DataTableзначение MappingNameTableName.

Чтобы определить, какой DataGridTableStyle в данный момент отображается, используйте DataSource свойства DataMember возвращаемого System.Windows.Forms.DataGridCurrencyManagerобъекта. Если источник данных реализует 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 объекта в иерархической связи с именем (сверху вниз) CustomersRegionsи два объекта с именемRegionsToCustomers, а Ordersтакже два DataRelation объекта, и CustomersToOrdersDataMember свойство вернет "Regions.RegionsToCustomers.CustomersToOrders". Тем не менее, MappingName затем будет "Заказы".

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

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 свойстве.

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

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

• DataGrid
• DataGridColumnStyle
• GridColumnStylesCollection
• GridTableStylesCollection