Comment : exécuter des requêtes TableAdapter
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.
[!REMARQUE]
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
Tâches
Comment : créer des TableAdapters
Comment : créer des requêtes TableAdapter
Comment : modifier des requêtes TableAdapter
Comment : accéder directement à la base de données avec un TableAdapter
Procédure pas à pas : enregistrement des données avec les méthodes DBDirect du TableAdapter
Comment : naviguer parmi les données avec le contrôle BindingNavigator Windows Forms
Procédure pas à pas : affichage de données sur un Windows Form
Concepts
Vue d'ensemble de TableAdapter
Extraction de données dans votre application
Liaison de contrôles Windows Forms à des données dans Visual Studio
Création et modification de Datasets typés