GridTableStylesCollection Clase

Definición

Representa una colección de objetos DataGridTableStyle del control DataGrid.Represents a collection of DataGridTableStyle objects in the DataGrid control.

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
type GridTableStylesCollection = class
    inherit BaseCollection
    interface IList
    interface ICollection
    interface IEnumerable
Public Class GridTableStylesCollection
Inherits BaseCollection
Implements IList
Herencia
GridTableStylesCollection
Atributos
Implementaciones

Ejemplos

En el ejemplo de código siguiente DataGridTableStyle se crean dos objetos y se GridTableStylesCollection agrega cada uno TableStyles a la devuelta por la propiedad de un DataGrid control.The following code example creates two DataGridTableStyle objects and adds each to the GridTableStylesCollection returned by the TableStyles property of a 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

DataGrid DataTable Contiene objetos que permiten al control mostrar un estilo de cuadrícula personalizado para cada de un DataSet. GridTableStylesCollection DataGridTableStyleThe GridTableStylesCollection contains DataGridTableStyle objects that allows the DataGrid control to display a customized grid style for each DataTable in a DataSet.

En el DataGrid control, la TableStyles propiedad devuelve GridTableStylesCollection.On the DataGrid control, the TableStyles property returns the GridTableStylesCollection.

De forma predeterminada, GridTableStylesCollection no contiene ningún DataGridTableStyle objeto.By default, the GridTableStylesCollection does not contain any DataGridTableStyle objects. En su lugar, DataGrid muestra cada tabla con la configuración predeterminada para el color, el ancho y el formato.Instead, the DataGrid displays each table using default settings for color, width, and formatting. Se muestran todas las columnas de cada tabla.All columns of each table are displayed. Cuando se DataGridTableStyle agrega un a la colección DataGrid , utiliza MappingName para determinar qué objeto proporciona los datos para la cuadrícula.When a DataGridTableStyle is added to the collection, the DataGrid uses the MappingName to determine which object supplies the data for the grid. Por ejemplo, si el origen de datos es DataSet un que contiene DataTable tres objetos, MappingName el debe coincidir con el TableName de uno de los objetos.For example, if the data source is a DataSet that contains three DataTable objects, the MappingName must match the TableName of one of the objects. 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á DataGridTableStyle la configuración. MappingNameIf the MappingName does not match any of the TableName values, the default settings will be used to display data for each table, and the DataGridTableStyle settings will be ignored.

Precaución

Cree DataGridColumnStyle siempre objetos y agréguelos GridColumnStylesCollection DataGridTableStyle aGridTableStylesCollectionantes de agregar objetos a.Always create DataGridColumnStyle objects and add them to the GridColumnStylesCollection before adding DataGridTableStyle objects to the GridTableStylesCollection. Cuando se agrega un vacío DataGridTableStyle con un valor MappingName válido a la colección, DataGridColumnStyle los objetos se generan automáticamente.When you add an empty DataGridTableStyle with a valid MappingName value to the collection, DataGridColumnStyle objects are automatically generated for you. Por consiguiente, se producirá una excepción si intenta agregar nuevos DataGridColumnStyle objetos con valores duplicados MappingName a. GridColumnStylesCollectionConsequently, an exception will be thrown if you try to add new DataGridColumnStyle objects with duplicate MappingName values to the GridColumnStylesCollection. O bien, desactive GridColumnStylesCollection la mediante Clear el método.Alternatively, clear the GridColumnStylesCollection using the Clear method.

Propiedades

Count

Obtiene el número total de elementos de la colección.Gets the total number of elements in the collection.

(Heredado de BaseCollection)
IsReadOnly

Obtiene un valor que indica si la colección es de solo lectura.Gets a value indicating whether the collection is read-only.

(Heredado de BaseCollection)
IsSynchronized

Obtiene un valor que indica si el acceso a ICollection está sincronizado.Gets a value indicating whether access to the ICollection is synchronized.

(Heredado de BaseCollection)
Item[Int32]

Obtiene el objeto DataGridTableStyle especificado por índice.Gets the DataGridTableStyle specified by index.

Item[String]

Obtiene el objeto DataGridTableStyle con el nombre especificado.Gets the DataGridTableStyle with the specified name.

List

Obtiene la lista subyacente.Gets the underlying list.

SyncRoot

Obtiene un objeto que se puede usar para sincronizar el acceso a BaseCollection.Gets an object that can be used to synchronize access to the BaseCollection.

(Heredado de BaseCollection)

Métodos

Add(DataGridTableStyle)

Agrega un DataGridTableStyle a la colección.Adds a DataGridTableStyle to this collection.

AddRange(DataGridTableStyle[])

Agrega una matriz de estilos de tabla a la colección.Adds an array of table styles to the collection.

