Comment : créer des requêtes TableAdapter paramétrées

Article
06/10/2015

Une requête paramétrable retourne des données remplissant les conditions d'une clause WHERE dans la requête. Par exemple, vous pouvez paramétrer une liste de clients de sorte à n'afficher que les clients d'une certaine ville en ajoutant WHERE City = @City à la fin de l'instruction SQL qui retourne une liste de clients.

Vous créez des requêtes TableAdapter paramétrables dans le Concepteur de DataSet ou pendant la création de formulaires liés aux données dans une application Windows avec la commande Paramétrer la source de données du menu Données. La commande Paramétrer la source de données crée également des contrôles dans votre formulaire pour entrer les valeurs de paramètre et exécuter la requête. Pour plus d'informations, consultez Générateur de critères de recherche, boîte de dialogue.

Notes

Quand vous construisez une requête paramétrée, utilisez la notation de paramètre propre à la base de données sur laquelle vous encodez.Par exemple, les sources de données Access et OleDb utilisent le point d'interrogation « ? » pour désigner des paramètres, la clause WHERE sera donc de type : WHERE City = ?.

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 Paramètres Visual Studio.

Création d'une requête TableAdapter paramétrée

Pour créer une requête paramétrée dans le Concepteur de DataSet

Créez un TableAdapter, en ajoutant une clause WHERE avec les paramètres souhaités à l'instruction SQL. Pour plus d'informations, consultez Comment : créer des TableAdapters.

ou
Ajoutez une requête à un TableAdapter existant, en ajoutant une clause WHERE avec les paramètres souhaités à l'instruction SQL. Pour plus d'informations, consultez Comment : créer des requêtes TableAdapter.

Pour créer une requête paramétrée pendant la conception d'un formulaire lié aux données

Sélectionnez un contrôle dans votre formulaire déjà lié à un dataset. Pour plus d'informations, consultez Liaison de contrôles Windows Forms à des données dans Visual Studio.
Dans le menu Données, cliquez sur Ajouter une requête.
Utilisez la boîte de dialogue Générateur de critères de recherche, en ajoutant une clause WHERE avec les paramètres souhaités à l'instruction SQL. Pour plus d'informations, consultez Générateur de critères de recherche, boîte de dialogue.