Leçon 4 : définir une connexion de données et une table de données pour le rapport enfant

Après avoir créé le rapport parent, l'étape suivante consiste à créer une connexion de données et une table de données pour le rapport enfant.

Les exemples de code Transact-SQL de cet article utilisent l'échantillon de base de données AdventureWorks, que vous pouvez télécharger à partir de la page d'accueil des AdventureWorks2022échantillons et Projects de communautés Microsoft SQL Server.

Pour définir une connexion de données et un objet DataTable en ajoutant un DataSet (pour le rapport enfant)

1. Dans le menu Site Web , sélectionnez Ajouter un nouvel élément.

2. Dans la boîte de dialogue Ajouter un nouvel article , sélectionnez Jeu de données, puis choisissez Ajouter. Quand vous y êtes invité, vous devez ajouter l’élément au dossier App_Code en sélectionnant Oui.

   Cette action ajoute un nouveau fichier XSD DataSet2.xsd au projet et ouvre le Concepteur de DataSet.

3. À partir de la fenêtre Boîte à outils, faites glisser un contrôle TableAdapter dans l’aire de conception. Cette opération permet de lancer l’Assistant configuration de TableAdapter.

4. Dans la page Choisir votre connexion de données , vous pouvez sélectionner la connexion que vous avez créée à la Leçon 2. Si vous l’avez déjà fait, choisissez Suivant et passez à l’étape 8. Sinon, sélectionnez Nouvelle connexion.

5. Dans la boîte de dialogue Ajouter une connexion , effectuez les étapes suivantes :

   1. Dans la zone Nom du serveur, entrez le nom du serveur sur lequel se trouve la base de données AdventureWorks2022.

      L’instance SQL Server Express par défaut est (local)\sqlexpress.

   2. Dans la section Connexion au serveur , sélectionnez l’option qui permet d’accéder aux données. Utiliser l’authentification Windows est la valeur par défaut.

   3. Dans la liste déroulante Sélectionner ou saisir un nom de base de données, choisissez AdventureWorks2022.

   4. Sélectionnez OK, puis Suivant.

6. Si vous avez sélectionné Utiliser l’authentification SQL Server à l’étape 5 (b), choisissez d’inclure les données sensibles dans la chaîne ou définir les informations dans votre code d’application.

7. Dans la page Enregistrer la chaîne de connexion dans le fichier de configuration de l'application, tapez le nom de la chaîne de connexion ou acceptez AdventureWorks2022ConnectionString par défaut. Cliquez sur Suivant.

8. Dans la page Choisissez un type de commande , sélectionnez Utiliser des instructions SQL, puis choisissez Suivant.

9. Dans la page Entrez une instruction SQL, entrez la requête Transact-SQL ci-après pour récupérer des données de la base de données AdventureWorks2022, puis sélectionnez Suivant.

   SELECT PurchaseOrderID, PurchaseOrderDetailID, OrderQty, ProductID, ReceivedQty, RejectedQty, StockedQty FROM Purchasing.PurchaseOrderDetail  
   

   Vous pouvez également créer la requête en sélectionnant Générateur de requêtes, puis vérifier la requête en sélectionnant le bouton Exécuter la requête.

10. Dans la page Choisir les méthodes à générer , décochez Créer des méthodes pour envoyer directement des mises à jour à la base de données (GenerateDBDirectMethods) , puis sélectionnez Terminer.

    Avertissement

    Veillez à décocher Créer des méthodes pour envoyer directement des mises à jour à la base de données (GenerateDBDirectMethods) .

    Vous avez configuré l’objet ADO.NET DataTable comme source de données de votre rapport. Dans la page du Concepteur de DataSet dans Visual Studio, vous devez voir l’objet DataTable que vous avez ajouté, qui répertorie les colonnes spécifiées dans la requête. DataSet2 contient les données de la table PurchaseOrderDetail, en fonction de la requête.

11. Enregistrez le fichier .

12. Pour afficher un aperçu des données, sélectionnez Aperçu des données dans le menu Données, puis choisissez Aperçu.

Étape suivante

Vous venez de créer avec succès une connexion de données et une table de données pour le rapport enfant. Ensuite, vous allez concevoir le rapport enfant à l'aide de l'Assistant Rapport. Consultez Leçon 5 : concevoir le rapport enfant à l’aide de l’Assistant Rapport.