Comment : lier le contrôle DataGrid Windows Forms à une source de données à l'aide du concepteur
Notes
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.
Le contrôle DataGrid Windows Forms est spécialement conçu pour afficher des informations d'une source de données. Vous le liez au moment du design en définissant les propriétés DataSource et DataMember, ou au moment de l'exécution en appelant la méthode SetDataBinding. Bien que vous puissiez afficher des données provenant d'un large éventail de sources de données, les sources les plus courantes sont les groupes de données et les vues de données.
Si la source de données est disponible au moment du design (par exemple si le formulaire contient une instance d'un groupe de données ou d'une vue de données), vous pouvez lier la grille à cette source au même moment. Il est possible d'afficher un aperçu de l'apparence qu'auront les données dans la grille.
Vous pouvez aussi lier la grille par programme, au moment de l'exécution. Cela est utile lorsque vous voulez définir une source de données basée sur des informations obtenues au moment de l'exécution (par exemple, l'application peut permettre à l'utilisateur de spécifier le nom d'une table à afficher). En outre, cela est nécessaire lorsque la source n'existe pas au moment du design. Ce peut être le cas de sources telles que tableaux, collections, groupes de données non typés et lecteurs de données.
La procédure suivante requiert un projet d'application Windows avec un formulaire qui contient un contrôle DataGrid. Pour plus d'informations sur la configuration d'un tel projet, consultez Comment : créer un projet d'Application Windows Forms et Comment : ajouter des contrôles à des Windows Forms. Dans Visual Studio 2005, par défaut, le contrôle DataGrid ne se trouve pas dans la boîte à outils. Pour plus d'informations sur son ajout, consultez Comment : ajouter des éléments à la boîte à outils. Par ailleurs, dans Visual Studio 2005, vous pouvez utiliser la fenêtre Sources de données pour la liaison de données au moment du design. Pour plus d'informations, consultez Liaison de contrôles à des données dans Visual Studio.
Notes
Les boîtes de dialogue et les commandes de menu qui s'affichent peuvent être différentes de celles qui sont décrites dans l'aide, en fonction de vos paramètres actifs ou de l'édition utilisée. Pour modifier vos paramètres, choisissez Importation et exportation de paramètres dans le menu Outils. Pour plus d'informations, consultez Utilisation des paramètres.
Pour lier les données du contrôle DataGrid à une table unique dans le concepteur
Affectez à la propriété DataSource du contrôle l'objet contenant les éléments de données avec lesquels vous souhaitez établir une liaison.
Si la source de données est un groupe de données, affectez à la propriété DataMember le nom de la table avec laquelle établir une liaison.
Si la source est un groupe de données ou une vue de données basée sur une table de groupe de données, ajoutez au formulaire du code destiné à remplir le groupe de données.
Le code exact utilisé dépend de la provenance des données du groupe. Si le groupe de données est rempli directement à partir d'une base de données, vous appelez en général la méthode Fill d'un adaptateur de données, comme dans l'exemple de code suivant, qui remplit le groupe de données DsCategories1 :
sqlDataAdapter1.Fill(DsCategories1)sqlDataAdapter1.Fill(DsCategories1);sqlDataAdapter1->Fill(dsCategories1);(Facultatif) Ajoutez les styles de table et de colonne appropriés à la grille.
S'il n'existe pas de style de table, la table s'affichera avec une mise en forme minimale et toutes ses colonnes visibles.
Pour lier les données du contrôle DataGrid à plusieurs tables d'un groupe de données dans le concepteur
Affectez à la propriété DataSource du contrôle l'objet contenant les éléments de données avec lesquels vous souhaitez établir une liaison.
Si le groupe de données contient des tables connexes (c'est-à-dire s'il contient un objet de relation), affectez à la propriété DataMember le nom de la table parente.
Écrivez le code servant à remplir le groupe de données.
Voir aussi
Tâches
Comment : ajouter des tables et des colonnes au contrôle DataGrid Windows Forms
Référence
Vue d'ensemble du contrôle DataGrid (Windows Forms)
Autres ressources
DataGrid, contrôle (Windows Forms)