Procédure pas à pas : création d'un TableAdapter avec plusieurs requêtes

Article
08/21/2008

Mise à jour : novembre 2007

Dans le cadre de cette procédure pas à pas, vous allez créer un TableAdapter dans un groupe de données à l'aide de l'Assistant Configuration de source de données. Cette procédure pas à pas vous guide au sein du processus de création d'une deuxième requête dans le TableAdapter à l'aide de l'Assistant Configuration de requêtes TableAdapter disponible dans le Concepteur de DataSet.

Cette procédure pas à pas illustre les tâches suivantes :

Création d'un nouveau projet Application Windows.
Création et configuration d'une source de données dans votre application en générant un groupe de données avec l'Assistant Configuration de source de données.
Ouverture du nouveau groupe de données dans le Concepteur de DataSet.
Ajout de requêtes au TableAdapter avec l'Assistant Configuration de requêtes TableAdapter.

Composants requis

Pour exécuter cette procédure pas à pas, vous devez utiliser :

avoir accès à l'exemple de base de données Northwind (versions SQL Server ou Access). Pour plus d'informations, consultez Comment : installer des exemples de bases de données.

Création d'une nouvelle application Windows

La première étape consiste à créer une application Windows.

Pour créer un projet d'application Windows

Dans le menu Fichier de Visual Studio, créez un nouveau projet.
Choisissez un langage de programmation dans le volet Types de projets.
Cliquez sur Application Windows dans le volet Modèles.
Nommez le projet TableAdapterQueriesWalkthrough, puis cliquez sur OK.

Visual Studio ajoute le projet à l'Explorateur de solutions et affiche un nouveau formulaire dans le concepteur.

Création d'une source de données de base de données avec un TableAdapter

Cette étape permet de créer une source de données à l'aide de l'Assistant Configuration de source de données en se basant sur la table Customers fournie dans l'exemple de base de données Northwind. Vous devez avoir accès à l'exemple de base de données Northwind pour créer la connexion. Pour plus d'informations sur l'installation de l'exemple de base de données Northwind, consultez Comment : installer des exemples de bases de données.

Pour créer la source de données

Dans le menu Données, cliquez sur Afficher les sources de données.
Dans la fenêtre Sources de données, sélectionnez Ajouter une nouvelle source de données pour démarrer l'Assistant Configuration de source de données.
Sélectionnez Base de données dans la page Choisir un type de source de données, puis cliquez sur Suivant.
Dans la page Choisir votre connexion de données, effectuez l'une des opérations suivantes :
- Si une connexion de données à l'exemple de base de données Northwind est disponible dans la liste déroulante, sélectionnez-la.
  
  - ou -
- Sélectionnez Nouvelle connexion pour afficher la boîte de dialogue Ajouter une/Modifier la connexion. Pour plus d'informations, consultez Ajouter/Modifier une connexion, boîte de dialogue (Général).
Si votre base de données requiert un mot de passe, sélectionnez l'option pour inclure les données sensibles, puis cliquez sur Suivant.
Cliquez sur Suivant dans la page Enregistrer la chaîne de connexion dans le fichier de configuration de l'application.
Développez le nœud Tables dans la page Choisir vos objets de base de données.
Sélectionnez la table Customers, puis cliquez sur Terminer.

NorthwindDataSet est ajouté à votre projet et la table Customers apparaît dans la fenêtre Sources de données.

Ouverture du groupe de données dans le Concepteur de DataSet

Pour ouvrir le groupe de données dans le Concepteur de DataSet

Cliquez avec le bouton droit sur NorthwindDataset dans la fenêtre Sources de données.
Dans le menu contextuel, choisissez Modifier le DataSet à l'aide du concepteur.

Ouvrez NorthwindDataset dans le Concepteur de DataSet.

Ajout d'une deuxième requête au CustomersTableAdapter

L'Assistant a créé le groupe de données avec une table de données Customers et un CustomersTableAdapter. Cette section de la procédure pas à pas ajoute une deuxième requête au CustomersTableAdapter.

Pour ajouter une requête au CustomersTableAdapter

Faites glisser une Requête depuis l'onglet DataSet de la Boîte à outils jusqu'à la table Customers.

L'Assistant Configuration de requêtes TableAdapter s'ouvre.
Sélectionnez Utiliser des instructions SQL, puis cliquez sur Suivant.
Sélectionnez SELECT qui retourne des lignes, puis cliquez sur Suivant.

Ajoutez une clause WHERE à la requête afin qu'elle se présente de la manière suivante :

SELECT CustomerID, CompanyName, ContactName, ContactTitle, Address, City, Region, PostalCode, Country, Phone, Fax 
FROM Customers 
WHERE City = @City

Remarque :
Si vous utilisez la version Access de Northwind remplacez le paramètre @City par un point d'interrogation. (SELECT CustomerID, CompanyName, ContactName, ContactTitle, Address, City, Region, PostalCode, Country, Phone, Fax FROM Customers WHERE City = ?)

Sur la page Choisir les méthodes à générer, nommez la méthode Remplir un DataTableFillByCity.

Remarque :

La méthode Retourner un DataTable n'est pas utilisée dans cette procédure pas à pas ; vous pouvez donc désactiver la case à cocher ou conserver le nom par défaut.
Cliquez sur Suivant et fermez l'Assistant.

La requête FillByCity est ajoutée au CustomersTableAdapter.

Remarque :
La méthode Retourner un DataTable n'est pas utilisée dans cette procédure pas à pas ; vous pouvez donc désactiver la case à cocher ou conserver le nom par défaut.

Ajout du code permettant d'exécuter la requête supplémentaire sur le formulaire

Pour exécuter la requête

Sélectionnez Form1 dans l'Explorateur de solutions et cliquez sur Concepteur de vues.
Faites glisser le nœud Customers depuis la fenêtre Sources de données jusqu'à Form1.
Passez en mode Code en sélectionnant Code dans le menu Affichage.

Remplacez le code contenu dans le gestionnaire d'événements Form1_Load par les éléments suivants afin d'exécuter la requête FillByCity.

Dim cityValue As String = "Seattle"
CustomersTableAdapter.FillByCity(NorthwindDataSet.Customers, cityValue)

string cityValue = "Seattle";
customersTableAdapter.FillByCity(northwindDataSet.Customers, cityValue);

Exécution de l'application

Pour exécuter l'application

Appuyez sur F5.
La grille est remplie avec les clients dont le paramètre City a la valeur Seattle.

Étapes suivantes

Pour ajouter des fonctionnalités à votre application

Ajoutez un contrôle TextBox et un contrôle Button, puis passez à la requête la valeur contenue dans la zone de texte. (CustomersTableAdapter.FillByCity(NorthwindDataSet.Customers, TextBox1.Text)).
Ajoutez une logique de validation aux événements ColumnChanging ou RowChanging des tables de données dans le groupe de données. Pour plus d'informations, consultez Vue d'ensemble de la validation des données.

Voir aussi