Share via

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

  • Article

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 Windows Forms DataGrid dans des tables et des colonnes en créant des objets DataGridTableStyle et en les ajoutant à l’objet GridTableStylesCollection, accessible via la DataGrid propriété TableStyles du contrôle. Chaque style de table affiche le contenu de la table de données spécifiée dans la propriété MappingName de l’objet DataGridTableStyle. Par défaut, un style de tableau sans styles de colonne spécifié affiche toutes les colonnes de cette table de données. Vous pouvez restreindre les colonnes de la table en ajoutant des objets DataGridColumnStyle à l’objet GridColumnStylesCollection , accessible via la propriété GridColumnStyles de chaque objet DataGridTableStyle .

Pour ajouter une table et une colonne à un DataGrid par programmation

  1. Pour afficher des données dans la table, vous devez d’abord lier le DataGrid contrôle à un jeu de données. Pour plus d’informations, consultez Guide pratique pour lier le contrôle DataGrid Windows Forms à une source de données.

    Attention

    Lorsque vous spécifiez des styles de colonne par programmation, créez toujours des objets DataGridColumnStyle et ajoutez-les à l’objet GridColumnStylesCollection avant d’ajouter des objets DataGridTableStyle à l’objet GridTableStylesCollection . Lorsque vous ajoutez un objet DataGridTableStyle vide à la collection, les objets DataGridColumnStyle sont générés automatiquement pour vous. Par conséquent, une exception est levée si vous essayez d’ajouter de nouveaux objets DataGridColumnStyle avec des valeurs MappingName dupliquées à 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 et d’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 le style de table à la grille de données.

    DataGrid1.TableStyles.Add(ts1)

    dataGrid1.TableStyles.Add(ts1);

    dataGrid1->TableStyles->Add(ts1);

Voir aussi