Comment : ajouter une requête paramétrable à une application Windows Forms
Vous pouvez ajouter une fonctionnalité de recherche à un formulaire dans une application Windows en exécutant une requête paramétrée. Celle-ci retourne des données qui répondent aux conditions d'une clause WHERE. Vous ajoutez le paramétrage à une requête en complétant Générateur de critères de recherche, boîte de dialogue. Par exemple, vous pouvez paramétrer une requête afin de n'afficher que les clients d'une certaine ville en ajoutant WHERE City = @City à la fin de l'instruction SQL qui retourne la liste des clients. Pour plus d'informations, consultez Requêtes avec paramètres.
Le remplissage de la boîte de dialogue Critères de recherche entraîne les opérations suivantes :
La requête est ajoutée au TableAdapter associé.
Des contrôles invitant les utilisateurs à fournir les valeurs de paramètre éventuellement requises sont ajoutés au formulaire, ainsi qu'un bouton d'exécution de la requête.
Le code est ajouté à l'événement Click du bouton qui définit les valeurs de paramètre et exécute la requête.
Notes
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 Utilisation des paramètres.
Pour ajouter une requête à un formulaire lié aux données existant
Ouvrez le formulaire dans le Concepteur Windows Forms.
Cliquez sur Ajouter une requête dans le menu Données ou dans les Balises actives de données.
Notes
Si l'option Ajouter une requête n'est pas disponible dans le menu Données, sélectionnez sur le formulaire un contrôle qui affiche la source de données à laquelle vous souhaitez ajouter le paramétrage. Par exemple, si le formulaire affiche des données dans un contrôle DataGridView, sélectionnez-le. Si le formulaire affiche des données dans des contrôles individuels, sélectionnez tout contrôle lié aux données.
Sélectionnez la table à laquelle vous souhaitez ajouter le paramétrage dans la zone Sélectionner la table de source de données. Pour plus d'informations, consultez Générateur de critères de recherche, boîte de dialogue.
Tapez un nom dans la zone Nouveau nom de requête si vous créez une nouvelle requête.
ou
Sélectionnez une requête dans la zone Nom de requête existant.
Tapez une requête qui prend les paramètres contenus dans la zone Texte de la requête.
Conseil
Utilisez le Générateur de requêtes pour vous aider à créer une requête. Pour plus d'informations, consultez Outils du Concepteur de requêtes et de vues.
Cliquez sur OK.
Un contrôle permettant d'entrer le paramètre et un bouton Charger sont ajoutés au formulaire dans un contrôle ToolStrip.
Voir aussi
Tâches
Procédure pas à pas : création d'un Windows Form pour rechercher des données
Procédure pas à pas : affichage de données sur un Windows Form
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
Comment : trier et filtrer des données ADO.NET avec le composant BindingSource Windows Forms
Comment : créer une table de correspondance avec le composant BindingSource Windows Forms
Référence
Concepts
Vue d'ensemble de TableAdapter
Vue d'ensemble des sources de données