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

Après avoir créé un projet de site Web à l'aide du modèle de site Web ASP.NET pour Visual C#, l'étape suivante consiste à créer une connexion de données et une table de données pour le rapport parent.

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 une table de données en ajoutant un jeu de données (pour le rapport parent)

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’article au dossier App_Code en sélectionnant Oui.

   Cette action ajoute un nouveau fichier XSD DataSet1.xsd au projet et ouvrez 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 , sélectionnez Nouvelle connexion.

5. Si vous avez créé une source de données dans Visual Studio pour la première fois, vous pouvez consulter la page Choisir une source de données. Dans la zone Source de données , sélectionnez Microsoft SQL Server.

6. 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 entrer un nom de base de données, sélectionnez AdventureWorks2022.

   4. Sélectionnez OK, puis choisissez Suivant.

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

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

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

10. 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 ProductID, Name, ProductNumber, SafetyStockLevel, ReorderPoint FROM  Production.Product Order By ProductID  
    

    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 Exécuter la requête.

11. Dans la page Choisir les méthodes à générer , veillez à décocher 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. Sur la page Concepteur de DataSet dans Visual Studio, vous devez voir l'objet DataTable que vous venez d'ajouter, répertoriant les colonnes spécifiées dans la requête. DataSet1 contient les données de la table Product, en fonction de la requête.

12. Enregistrez le fichier .

13. 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 une connexion de données et une table de données pour le rapport parent. Ensuite, vous allez concevoir le rapport parent à l'aide de l'Assistant Rapport. Voir Leçon 3 : concevoir le rapport parent à l’aide de l’Assistant Rapport.