Comment : créer des requêtes TableAdapter

Article
06/10/2015

Les requêtes TableAdapter sont des instructions SQL ou des procédures stockées que votre application peut exécuter sur une base de données.

Ajoutez autant de requêtes à un TableAdapter que l'exige votre application. Les requêtes TableAdapter apparaissent en tant que méthodes sur un TableAdapter. Lorsque vous créez une requête appelée FillByCity qui prend un paramètre représentant la valeur City, cette requête est ajoutée au TableAdapter. Elle est ajoutée en tant que méthode typée qui prend le type correct de paramètre comme argument (dans ce cas-ci, une chaîne représentant la valeur City). Vous pouvez appeler la requête TableAdapter de la même façon qu'une méthode quelconque pour n'importe quel objet. Par exemple, le code suivant exécute la requête FillByCity et remplit la table Customers avec tous les clients possédant une valeur City de Seattle :

Dim cityValue As String = "Seattle"
CustomersTableAdapter.FillByCity(NorthwindDataSet.Customers, cityValue)

string cityValue = "Seattle";
customersTableAdapter.FillByCity(northwindDataSet.Customers, cityValue);

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). (Cliquez avec le bouton droit sur un TableAdapter et choisissez Ajouter une requête.)

Notes

Il est possible que pour certains des éléments de l'interface utilisateur de Visual Studio, votre ordinateur affiche des noms ou des emplacements différents de ceux indiqués dans les instructions suivantes. L'édition de Visual Studio dont vous disposez et les paramètres que vous utilisez déterminent ces éléments. Pour plus d'informations, voir Paramètres Visual Studio.

Créez une requête dans le Concepteur de DataSet

Pour ajouter une requête à un TableAdapter dans le Concepteur de DataSet

Ouvrez un groupe de données dans le Concepteur de DataSet. Pour plus d'informations, consultez Comment : ouvrir un groupe de données dans le Concepteur de DataSet.
Cliquez avec le bouton droit sur le TableAdapter souhaité et sélectionnez Ajouter une requête.

ou
Faites glisser une Requête depuis l'onglet DataSet de la Boîte à outils jusqu'à une table dans le concepteur.

L'Assistant Configuration de requêtes TableAdapter s'ouvre.
Une fois l'Assistant terminé, la requête est ajoutée au TableAdapter.

Créez directement une requête dans un formulaire de votre application Windows

Si vous avez une instance d'un TableAdapter sur votre formulaire, vous pouvez ajouter une requête à l'aide du Générateur de critères de recherche, boîte de dialogue qui ajoute un contrôle ToolStrip au formulaire qui accepte tous les paramètres d'entrée requis par la requête, ainsi qu'un bouton pour exécuter celle-ci.

Pour ajouter une requête à un TableAdapter à l'aide de la boîte de dialogue Critère de recherche

Sélectionnez un TableAdapter dans la barre d'état des composants.
Cliquez sur la balise active du TableAdapter et choisissez Ajouter une requête.
Complétez la boîte de dialogue afin d'ajouter la requête au TableAdapter. Pour plus d'informations, consultez Générateur de critères de recherche, boîte de dialogue.