Comment : exécuter des requêtes TableAdapter

Article
08/10/2011

Les requêtes TableAdapter sont des instructions SQL ou des procédures stockées que votre application peut exécuter par rapport à une base de données et qui sont exposées en tant que méthodes typées sur le TableAdapter. Vous pouvez exécuter des requêtes TableAdapter en appelant les méthodes associées, tout comme avec n'importe quelle méthode sur tout objet.

Les requêtes TableAdapter peuvent remplir une table de données (requêtes Fill et FillBy) ou retourner de nouvelles tables de données remplies avec les données retournées par la requête (requêtes GetData et GetDataBy).

Vous pouvez ajouter des requêtes à des TableAdapters existants en exécutant l' Configuration de requête TableAdapter (Assistant).

Créer une instance du TableAdapter.

Vous devez créer une instance du TableAdapter pour pouvoir appeler chacune de ses méthodes.

Notes

Même si la création et la modification de TableAdapters se font par le biais du Concepteur de Dataset, les TableAdapters ne sont pas véritablement des classes imbriquées au sein d'un groupe de données. Les TableAdapters se trouvent à l'intérieur d'un espace de noms qui est identifié en fonction du nom du groupe de données associé au TableAdapter. La convention d'affectation de noms est : NomGroupeDonnées + "TableAdapters." Par exemple, tous les TableAdapters associés au NorthwindDataSet se trouvent dans l'espace de noms NorthwindDataSetTableAdapters. S'il existe un CustomersTableAdapter, son nom qualifié complet est NorthwindDataSetTableAdapters.CustomersTableAdapter.

Pour créer une instance du TableAdapter

Faites glisser les éléments de la fenêtre Sources de données vers un formulaire dans votre application Windows pour créer automatiquement une instance d'un TableAdapter sur le formulaire. Inspectez le TableAdapter dans la barre d'état des composants (la petite zone sous la bordure inférieure du formulaire) pour le nom de l'instance.

ou
Après avoir créé un TableAdapter, générez le projet. Le TableAdapter apparaît ensuite dans la Boîte à outils. Faites glisser le TableAdapter de la Boîte à outils vers un formulaire pour créer une instance. Inspectez le TableAdapter dans la barre d'état des composants pour y trouver le nom de l'instance.

ou

Créez une instance TableAdapter par programme :

Dim CustomersTableAdapter1 As NorthwindDataSetTableAdapters.CustomersTableAdapter
CustomersTableAdapter1 = New NorthwindDataSetTableAdapters.CustomersTableAdapter()

NorthwindDataSetTableAdapters.CustomersTableAdapter customersTableAdapter1;
customersTableAdapter1 = new NorthwindDataSetTableAdapters.CustomersTableAdapter();

Exécutez des requêtes TableAdapter qui remplissent des tables de données existantes (Méthodes Fill())

Pour exécuter une requête TableAdapter qui remplit une table de données existante

Appelez la requête Fill ou FillBy et passez la table de données à remplir. Par exemple, le code suivant exécute la requête Fill et remplit la table Customers :
```
CustomersTableAdapter1.Fill(NorthwindDataSet1.Customers)
```
```
customersTableAdapter1.Fill(northwindDataSet1.Customers);
```

Exécutez des requêtes TableAdapter qui retournent de nouvelles tables de données (Méthodes GetData ())

Pour exécuter une requête TableAdapter qui retourne une nouvelle table de données

Appelez la requête GetData ou GetDataBy pour retourner une table de données typées remplie des résultats de la requête. Par exemple, le code suivant exécute la requête GetData et retourne une table Customers :

Dim newCustomersTable As NorthwindDataSet.CustomersDataTable
newCustomersTable = CustomersTableAdapter1.GetData()

NorthwindDataSet.CustomersDataTable newCustomersTable;
newCustomersTable = customersTableAdapter1.GetData();

Exécuter des requêtes TableAdapter qui retournent des valeurs seules (scalaire)

Vous pouvez faire glisser directement une requête de la Boîte à outils vers le Concepteur de Dataset pour créer une requête autonome (une requête sans table de données).

Pour exécuter une requête TableAdapter qui retourne une valeur seule (scalaire)

Créez une instance du TableAdapter, déclarez une variable pour stocker la valeur de retour et assignez-lui le résultat de la requête. L'exemple suivant suppose qu'il y a une requête nommée CustomerCount sur QueriesTableAdapter.

Dim scalarQueriesTableAdapter As NorthwindDataSetTableAdapters.QueriesTableAdapter
scalarQueriesTableAdapter = New NorthwindDataSetTableAdapters.QueriesTableAdapter()

Dim returnValue As Integer
returnValue = CType(scalarQueriesTableAdapter.CustomerCount(), Integer)

NorthwindDataSetTableAdapters.QueriesTableAdapter scalarQueriesTableAdapter;
scalarQueriesTableAdapter = new NorthwindDataSetTableAdapters.QueriesTableAdapter();

int returnValue;
returnValue = (int)scalarQueriesTableAdapter.CustomerCount();

Voir aussi