GridTableStylesCollection Classe

Définition

Représente une collection d’objets DataGridTableStyle dans le contrôle 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
Héritage
GridTableStylesCollection
Attributs
Implémente

Exemples

L’exemple de code suivant crée deux objets DataGridTableStyle et ajoute chacun aux GridTableStylesCollection retournés par la propriété TableStyles d’un contrôle DataGrid.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

Remarques

Le GridTableStylesCollection contient des objets DataGridTableStyle qui permettent au contrôle DataGrid d’afficher un style de grille personnalisé pour chaque DataTable dans une DataSet.The GridTableStylesCollection contains DataGridTableStyle objects that allows the DataGrid control to display a customized grid style for each DataTable in a DataSet.

Sur le contrôle DataGrid, la propriété TableStyles retourne le GridTableStylesCollection.On the DataGrid control, the TableStyles property returns the GridTableStylesCollection.

Par défaut, le GridTableStylesCollection ne contient aucun objet DataGridTableStyle.By default, the GridTableStylesCollection does not contain any DataGridTableStyle objects. Au lieu de cela, le DataGrid affiche chaque table en utilisant les paramètres par défaut pour la couleur, la largeur et la mise en forme.Instead, the DataGrid displays each table using default settings for color, width, and formatting. Toutes les colonnes de chaque table sont affichées.All columns of each table are displayed. Lorsqu’un DataGridTableStyle est ajouté à la collection, le DataGrid utilise le MappingName pour déterminer l’objet qui fournit les données de la grille.When a DataGridTableStyle is added to the collection, the DataGrid uses the MappingName to determine which object supplies the data for the grid. Par exemple, si la source de données est un DataSet qui contient trois objets DataTable, le MappingName doit correspondre à la TableName de l’un des objets.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 le MappingName ne correspond à aucune des valeurs de TableName, les paramètres par défaut sont utilisés pour afficher les données de chaque table, et les paramètres de DataGridTableStyle sont ignorés.If 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.

Attention

Créez toujours DataGridColumnStyle objets et ajoutez-les au GridColumnStylesCollection avant d’ajouter des objets DataGridTableStyle au GridTableStylesCollection.Always create DataGridColumnStyle objects and add them to the GridColumnStylesCollection before adding DataGridTableStyle objects to the GridTableStylesCollection. Lorsque vous ajoutez un DataGridTableStyle vide avec une valeur de MappingName valide à la collection, DataGridColumnStyle objets sont automatiquement générés pour vous.When you add an empty DataGridTableStyle with a valid MappingName value to the collection, DataGridColumnStyle objects are automatically generated for you. Par conséquent, une exception est levée si vous essayez d’ajouter de nouveaux objets DataGridColumnStyle avec des valeurs de MappingName en double au GridColumnStylesCollection.Consequently, an exception will be thrown if you try to add new DataGridColumnStyle objects with duplicate MappingName values to the GridColumnStylesCollection. Vous pouvez également effacer le GridColumnStylesCollection à l’aide de la méthode Clear.Alternatively, clear the GridColumnStylesCollection using the Clear method.

Propriétés

Count

Obtient le nombre total d'éléments dans la collection.Gets the total number of elements in the collection.

(Hérité de BaseCollection)
IsReadOnly

Obtient une valeur indiquant si la collection est en lecture seule.Gets a value indicating whether the collection is read-only.

(Hérité de BaseCollection)
IsSynchronized

Obtient une valeur indiquant si l’accès à ICollection est synchronisé.Gets a value indicating whether access to the ICollection is synchronized.

(Hérité de BaseCollection)
Item[Int32]

Obtient le DataGridTableStyle spécifié par index.Gets the DataGridTableStyle specified by index.

Item[String]

Obtient l'objet DataGridTableStyle portant le nom spécifié.Gets the DataGridTableStyle with the specified name.

List

Obtient la liste sous-jacente.Gets the underlying list.

SyncRoot

Obtient un objet qui peut être utilisé pour synchroniser l'accès à BaseCollection.Gets an object that can be used to synchronize access to the BaseCollection.

(Hérité de BaseCollection)

Méthodes

Add(DataGridTableStyle)

Ajoute un DataGridTableStyle à cette collection.Adds a DataGridTableStyle to this collection.

AddRange(DataGridTableStyle[])

Ajoute un tableau de styles de table à la collection.Adds an array of table styles to the collection.

Clear()

Efface la collection.Clears the collection.

Contains(DataGridTableStyle)

Obtient une valeur indiquant si GridTableStylesCollection contient le DataGridTableStyle spécifié.Gets a value indicating whether the GridTableStylesCollection contains the specified DataGridTableStyle.

Contains(String)

Obtient une valeur indiquant si GridTableStylesCollection contient le DataGridTableStyle spécifié par nom.Gets a value indicating whether the GridTableStylesCollection contains the DataGridTableStyle specified by name.

CopyTo(Array, Int32)

