DataGridTableStyle Clase

Definición

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

Herencia

Object

MarshalByRefObject

Component

DataGridTableStyle

Implementaciones

IDataGridEditingService

Ejemplos

En el ejemplo de código siguiente se crean dos DataGridTableStyle instancias y se establece el MappingName de cada objeto en el TableName de en DataTable .DataSet A continuación, en el ejemplo se agregan DataGridColumnStyle objetos al GridColumnStylesCollection objeto de cada DataGridTableStyle. Para ver un ejemplo que se ejecuta, vea el System.Windows.Forms.DataGrid ejemplo.

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

Comentarios

El System.Windows.Forms.DataGrid control muestra los datos en forma de cuadrícula. DataGridTableStyle es una clase que representa solo la cuadrícula dibujada. Esta cuadrícula no debe confundirse con la DataTable clase , que es un posible origen de datos para la cuadrícula. En su lugar, representa DataGridTableStyle estrictamente la cuadrícula tal como se pinta en el control. Por lo tanto, a través DataGridTableStyle de puede controlar la apariencia de la cuadrícula para cada DataTable. Para especificar qué DataGridTableStyle se usa al mostrar datos de un determinado DataTable, establezca en MappingName de TableName .DataTable

El GridTableStylesCollection objeto recuperado a través de la TableStyles propiedad contiene todos los DataGridTableStyle objetos utilizados por un System.Windows.Forms.DataGrid control . La colección puede contener tantos DataGridTableStyle objetos como necesite, pero el MappingName de cada uno debe ser único. En tiempo de ejecución, esto le permite sustituir un diferente DataGridTableStyle por los mismos datos, dependiendo de la preferencia del usuario. Para ello, siga estos pasos:

1. Rellene con GridTableStylesCollectionDataGridTableStyle objetos . Si existe en DataGridTableStyle cuyo GridTableStylesCollectionMappingName valor de propiedad es igual a la DataTable propiedad del TableName objeto, DataTable se muestra con este DataGridTableStyleobjeto . Si no existe con DataGridTableStyle un elemento coincidente MappingName, DataTable se muestra con el estilo predeterminado para las tablas de cuadrícula de datos.

2. Cuando se necesite un estilo de cuadrícula diferente, use la Item propiedad para seleccionar el adecuado DataGridTableStyle (pasar el TableName objeto a la Item[] propiedad) y establecer el MappingName del objeto devuelto en un nuevo valor.

3. Use la Item[] propiedad para seleccionar el objeto deseado DataGridTableStyley establezca su MappingName en el TableName de DataTable.

Para determinar qué DataGridTableStyle se muestra actualmente, use las DataSource propiedades y DataMember de System.Windows.Forms.DataGrid para devolver .CurrencyManager Si el origen de datos implementa la ITypedList interfaz , puede usar el GetListName método para devolver la MappingName propiedad de la tabla actual. Esto se muestra en el código de C# siguiente:

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 Si contiene DataTable objetos relacionados a través DataRelation de objetos y el objeto que se DataTable muestra actualmente es una tabla secundaria, DataMember devolverá una cadena en forma de TableName.RelationName (en el caso más sencillo). Si está DataTable más abajo en la jerarquía, la cadena constará del nombre de la tabla primaria seguido de los valores necesarios RelationName para alcanzar el nivel de la tabla. Por ejemplo, imagine tres DataTable objetos de una relación jerárquica denominada (arriba abajo), CustomersRegions, y , y Ordersdos DataRelation objetos denominados RegionsToCustomers y CustomersToOrders, la DataMember propiedad devolverá "Regions.RegionsToCustomers.CustomersToOrders". Sin embargo, el MappingName será "Pedidos".

La colección de DataGridTableStyle objetos se devuelve a través de la TableStyles propiedad de System.Windows.Forms.DataGrid.

Cuando se muestra un DataGridTableStyle , la configuración de DataGridTableStyle invalidará la configuración del System.Windows.Forms.DataGrid control . Si no se establece un valor para una propiedad determinada DataGridTableStyle , se usará el System.Windows.Forms.DataGrid valor del control en su lugar. En la lista siguiente se muestran las DataGridColumnStyle propiedades que se pueden establecer para invalidar System.Windows.Forms.DataGrid las propiedades del control:

• AllowSorting

• AlternatingBackColor

• BackColor

• ColumnHeadersVisible

• ForeColor

• GridLineColor

• GridLineStyle

• HeaderBackColor

• HeaderFont

• HeaderForeColor

• LinkColor

• PreferredColumnWidth

• PreferredRowHeight

• ReadOnly

• RowHeadersVisible

• RowHeaderWidth

• SelectionBackColor

• SelectionForeColor

Para enlazar a DataGrid una matriz fuertemente tipada de objetos, el tipo de objeto debe contener propiedades públicas. Para crear un DataGridTableStyle objeto que muestre la matriz, establezca la DataGridTableStyle.MappingName propiedad typename en donde typename se reemplaza por el nombre del tipo de objeto. Tenga en cuenta también que la MappingName propiedad distingue mayúsculas de minúsculas; el nombre del tipo debe coincidir exactamente. Vea la MappingName propiedad para obtener un ejemplo.

También puede enlazar a DataGrid .ArrayList Una característica de ArrayList es que puede contener objetos de varios tipos, pero solo DataGrid se puede enlazar a dicha lista cuando todos los elementos de la lista tienen el mismo tipo que el primer elemento. Esto significa que todos los objetos deben ser del mismo tipo o deben heredar de la misma clase que el primer elemento de la lista. Por ejemplo, si el primer elemento de una lista es , Controlel segundo elemento podría ser un TextBox elemento (que hereda de Control). Si, por otro lado, el primer elemento es , TextBoxel segundo objeto no puede ser .Control Además, debe ArrayList tener elementos en él cuando está enlazado y los objetos de DataGridTableStyle deben contener propiedades públicas. Un vacío ArrayList dará como resultado una cuadrícula vacía. Cuando se enlaza a , ArrayListestablezca el MappingName de en DataGridTableStyle "ArrayList" (el nombre de tipo).

Constructores

Campos

Propiedades

Métodos

Eventos

Se aplica a

Consulte también

• DataGrid
• DataGridColumnStyle
• GridColumnStylesCollection
• GridTableStylesCollection