Comment : remplir de données un groupe de données

Article
08/21/2008

Mise à jour : novembre 2007

L'expression « remplissage d'un groupe de données avec des données » fait référence au chargement de données dans les objets DataTable qui composent le groupe de données. Pour remplir les tables de données, vous devez exécuter des requêtes TableAdapter, ou des commandes d'adaptateur de données (par exemple, des commandes SqlDataAdapter).

Le choix d'utiliser des TableAdapters ou des adaptateurs de données dépend de la manière dont vous avez créé le groupe de données. Si vous avez utilisé les outils de création disponibles dans Visual Studio, tels que l'Assistant Configuration de source de données, votre groupe de données contient des TableAdapters. Pour plus d'informations sur les TableAdapters, consultez Vue d'ensemble de TableAdapter. Si vous avez créé votre groupe de données par programme, vous devez généralement créer des adaptateurs de données pour charger des données dans les tables de données. Pour plus d'informations, consultez Introduction aux adaptateurs de données.

Remarque :
Lorsque vous faites glisser des éléments depuis la fenêtre Sources de données jusqu'à un formulaire, le code permettant de remplir de données la table de données est automatiquement ajouté au gestionnaire d'événements Form_Load. Ouvrez votre formulaire dans l'éditeur de code pour afficher la syntaxe exacte permettant de remplir vos tables spécifiques. Si vous ne souhaitez pas remplir la table lors du chargement du formulaire, vous pouvez déplacer ce code vers une autre méthode ou le supprimer intégralement.

Lorsque vous faites glisser des éléments depuis la fenêtre Sources de données jusqu'à un formulaire, le code permettant de remplir de données la table de données est automatiquement ajouté au gestionnaire d'événements Form_Load. Ouvrez votre formulaire dans l'éditeur de code pour afficher la syntaxe exacte permettant de remplir vos tables spécifiques. Si vous ne souhaitez pas remplir la table lors du chargement du formulaire, vous pouvez déplacer ce code vers une autre méthode ou le supprimer intégralement.

Remplissage d'un groupe de données à l'aide d'un TableAdapter

Vous pouvez appeler une requête sur le TableAdapter pour charger des données dans des tables de données d'un groupe de données. Passez le DataTable que vous souhaitez remplir à la requête TableAdapter. Si votre requête prend des paramètres, vous devez les passer également à la méthode. Si le groupe de données contient plusieurs tables, vous devez posséder des TableAdapters distincts pour chaque table et il est donc nécessaire de remplir chaque table séparément.

Remarque :
Par défaut, à chaque exécution d'une requête TableAdapter, les données contenues dans la table sont effacées avant que les résultats de la requête soient chargés dans la table. Vous pouvez conserver les données existantes dans la table et ajouter les résultats en affectant à la propriété ClearBeforeFill du TableAdapter la valeur false.

Pour remplir de données un groupe de données à l'aide d'un TableAdapter

Ouvrez votre formulaire ou composant dans l'éditeur de code.
Ajoutez du code à tout endroit de votre application où vous devez charger une table de données avec des données. Si votre requête ne prend pas de paramètre, passez le DataTable que vous souhaitez remplir. Le code doit se présenter comme suit :
```
Me.CustomersTableAdapter.Fill(Me.NorthwindDataSet.Customers)
```
```
this.customersTableAdapter.Fill(this.northwindDataSet.Customers);
```

Si votre requête prend des paramètres, passez le DataTable que vous souhaitez remplir et les paramètres attendus par la requête. Selon les paramètres réels contenus dans votre requête, le code peut se présenter comme dans les exemples suivants :

CustomersTableAdapter.FillByCity(NorthwindDataSet.Customers, "Seattle")
CustomersTableAdapter.FillByCityAndState(NorthwindDataSet.Customers, "Seattle", "WA")

customersTableAdapter.FillByCity(northwindDataSet.Customers, "Seattle");
customersTableAdapter.FillByCityAndState(northwindDataSet.Customers, "Seattle", "WA");

Remplissage d'un groupe de données à l'aide d'un DataAdapter

Vous devez appeler la méthode Fill de l'adaptateur de données. Dans ce cas, l'adaptateur exécute l'instruction SQL ou la procédure stockée référencée dans sa propriété SelectCommand et insère les résultats dans une table du groupe de données. Si le groupe de données contient plusieurs tables, vous devez disposer d'adaptateurs de table distincts pour chaque table et il est donc nécessaire de remplir chaque table séparément.

Pour remplir de données un groupe de données à l'aide d'un DataAdapter

Appelez la méthode Fill du DataAdapter, en passant dans le DataSet ou le DataTable dans lequel charger les données. Par exemple :
```
sqlDataAdapter1.Fill(dataset1.Tables("Customers"))
```
```
sqlDataAdapter1.Fill(dataset1.Tables["Customers"]);
```
Vous devez généralement fournir le nom du DataTable dans lequel charger les données. Si vous passez le nom d'un DataSet et non d'une table de données spécifique, un DataTable nommé Table1 est ajouté au groupe de données et chargé avec les résultats de la base de données (plutôt que de charger les données dans un DataTable existant dans le groupe de données). Pour plus d'informations, consultez Remplissage d'un DataSet à partir d'un DataAdapter (ADO.NET).