Copie tous les éléments du Array unidimensionnel en cours dans le Array unidimensionnel spécifié en commençant à l'index Array de destination spécifié.Copies all the elements of the current one-dimensional Array to the specified one-dimensional Array starting at the specified destination Array index.

(Hérité de BaseCollection)
CreateObjRef(Type)

Crée un objet contenant toutes les informations appropriées requises pour générer un proxy permettant de communiquer avec un objet distant.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Hérité de MarshalByRefObject)
Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.Determines whether the specified object is equal to the current object.

(Hérité de Object)
GetEnumerator()

Obtient l'objet qui permet l'itération au sein des membres de la collection.Gets the object that enables iterating through the members of the collection.

(Hérité de BaseCollection)
GetHashCode()

Sert de fonction de hachage par défaut.Serves as the default hash function.

(Hérité de Object)
GetLifetimeService()

Récupère l'objet de service de durée de vie en cours qui contrôle la stratégie de durée de vie de cette instance.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Hérité de MarshalByRefObject)
GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Hérité de Object)
InitializeLifetimeService()

Obtient un objet de service de durée de vie pour contrôler la stratégie de durée de vie de cette instance.Obtains a lifetime service object to control the lifetime policy for this instance.

(Hérité de MarshalByRefObject)
MemberwiseClone()

Crée une copie superficielle du Object actuel.Creates a shallow copy of the current Object.

(Hérité de Object)
MemberwiseClone(Boolean)

Crée une copie superficielle de l'objet MarshalByRefObject actuel.Creates a shallow copy of the current MarshalByRefObject object.

(Hérité de MarshalByRefObject)
OnCollectionChanged(CollectionChangeEventArgs)

Déclenche l'événement CollectionChanged.Raises the CollectionChanged event.

Remove(DataGridTableStyle)

Supprime le DataGridTableStyle spécifié.Removes the specified DataGridTableStyle.

RemoveAt(Int32)

Supprime DataGridTableStyle à l'index spécifié.Removes a DataGridTableStyle at the specified index.

ToString()

Retourne une chaîne qui représente l'objet actif.Returns a string that represents the current object.

(Hérité de Object)

Événements

CollectionChanged

Se produit lorsque la collection a été modifiée.Occurs when the collection has changed.

Implémentations d’interfaces explicites

ICollection.CopyTo(Array, Int32)

Copie la collection dans un Array compatible unidimensionnel, en commençant à l'index spécifié du tableau cible.Copies the collection to a compatible one-dimensional Array, starting at the specified index of the target array.

ICollection.Count

Obtient le nombre d'éléments dans la collection.Gets the number of items in the collection.

ICollection.IsSynchronized

Obtient une valeur indiquant si l'accès à GridTableStylesCollection est synchronisé (thread-safe).Gets a value indicating whether access to the GridTableStylesCollection is synchronized (thread safe).

ICollection.SyncRoot

Obtient un objet qui peut être utilisé pour synchroniser l’accès à la collection.Gets an object that can be used to synchronize access to the collection.

IEnumerable.GetEnumerator()

Retourne un énumérateur pour la collection.Returns an enumerator for the collection.

IList.Add(Object)

Ajoute un DataGridTableStyle à cette collection.Adds a DataGridTableStyle to this collection.

IList.Clear()

Efface la collection.Clears the collection.

IList.Contains(Object)

Détermine si un élément est dans la collection.Determines whether an element is in the collection.

IList.IndexOf(Object)

Retourne l’index de base zéro de la première occurrence de l’objet spécifié dans la collection.Returns the zero-based index of the first occurrence of the specified object in the collection.

IList.Insert(Int32, Object)

Implémente la méthode Insert(Int32, Object).Implements the Insert(Int32, Object) method. Lève toujours NotSupportedException.Always throws NotSupportedException.

IList.IsFixedSize

Obtient une valeur indiquant si la collection est de taille fixe.Gets a value indicating whether the collection has a fixed size.

IList.IsReadOnly

Obtient une valeur qui indique si la collection est en lecture seule.Gets a value indicating whether the collection is read-only.

IList.Item[Int32]

Obtient ou définit l'élément au niveau de l'index spécifié.Gets or sets the element at the specified index.

IList.Remove(Object)

Supprime le DataGridTableStyle spécifié.Removes the specified DataGridTableStyle.

IList.RemoveAt(Int32)

Supprime de la collection le DataGridColumnStyle portant l'index spécifié.Removes the DataGridColumnStyle with the specified index from the collection.

Méthodes d’extension

Cast<TResult>(IEnumerable)

Effectue un cast des éléments d'un IEnumerable vers le type spécifié.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Filtre les éléments d'un IEnumerable en fonction du type spécifié.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Active la parallélisation d'une requête.Enables parallelization of a query.

AsQueryable(IEnumerable)

Convertit un IEnumerable en IQueryable.Converts an IEnumerable to an IQueryable.

S’applique à

Voir aussi