GridTableStylesCollection Classe

Définition

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

Exemples

L’exemple de code suivant crée deux DataGridTableStyle objets et ajoute chacun au GridTableStylesCollection retourné par la TableStyles propriété d’un DataGrid contrôle.

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

contient des GridTableStylesCollection objets qui permettent au DataGrid contrôle d’afficher un style de grille personnalisé pour chacun DataTable d’eux dans un DataSet.DataGridTableStyle

Sur le DataGrid contrôle, la TableStyles propriété retourne le GridTableStylesCollection.

Par défaut, le GridTableStylesCollection ne contient aucun DataGridTableStyle objet. Au lieu de cela, le affiche chaque table à l’aide DataGrid des paramètres par défaut pour la couleur, la largeur et la mise en forme. Toutes les colonnes de chaque table sont affichées. Lorsqu’un DataGridTableStyle est ajouté à la collection, le DataGrid utilise MappingName pour déterminer quel objet fournit les données de la grille. Par exemple, si la source de données est un DataSet qui contient trois DataTable objets, le MappingName doit correspondre à l’un TableName des objets. Si le MappingName ne correspond à aucune des TableName valeurs, les paramètres par défaut sont utilisés pour afficher les données de chaque table et les DataGridTableStyle paramètres sont ignorés.

Attention

DataGridColumnStyle Créez toujours des objets et ajoutez-les à avant d’ajouter GridColumnStylesCollectionDataGridTableStyle des GridTableStylesCollectionobjets au . Lorsque vous ajoutez un vide DataGridTableStyle avec une valeur valide MappingName à la collection, DataGridColumnStyle les objets sont générés automatiquement pour vous. Par conséquent, une exception sera levée si vous essayez d’ajouter de nouveaux DataGridColumnStyle objets avec des valeurs dupliquées MappingNameGridColumnStylesCollectionau . Vous pouvez également effacer le à l’aide GridColumnStylesCollection de la Clear méthode .

Propriétés

Count

Obtient le nombre total d'éléments dans la collection.

(Hérité de BaseCollection)
IsReadOnly

Obtient une valeur indiquant si la collection est en lecture seule.

(Hérité de BaseCollection)
IsSynchronized

Obtient une valeur indiquant si l'accès à ICollection est synchronisé.

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

Obtient le DataGridTableStyle spécifié par index.

Item[String]

Obtient l'objet DataGridTableStyle portant le nom spécifié.

List

Obtient la liste sous-jacente.

SyncRoot

Obtient un objet qui peut être utilisé pour synchroniser l’accès à BaseCollection.

(Hérité de BaseCollection)

Méthodes

Add(DataGridTableStyle)

Ajoute un DataGridTableStyle à cette collection.

AddRange(DataGridTableStyle[])

Ajoute un tableau de styles de table à la collection.

Clear()

Efface la collection.

Contains(DataGridTableStyle)

Obtient une valeur indiquant si GridTableStylesCollection contient le DataGridTableStyle spécifié.

Contains(String)

Obtient une valeur indiquant si GridTableStylesCollection contient le DataGridTableStyle spécifié par nom.

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é.

(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.

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

Détermine si l'objet spécifié est égal à l'objet actuel.

(Hérité de Object)
GetEnumerator()

Obtient l'objet qui permet l'itération au sein des membres de la collection.

(Hérité de BaseCollection)
GetHashCode()

Fait office de fonction de hachage par défaut.

(Hérité de Object)
GetLifetimeService()
Obsolète.

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.

(Hérité de MarshalByRefObject)
GetType()

Obtient le Type de l'instance actuelle.

(Hérité de Object)
InitializeLifetimeService()
Obsolète.

Obtient un objet de service de durée de vie pour contrôler la stratégie de durée de vie de cette instance.

(Hérité de MarshalByRefObject)
MemberwiseClone()

Crée une copie superficielle du Object actuel.

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

Crée une copie superficielle de l'objet MarshalByRefObject actuel.

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

Déclenche l’événement CollectionChanged.

Remove(DataGridTableStyle)

Supprime le DataGridTableStyle spécifié.

RemoveAt(Int32)

Supprime DataGridTableStyle à l'index spécifié.

ToString()

Retourne une chaîne qui représente l'objet actuel.

(Hérité de Object)

Événements

CollectionChanged

Se produit lorsque la collection a été modifiée.

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.

ICollection.Count

Obtient le nombre d’éléments de la collection.

ICollection.IsSynchronized

Obtient une valeur indiquant si l’accès à GridTableStylesCollection est synchronisé (thread-safe).

ICollection.SyncRoot

Obtient un objet qui peut être utilisé pour synchroniser l’accès à la collection.

IEnumerable.GetEnumerator()

Retourne un énumérateur pour cette collection.

IList.Add(Object)

Ajoute un DataGridTableStyle à cette collection.

IList.Clear()

Efface la collection.

IList.Contains(Object)

Détermine si un élément est dans la collection.

IList.IndexOf(Object)

Retourne l’index de base zéro de la première occurrence de l’objet spécifié dans la collection.

IList.Insert(Int32, Object)

Implémente la méthode Insert(Int32, Object). Lève toujours NotSupportedException.

IList.IsFixedSize

Obtient une valeur indiquant si la collection est de taille fixe.

IList.IsReadOnly

Obtient une valeur indiquant si la collection est en lecture seule.

IList.Item[Int32]

Obtient ou définit l'élément au niveau de l'index spécifié.

IList.Remove(Object)

Supprime le DataGridTableStyle spécifié.

IList.RemoveAt(Int32)

Supprime de la collection le DataGridColumnStyle portant l'index spécifié.

Méthodes d’extension

Cast<TResult>(IEnumerable)

Effectue un cast des éléments d'un IEnumerable vers le type spécifié.

OfType<TResult>(IEnumerable)

Filtre les éléments d'un IEnumerable en fonction du type spécifié.

AsParallel(IEnumerable)

Active la parallélisation d'une requête.

AsQueryable(IEnumerable)

Convertit un IEnumerable en IQueryable.

S’applique à

Voir aussi