Comment : ajouter une requête paramétrée à un formulaire dans une application Windows

Mise à jour : novembre 2007

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. Pour ajouter le paramétrage à une requête, remplissez la boîte de dialogue Générateur de critères de recherche. 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.

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.

Pour ajouter une requête à un formulaire lié aux données existant

1. Ouvrez le formulaire dans le Concepteur Windows Forms.

2. Cliquez sur Ajouter une requête dans le menu Données ou dans les Balises actives de données.

   Remarque :

   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.

3. 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.

4. 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.

5. 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.

6. 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 formulaire pour rechercher des données dans une application Windows

Procédure pas à pas : affichage de données sur un formulaire dans une application Windows

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

Concepts

Vue d'ensemble de TableAdapter

Concepteur de DataSet

Vue d'ensemble des sources de données

Référence

Sources de données, fenêtre

Autres ressources

Validation des données