Partager via

Comment  : ajouter des tables et des colonnes au contrôle DataGrid Windows Forms

  • Article

Mise à jour : novembre 2007

Remarque :

Le contrôle DataGridView remplace le contrôle DataGrid et lui ajoute des fonctionnalités ; toutefois, le contrôle DataGrid est conservé pour la compatibilité descendante et l'utilisation future si tel est votre choix. Pour plus d'informations, consultez Différences entre les contrôles DataGridView et DataGrid Windows Forms.

Vous pouvez afficher des données dans le contrôle DataGrid Windows Forms, dans des tables et colonnes, en créant des objets DataGridTableStyle et en les ajoutant à l'objet GridTableStylesCollection, accessible par le biais de la propriété TableStyles du contrôle DataGrid. Chaque style de table affiche le contenu de toute table de données spécifiée dans la propriété MappingName de l'objet DataGridTableStyle. Par défaut, un style de table sans style de colonne spécifié affiche toutes les colonnes de la table de données. Vous pouvez restreindre les colonnes de la table affichées en ajoutant des objets DataGridColumnStyle à l'objet GridColumnStylesCollection accessible par la propriété GridColumnStyles de chaque objet DataGridTableStyle.

Pour ajouter une table et une colonne à un contrôle DataGrid par programme

  1. Pour afficher des données dans la table, vous devez d'abord lier le contrôle DataGrid à un groupe de données. Pour plus d'informations, consultez Comment : lier le contrôle DataGrid Windows Forms à une source de données.

    Attention :

    Lorsque vous spécifiez par programme des styles de colonne, vous devez créer systématiquement des objets DataGridColumnStyle et les ajouter à l'objet GridColumnStylesCollection avant d'ajouter les objets DataGridTableStyle à l'objet GridTableStylesCollection. Lorsque vous ajoutez un objet DataGridTableStyle vide à la collection, les objets DataGridColumnStyle sont automatiquement générés. Une exception est donc levée si vous tentez d'ajouter de nouveaux objets DataGridColumnStyle présentant des valeurs MappingName dupliquées avec celles de l'objet GridColumnStylesCollection.

  2. Déclarez un nouveau style de table et définissez son nom de mappage.

    Dim ts1 As New DataGridTableStyle()
ts1.MappingName = "Customers"

    DataGridTableStyle ts1 = new DataGridTableStyle();
ts1.MappingName = "Customers";

    DataGridTableStyle* ts1 = new DataGridTableStyle();
ts1->MappingName = S"Customers";

  3. Déclarez un nouveau style de colonne et définissez son nom de mappage ainsi que ses autres propriétés.

    Dim myDataCol As New DataGridBoolColumn()
myDataCol.HeaderText = "My New Column"
myDataCol.MappingName = "Current"

    DataGridBoolColumn myDataCol = new DataGridBoolColumn();
myDataCol.HeaderText = "My New Column";
myDataCol.MappingName = "Current";

    DataGridBoolColumn^ myDataCol = gcnew DataGridBoolColumn();
myDataCol->HeaderText = "My New Column";
myDataCol->MappingName = "Current";

  4. Appelez la méthode Add de l'objet GridColumnStylesCollection pour ajouter la colonne au style de table.

    ts1.GridColumnStyles.Add(myDataCol)

    ts1.GridColumnStyles.Add(myDataCol);

    ts1->GridColumnStyles->Add(myDataCol);

  5. Appelez la méthode Add de l'objet GridTableStylesCollection pour ajouter la table à la grille de données.

    DataGrid1.TableStyles.Add(ts1)

    dataGrid1.TableStyles.Add(ts1);

    dataGrid1->TableStyles->Add(ts1);

Voir aussi

Tâches

Comment : supprimer ou masquer des colonnes dans le contrôle DataGrid Windows Forms

Autres ressources

DataGrid, contrôle (Windows Forms)