DataGridTableStyle Classe

Definição

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

Herança

Object

MarshalByRefObject

Component

DataGridTableStyle

Implementações

IDataGridEditingService

Exemplos

O seguinte exemplo de código cria duas DataGridTableStyle instâncias e define o MappingName de cada objeto para o TableName de a DataTable num DataSet. O exemplo então adiciona DataGridColumnStyle objetos ao GridColumnStylesCollection de cada DataGridTableStyle. Para um exemplo que executa, veja o exemplo 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

Observações

O controlo System.Windows.Forms.DataGrid apresenta os dados sob a forma de uma grelha. A DataGridTableStyle é uma classe que representa apenas a grelha desenhada. Esta grelha não deve ser confundida com a DataTable classe, que é uma possível fonte de dados para a grelha. Em vez disso, o DataGridTableStyle representa estritamente a grelha tal como está pintada no controlo. Portanto, através de , DataGridTableStyle pode controlar a aparência da grelha para cada DataTable. Para especificar qual DataGridTableStyle é usado ao exibir dados de um determinado DataTable, defina o MappingName para o TableName de um DataTable.

O GridTableStylesCollection recuperado através da propriedade TableStyles contém todos os objetos DataGridTableStyle usados por um controlo System.Windows.Forms.DataGrid. A coleção pode conter tantos DataGridTableStyle objetos quanto precisares, no entanto, cada MappingName um deve ser único. Em tempo de execução, isto permite substituir um diferente DataGridTableStyle pelos mesmos dados, dependendo da preferência do utilizador. Para efetuar este procedimento:

1. Preenche-os GridTableStylesCollection com DataGridTableStyle objetos. Se existe um DataGridTableStyle em cujo GridTableStylesCollectionMappingName valor de propriedade é igual à DataTable propriedade TableName do objeto, o DataTable é apresentado com este DataGridTableStyle. Se não DataGridTableStyle existir com uma correspondência MappingName, o DataTable é exibido com o estilo padrão para tabelas de grelha de dados.

2. Quando for necessário um estilo de grelha diferente, use a Item propriedade para selecionar o apropriado DataGridTableStyle (passar o TableName para a Item[] propriedade) e definir o MappingName do objeto devolvido com um novo valor.

3. Use a Item[] propriedade para selecionar o desejado DataGridTableStyle, e defina como MappingName o TableName de .DataTable

Para determinar qual DataGridTableStyle está atualmente apresentado, use as propriedades DataSource e DataMember do System.Windows.Forms.DataGrid para devolver um CurrencyManager. Se a fonte de dados implementar a ITypedList interface, pode usar o GetListName método para devolver o MappingName da tabela atual. Isto é mostrado no código C# abaixo:

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

Se o DataSet contém DataTable objetos relacionados através dos DataRelation objetos, e o atualmente apresentado DataTable for uma tabela filha, o DataMember retornará uma cadeia na forma NomeTabela.NomeRelação (no caso mais simples). Se o DataTable estiver mais abaixo na hierarquia, a cadeia consistirá no nome da tabela pai seguido dos valores necessários RelationName para atingir o nível da tabela. Por exemplo, imagine três DataTable objetos numa relação hierárquica nomeada (de cima para baixo) Regions, Customers, e Orders, e dois DataRelation objetos nomeados RegionsToCustomers e CustomersToOrders, a DataMember propriedade devolverá "Regions.RegionsToCustomers.CustomersToOrders". No entanto, MappingName serão então "Ordens".

A coleção de objetos DataGridTableStyle é devolvida através da propriedade TableStyles do System.Windows.Forms.DataGrid.

Quando um DataGridTableStyle é exibido, as definições do DataGridTableStyle sobrepõem-se às definições do controlo System.Windows.Forms.DataGrid. Se não for definido um valor para uma determinada propriedade DataGridTableStyle, será usado o valor do controlo System.Windows.Forms.DataGrid em vez disso. A lista seguinte mostra as propriedades DataGridColumnStyle que podem ser definidas para sobrepor propriedades de controlo System.Windows.Forms.DataGrid:

• AllowSorting

• AlternatingBackColor

• BackColor

• ColumnHeadersVisible

• ForeColor

• GridLineColor

• GridLineStyle

• HeaderBackColor

• HeaderFont

• HeaderForeColor

• LinkColor

• PreferredColumnWidth

• PreferredRowHeight

• ReadOnly

• RowHeadersVisible

• RowHeaderWidth

• SelectionBackColor

• SelectionForeColor

Para associar o DataGrid a um array fortemente tipado de objetos, o tipo de objeto deve conter propriedades públicas. Para criar um DataGridTableStyle que mostre o array, defina a DataGridTableStyle.MappingName propriedade para typename onde typename é substituída pelo nome do tipo de objeto. Note também que a MappingName propriedade é distinta a maiúsculas e minúsculas; o nome do tipo deve ser correspondido exatamente. Veja a MappingName propriedade para um exemplo.

Também pode associar o DataGrid a um ArrayList. Uma característica do ArrayList é que pode conter objetos de vários tipos, mas DataGrid só pode ser ligado a tal lista quando todos os itens da lista forem do mesmo tipo que o primeiro. Isto significa que todos os objetos devem ser do mesmo tipo, ou devem herdar da mesma classe que o primeiro item da lista. Por exemplo, se o primeiro item numa lista for um Control, o segundo item pode ser um TextBox (que herda de Control). Se, por outro lado, o primeiro item for um TextBox, o segundo objeto não pode ser um Control. Além disso, os ArrayList devem ter itens quando estão vinculados e os objetos devem DataGridTableStyle conter propriedades públicas. Um vazio ArrayList resultará numa grelha vazia. Ao ligar a um ArrayList, defina o MappingName de para DataGridTableStyle "ArrayList" (o nome do tipo).

Ver também

• DataGrid
• DataGridColumnStyle
• GridColumnStylesCollection
• GridTableStylesCollection