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

Article
08/10/2011

Une requête paramétrée retourne des données qui répondent aux conditions d'une clause WHERE contenue dans la requête. Par exemple, vous pouvez paramétrer une liste de clients pour 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.

Vous pouvez créer des requêtes TableAdapter paramétrées dans le Concepteur de DataSet ou pendant la création de formulaires liés aux données dans une application Windows avec la commande Parameterize Data Source du menu Données. La commande Parameterize Data Source crée également sur votre formulaire des contrôles pour l'entrée de valeurs de paramètre et l'exécution de la requête. Pour plus d'informations, consultez Générateur de critères de recherche, boîte de dialogue.

Notes

Lorsque vous construisez une requête paramétrée, utilisez la notation de paramètre spécifique à la base de données à laquelle est destiné le code. Par exemple, les sources de données Access et OleDb utilisent le point d'interrogation « ? » pour indiquer les paramètres ; la clause WHERE se présente donc sous la forme suivante : 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 Utilisation des paramètres.

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 nouveau 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 en concevant un formulaire lié aux données

Sélectionnez sur votre formulaire un contrôle qui est déjà lié à un groupe de données. 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.
Remplissez 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.