Comment : créer des requêtes TableAdapter
Mise à jour : novembre 2007
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'Assistant Configuration de requêtes TableAdapter. (Cliquez avec le bouton droit sur un TableAdapter et choisissez Ajouter une requête.)
.gif "Remarque") Remarque : |
|---|
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 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 possédez une instance d'un TableAdapter dans votre formulaire, vous pouvez ajouter, à l'aide de la boîte de dialogue Générateur de critères de recherche, une requête ajoutant un contrôle ToolStrip au formulaire qui accepte tout paramètre d'entrée nécessaire à la requête, ainsi qu'un bouton permettant d'exécuter la requête.
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.
Voir aussi
Tâches
Comment : modifier des requêtes TableAdapter
Comment : établir une connexion à des données d'une base de données
Comment : naviguer parmi les données avec le contrôle BindingNavigator Windows Forms
Procédure pas à pas : affichage de données sur un formulaire dans une application Windows
Concepts
Vue d'ensemble de TableAdapter
Vue d'ensemble de l'affichage des données
Vue d'ensemble des sources de données