Procédure pas à pas : utilisation d'une source de données de base de données avec le contrôle Windows Forms ReportViewer en mode de traitement local

Cette procédure pas à pas montre comment créer un rapport dans un projet d'application Windows Forms et ajouter un contrôle ReportViewer à un Windows Form afin que les utilisateurs de l'application puissent visualiser le rapport.

Composants requis

Pour suivre cette procédure pas à pas, vous devez avoir accès à l'exemple de base de données AdventureWorks2008.Pour plus d'informations, consultez Procédure pas à pas : installation de la base de données AdventureWorks.

Procédez comme suit pour ajouter un rapport à un projet d'application Windows Forms.Pour cet exemple, vous créez l'application en Microsoft Visual Basic.

Création d'un projet d'application Windows

1. Ouvrez Visual Studio.Dans le menu Fichier, pointez sur Nouveau, puis sélectionnez Projet.

2. Dans le volet Modèles installés, choisissez Visual Basic, puis Application Windows Forms.Le nœud Visual Basic peut être situé sous Autres langages, selon les paramètres de démarrage dans Visual Studio.

3. Dans la zone Nom, tapez le nom du projet : ReportWalkthrough.

4. Dans la zone Emplacement, entrez le répertoire dans lequel vous désirez enregistrer votre projet ou bien cliquez sur Parcourir pour naviguer jusqu'à celui-ci.

5. Cliquez sur OK.

   Le Concepteur Windows Forms s'ouvre et affiche le formulaire Form1.vb du projet que vous avez créé.

Définition d'une connexion de source de données et de DataTable

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

2. Dans la boîte de dialogue Ajouter un nouvel élément, sélectionnez Dataset.

3. Entrez un nom pour le dataset, puis cliquez sur Ajouter.Un nouveau fichier de schéma XML est ajouté au projet et le Concepteur de DataSet s'ouvre.Le nom par défaut est DataSet1.xsd.

4. Dans le Concepteur de DataSet, ouvrez la boîte à outils et faites glisser un TableAdapter vers l'aire de conception de dataset.Cette opération ouvre l'Assistant Configuration de TableAdapter.

5. Dans la page Choisir votre connexion de données, cliquez sur Nouvelle connexion.

6. Si vous créez une source de données dans Visual Studio pour la première fois, la page Choisir la source de données s'affiche.Dans la zone Source de données, sélectionnez Microsoft SQL Server.

7. Dans la page Ajouter une connexion, procédez comme suit :

   • Dans la zone Nom du serveur, entrez le nom du serveur qui héberge la base de données AdventureWorks2008.

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

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

   • Dans la liste déroulante, cliquez sur AdventureWorks2008.

   • Cliquez sur OK pour revenir dans l'Assistant.

8. Si vous avez spécifié Utiliser l'authentification SQL Server à l'étape précédente, sélectionnez l'option indiquant s'il convient d'inclure les données sensibles dans la chaîne ou de définir les informations dans votre code d'application.

9. Cliquez sur Suivant.

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

11. Dans la page Choisissez un type de commande, sélectionnez Utiliser des instructions SQL, puis cliquez sur Suivant.

12. Dans la page Entrez une instruction SQL, entrez la requête Transact-SQL suivante pour récupérer des données de la base de données AdventureWorks2008, puis cliquez sur Terminer.

    SELECT d.name as Dept, s.Name as Shift, 
        e.BusinessEntityID as EmployeeID
    FROM (HumanResources.Department d
    INNER JOIN HumanResources.EmployeeDepartmentHistory e
        ON d.DepartmentID = e.DepartmentID)
    INNER JOIN HumanResources.Shift s
        ON e.ShiftID = s.ShiftID
    

    Vous pouvez également cliquer sur le bouton Générateur de requêtes et utiliser le générateur de requêtes pour créer la requête, puis la vérifier à l'aide du bouton Exécuter la requête.Si la requête ne retourne pas les donnés prévues, vous utilisez peut-être une ancienne version d'AdventureWorks.Pour plus d'informations sur l'installation de la version AdventureWorks2008 d'AdventureWorks, consultez Procédure pas à pas : installation de la base de données AdventureWorks.

13. Dans la page Choisir les méthodes à générer, cliquez sur Terminer.

    Sur l'aire de conception DataSet, vous devez voir DataTable1 avec les colonnes résultant de la requête.

Conception du rapport à l'aide de l'Assistant Rapport

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

2. Dans la boîte de dialogue Ajouter un nouvel élément, cliquez sur Assistant Rapport.

3. Entrez un nom pour le fichier de rapport.Par défaut, le nom du rapport est Report1.rdlc.Cliquez sur Ajouter.

   L'Assistant Rapport démarre.

4. Dans la page Propriétés du dataset, dans la zone Source de données, sélectionnez le DataSet que vous avez créé.

   La zone Datasets disponibles est automatiquement mise à jour avec le DataTable que vous avez créé.

5. Cliquez sur Suivant.

6. Dans la page Organiser les champs, procédez comme suit :

   1. Faites glisser Dept à partir des champs disponibles vers la zone Groupes de lignes.

   2. Faites glisser Shift à partir des champs disponibles vers la zone Groupes de colonnes.

   3. Faites glisser EmployeeID à partir des champs disponibles vers la zone Valeurs.

   4. Cliquez sur la flèche en regard de Sum(EmployeeID) et sélectionnez Count.

7. Cliquez sur Suivant à deux reprises, puis sur Terminer.

   Le fichier .rdlc est créé et s'ouvre dans le Concepteur de rapports.Le tableau matriciel que vous avez conçu est à présent affiché dans l'aire de conception.

8. Enregistrez le fichier .rdlc.

Ajout d'un contrôle ReportViewer à l'application

1. Ouvrez le fichier Form1.vb dans votre projet en mode Création.

2. Dans la fenêtre Propriétés du formulaire, développez la propriété Size, puis affectez à la propriété Height la valeur 700.

3. Dans la section Création de rapports de la boîte à outils, faites glisser le contrôle ReportViewer vers le formulaire.

4. Ouvrez le panneau des balises actives du contrôle ReportViewer en cliquant sur le glyphe de balise active dans le coin supérieur droit.Cliquez sur la liste déroulante Choisir un rapport, puis sélectionnez le rapport que vous avez créé.Lorsque vous sélectionnez un rapport, des instances des sources de données utilisées dans le rapport sont automatiquement créées.Du code est généré pour instancier un DataSet (le conteneur ADO.NET d'un DataTable), un composant TableAdapter et un objet BindingSource correspondant à chaque source de données utilisée dans le rapport.

5. Dans le panneau des balises actives, choisissez Ancrer dans le conteneur parent.

Génération et exécution de l'application

1. Dans le menu Générer, cliquez sur Générer Procédure_pas_à_pas_Rapport.Dans le cadre du processus de génération, le rapport est compilé.Certaines erreurs (telles qu'une erreur de syntaxe dans une expression utilisée dans le rapport) sont signalées en les ajoutant à la Liste des tâches.

2. Appuyez sur la touche F5pour exécuter l'application et afficher le rapport dans le formulaire.

Voir aussi

Référence

ReportViewer.Drillthrough

LocalReport.SubreportProcessing

ReportViewer.Drillthrough

LocalReport.SubreportProcessing

Concepts

Utilisation du panneau des balises actives des tâches ReportViewer

Autres ressources

Exemples et procédures pas à pas