Clear()

Borra la colección.Clears the collection.

Contains(DataGridTableStyle)

Obtiene un valor que indica si la colección GridTableStylesCollection contiene el objeto DataGridTableStyle especificado.Gets a value indicating whether the GridTableStylesCollection contains the specified DataGridTableStyle.

Contains(String)

Obtiene un valor que indica si GridTableStylesCollection contiene el objeto DataGridTableStyle especificado por nombre.Gets a value indicating whether the GridTableStylesCollection contains the DataGridTableStyle specified by name.

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.Copies all the elements of the current one-dimensional Array to the specified one-dimensional Array starting at the specified destination Array index.

(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.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Heredado de MarshalByRefObject)
Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Heredado de Object)
GetEnumerator()

Obtiene el objeto que permite iterar en los miembros de la colección.Gets the object that enables iterating through the members of the collection.

(Heredado de BaseCollection)
GetHashCode()

Sirve como función hash predeterminada.Serves as the default hash function.

(Heredado de Object)
GetLifetimeService()

Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Heredado de MarshalByRefObject)
GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Heredado de Object)
InitializeLifetimeService()

Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia.Obtains a lifetime service object to control the lifetime policy for this instance.

(Heredado de MarshalByRefObject)
MemberwiseClone()

Crea una copia superficial del Object actual.Creates a shallow copy of the current Object.

(Heredado de Object)
MemberwiseClone(Boolean)

Crea una copia superficial del objeto MarshalByRefObject actual.Creates a shallow copy of the current MarshalByRefObject object.

(Heredado de MarshalByRefObject)
OnCollectionChanged(CollectionChangeEventArgs)

Genera el evento CollectionChanged.Raises the CollectionChanged event.

Remove(DataGridTableStyle)

Quita el objeto DataGridTableStyle especificado.Removes the specified DataGridTableStyle.

RemoveAt(Int32)

Quita un objeto DataGridTableStyle en el índice especificado.Removes a DataGridTableStyle at the specified index.

ToString()

Devuelve un valor de tipo string que representa el objeto actual.Returns a string that represents the current object.

(Heredado de Object)

Eventos

CollectionChanged

Se produce cuando cambia la colección.Occurs when the collection has changed.

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.Copies the collection to a compatible one-dimensional Array, starting at the specified index of the target array.

ICollection.Count

Obtiene el número de elementos de la colección.Gets the number of items in the collection.

ICollection.IsSynchronized

Obtiene un valor que indica si el acceso a la interfaz GridTableStylesCollection está sincronizado (es seguro para subprocesos).Gets a value indicating whether access to the GridTableStylesCollection is synchronized (thread safe).

ICollection.SyncRoot

Obtiene un objeto que se puede utilizar para sincronizar el acceso a la colección.Gets an object that can be used to synchronize access to the collection.

IEnumerable.GetEnumerator()

Devuelve un enumerador para la colección.Returns an enumerator for the collection.

IList.Add(Object)

Agrega un DataGridTableStyle a la colección.Adds a DataGridTableStyle to this collection.

IList.Clear()

Borra la colección.Clears the collection.

IList.Contains(Object)

Determina si un elemento se encuentra en la colección.Determines whether an element is in the collection.

IList.IndexOf(Object)

Devuelve el índice de base cero de la primera aparición del objeto especificado en la colección.Returns the zero-based index of the first occurrence of the specified object in the collection.

IList.Insert(Int32, Object)

Implementa el método Insert(Int32, Object).Implements the Insert(Int32, Object) method. Siempre produce una excepción NotSupportedException.Always throws NotSupportedException.

IList.IsFixedSize

Obtiene un valor que indica si la colección tiene un tamaño fijo.Gets a value indicating whether the collection has a fixed size.

IList.IsReadOnly

Obtiene un valor que indica si la colección es de solo lectura.Gets a value indicating whether the collection is read-only.

IList.Item[Int32]

Obtiene o establece el elemento en el índice especificado.Gets or sets the element at the specified index.

IList.Remove(Object)

Quita el objeto DataGridTableStyle especificado.Removes the specified DataGridTableStyle.

IList.RemoveAt(Int32)

Quita el objeto DataGridColumnStyle con el índice especificado de la colección.Removes the DataGridColumnStyle with the specified index from the collection.

Métodos de extensión

Cast<TResult>(IEnumerable)

Convierte los elementos de IEnumerable en el tipo especificado.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Filtra los elementos de IEnumerable en función de un tipo especificado.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Habilita la paralelización de una consulta.Enables parallelization of a query.

AsQueryable(IEnumerable)

Convierte una interfaz IEnumerable en IQueryable.Converts an IEnumerable to an IQueryable.

Se aplica a

Consulte también: