GridTableStylesCollection Clase

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Representa una colección de objetos DataGridTableStyle del control DataGrid .

public ref class GridTableStylesCollection : System::Windows::Forms::BaseCollection, System::Collections::IList

[System.ComponentModel.ListBindable(false)]
public class GridTableStylesCollection : System.Windows.Forms.BaseCollection, System.Collections.IList

[<System.ComponentModel.ListBindable(false)>]
type GridTableStylesCollection = class
    inherit BaseCollection
    interface IList
    interface ICollection
    interface IEnumerable

Public Class GridTableStylesCollection
Inherits BaseCollection
Implements IList

Herencia

Object

MarshalByRefObject

BaseCollection

GridTableStylesCollection

Atributos

ListBindableAttribute

Implementaciones

ICollection IEnumerable IList

Ejemplos

En el ejemplo de código siguiente se crean dos DataGridTableStyle objetos y se agrega cada uno al GridTableStylesCollection devuelto por la TableStyles propiedad de un DataGrid control .

void AddCustomDataTableStyle()
{
   DataGridTableStyle^ ts1 = gcnew DataGridTableStyle;
   ts1->MappingName = "Customers";
   
   // Set other properties.
   ts1->AlternatingBackColor = Color::LightGray;
   
   /* 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";
   
   // Set other properties.
   ts2->AlternatingBackColor = Color::LightBlue;
   
   // Create new ColumnStyle objects.
   DataGridColumnStyle^ cOrderDate = gcnew DataGridTextBoxColumn;
   cOrderDate->MappingName = "OrderDate";
   cOrderDate->HeaderText = "Order Date";
   cOrderDate->Width = 100;
   ts2->GridColumnStyles->Add( cOrderDate );
   
   /*Use a PropertyDescriptor to create a formatted
     column. First get the PropertyDescriptorCollection
     for the data source and data member. */
   System::ComponentModel::PropertyDescriptorCollection^ pcol = this->
       BindingContext[myDataSet, "Customers::custToOrders"]->
       GetItemProperties();
   
   /* Create a formatted column using a PropertyDescriptor.
     The formatting character S"c" specifies a currency format. */
   DataGridColumnStyle^ csOrderAmount =
      gcnew DataGridTextBoxColumn( pcol[ "OrderAmount" ],"c",true );
   csOrderAmount->MappingName = "OrderAmount";
   csOrderAmount->HeaderText = "Total";
   csOrderAmount->Width = 100;
   ts2->GridColumnStyles->Add( csOrderAmount );
   
   /* Add the DataGridTableStyle instances to
     the GridTableStylesCollection. */
   myDataGrid->TableStyles->Add( ts1 );
   myDataGrid->TableStyles->Add( ts2 );
}

private void AddCustomDataTableStyle(){
   DataGridTableStyle ts1 = new DataGridTableStyle();
   ts1.MappingName = "Customers";
   // Set other properties.
   ts1.AlternatingBackColor = Color.LightGray;

   /* 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";

   // Set other properties.
   ts2.AlternatingBackColor = Color.LightBlue;
   
   // Create new ColumnStyle objects.
   DataGridColumnStyle cOrderDate = 
   new DataGridTextBoxColumn();
   cOrderDate.MappingName = "OrderDate";
   cOrderDate.HeaderText = "Order Date";
   cOrderDate.Width = 100;
   ts2.GridColumnStyles.Add(cOrderDate);

   /*Use a PropertyDescriptor to create a formatted
   column. First get the PropertyDescriptorCollection
   for the data source and data member. */
   System.ComponentModel.PropertyDescriptorCollection pcol = 
      this.BindingContext[myDataSet, "Customers.custToOrders"]
      .GetItemProperties();
 
   /* Create a formatted column using a PropertyDescriptor.
   The formatting character "c" specifies a currency format. */     
   DataGridColumnStyle csOrderAmount = 
   new DataGridTextBoxColumn(pcol["OrderAmount"], "c", true);
   csOrderAmount.MappingName = "OrderAmount";
   csOrderAmount.HeaderText = "Total";
   csOrderAmount.Width = 100;
   ts2.GridColumnStyles.Add(csOrderAmount);

   /* Add the DataGridTableStyle instances to 
   the GridTableStylesCollection. */
   myDataGrid.TableStyles.Add(ts1);
   myDataGrid.TableStyles.Add(ts2);
}

Private Sub AddCustomDataTableStyle()
   Dim ts1 As New DataGridTableStyle()
   ts1.MappingName = "Customers"
   ' Set other properties.
   ts1.AlternatingBackColor = Color.LightGray
   ' 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"
     
   ' Set other properties.
   ts2.AlternatingBackColor = Color.LightBlue
     
   ' Create new ColumnStyle objects.
   Dim cOrderDate As New DataGridTextBoxColumn()
   cOrderDate.MappingName = "OrderDate"
   cOrderDate.HeaderText = "Order Date"
   cOrderDate.Width = 100
   ts2.GridColumnStyles.Add(cOrderDate)

   ' Use a PropertyDescriptor to create a formatted
   ' column. First get the PropertyDescriptorCollection
   ' for the data source and data member. 
   Dim pcol As System.ComponentModel.PropertyDescriptorCollection = _
   Me.BindingContext(myDataSet, "Customers.custToOrders"). _
   GetItemProperties()

   ' Create a formatted column using a PropertyDescriptor.
   ' The formatting character "c" specifies a currency format. */     
     
   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 instances to 
   ' the GridTableStylesCollection. 
   myDataGrid.TableStyles.Add(ts1)
   myDataGrid.TableStyles.Add(ts2)
End Sub

Comentarios

GridTableStylesCollection contiene DataGridTableStyle objetos que permiten al DataGrid control mostrar un estilo de cuadrícula personalizado para cada DataTable uno de los objetos de .DataSet

En el DataGrid control , la TableStyles propiedad devuelve .GridTableStylesCollection

De forma predeterminada, GridTableStylesCollection no contiene ningún DataGridTableStyle objeto . En su lugar, DataGrid muestra cada tabla con la configuración predeterminada para el color, el ancho y el formato. Se muestran todas las columnas de cada tabla. Cuando se agrega un objeto DataGridTableStyle a la colección, DataGrid usa para MappingName determinar qué objeto proporciona los datos de la cuadrícula. Por ejemplo, si el origen de datos es un DataSet objeto que contiene tres DataTable objetos, MappingName debe coincidir con el TableName de uno de los objetos . MappingName Si no coincide con ninguno de los TableName valores, se usará la configuración predeterminada para mostrar los datos de cada tabla y se omitirá la DataGridTableStyle configuración.

Precaución

DataGridColumnStyle Cree siempre objetos y agréguelos a GridColumnStylesCollection antes de agregar DataGridTableStyle objetos a .GridTableStylesCollection Cuando se agrega un vacío DataGridTableStyle con un valor válido MappingName a la colección, DataGridColumnStyle los objetos se generan automáticamente. Por lo tanto, se producirá una excepción si intenta agregar nuevos DataGridColumnStyle objetos con valores duplicados MappingName a GridColumnStylesCollection. También puede borrar mediante GridColumnStylesCollection el Clear método .

Propiedades

Count	Obtiene el número total de elementos de la colección. (Heredado de BaseCollection)
IsReadOnly	Obtiene un valor que indica si la colección es de solo lectura. (Heredado de BaseCollection)
IsSynchronized	Obtiene un valor que indica si el acceso a ICollection está sincronizado. (Heredado de BaseCollection)
Item[Int32]	Obtiene el objeto DataGridTableStyle especificado por índice.
Item[String]	Obtiene el objeto DataGridTableStyle con el nombre especificado.
List	Obtiene la lista subyacente.
SyncRoot	Obtiene un objeto que se puede usar para sincronizar el acceso a BaseCollection. (Heredado de BaseCollection)

Métodos

Add(DataGridTableStyle)	Agrega un DataGridTableStyle a la colección.
AddRange(DataGridTableStyle[])	Agrega una matriz de estilos de tabla a la colección.
Clear()	Borra la colección.
Contains(DataGridTableStyle)	Obtiene un valor que indica si la colección GridTableStylesCollection contiene el objeto DataGridTableStyle especificado.
Contains(String)	Obtiene un valor que indica si GridTableStylesCollection contiene el objeto DataGridTableStyle especificado por nombre.
CopyTo(Array, Int32)	Copia todos los elementos del objeto Array unidimensional actual en el objeto Array unidimensional especificado, empezando en el índice especificado del objeto Array de destino. (Heredado de BaseCollection)
CreateObjRef(Type)	Crea un objeto que contiene toda la información relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto. (Heredado de MarshalByRefObject)
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
GetEnumerator()	Obtiene el objeto que permite iterar en los miembros de la colección. (Heredado de BaseCollection)
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetLifetimeService()	Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia. (Heredado de MarshalByRefObject)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
InitializeLifetimeService()	Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia. (Heredado de MarshalByRefObject)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
MemberwiseClone(Boolean)	Crea una copia superficial del objeto MarshalByRefObject actual. (Heredado de MarshalByRefObject)
OnCollectionChanged(CollectionChangeEventArgs)	Genera el evento CollectionChanged.
Remove(DataGridTableStyle)	Quita el objeto DataGridTableStyle especificado.
RemoveAt(Int32)	Quita un objeto DataGridTableStyle en el índice especificado.
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)

Eventos

CollectionChanged

Se produce cuando cambia la colección.

Implementaciones de interfaz explícitas

ICollection.CopyTo(Array, Int32)	Copia la colección en una Array unidimensional compatible, empezando en el índice especificado de la matriz de destino.
ICollection.Count	Obtiene el número de elementos de la colección.
ICollection.IsSynchronized	Obtiene un valor que indica si el acceso a la interfaz GridTableStylesCollection está sincronizado (es seguro para subprocesos).
ICollection.SyncRoot	Obtiene un objeto que se puede utilizar para sincronizar el acceso a la colección.
IEnumerable.GetEnumerator()	Devuelve un enumerador para la colección.
IList.Add(Object)	Agrega un DataGridTableStyle a la colección.
IList.Clear()	Borra la colección.
IList.Contains(Object)	Determina si un elemento se encuentra en la colección.
IList.IndexOf(Object)	Devuelve el índice de base cero de la primera aparición del objeto especificado en la colección.
IList.Insert(Int32, Object)	Implementa el método Insert(Int32, Object). Siempre produce una excepción NotSupportedException.
IList.IsFixedSize	Obtiene un valor que indica si la colección tiene un tamaño fijo.
IList.IsReadOnly	Obtiene un valor que indica si la colección es de solo lectura.
IList.Item[Int32]	Obtiene o establece el elemento en el índice especificado.
IList.Remove(Object)	Quita el objeto DataGridTableStyle especificado.
IList.RemoveAt(Int32)	Quita el objeto DataGridColumnStyle con el índice especificado de la colección.

Métodos de extensión

Cast<TResult>(IEnumerable)	Convierte los elementos de IEnumerable en el tipo especificado.
OfType<TResult>(IEnumerable)	Filtra los elementos de IEnumerable en función de un tipo especificado.
AsParallel(IEnumerable)	Habilita la paralelización de una consulta.
AsQueryable(IEnumerable)	Convierte una interfaz IEnumerable en IQueryable.

Consulte también

• DataGrid
• GridColumnStyles