Procédure pas à pas : utilisation d'une source de données de base de données avec le contrôle serveur Web ReportViewer en mode de traitement local
Cette procédure pas à pas indique comment créer un rapport pour un site Web ASP.NET et ajouter un contrôle ReportViewer à une page Web afin que les utilisateurs puissent afficher le rapport.
Configuration préalable requise
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.
Effectuez les étapes suivantes sur votre ordinateur pour créer une page Web ASP.NET avec un contrôle ReportViewer configuré pour afficher un rapport local. Pour cet exemple, vous créez l'application en Microsoft Visual Basic.
Créez un nouveau site Web.
Dans le menu Fichier, pointez sur Nouveau, puis sélectionnez Site Web.
Dans la boîte de dialogue Nouveau site Web, dans le volet Modèles installés, sélectionnez Visual Basic, puis choisissez Site Web ASP.NET.
Dans la zone Emplacement, spécifiez un répertoire de projet et cliquez sur OK.
Le projet de site Web s'ouvre.
Définissez une connexion de données et DataTable en ajoutant un DataSet.
Dans le menu Site Web, sélectionnez Ajouter un nouvel élément.
Dans la boîte de dialogue Ajouter un nouvel élément, sélectionnez DataSet, puis cliquez sur Ajouter. Lorsqu'un message vous demande si vous souhaitez ajouter l'élément au dossier App_Code, cliquez sur Oui.
Un nouveau fichier XSD, DataSet1.xsd, est ajouté au projet et le Concepteur de DataSet s'ouvre.
À partir de la fenêtre Boîte à outils, faites glisser un contrôle TableAdapter vers l'aire de conception. L'Assistant Configuration de TableAdapter est appelé.
Dans la page Choisir votre connexion de données, cliquez sur Nouvelle connexion.
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.
Dans la boîte de dialogue 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 Sélectionner ou entrer un nom de base de données, cliquez sur AdventureWorks2008.
Cliquez sur Suivant.
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.
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.
Dans la page Choisissez un type de commande, sélectionnez Utiliser des instructions SQL, puis cliquez sur Suivant.
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.ShiftIDVous pouvez également cliquer sur le bouton Générateur de requêtes, puis utilisez le Générateur de requêtes pour créer la requête et 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.
Vous avez maintenant terminé la configuration d'ADO.NET DataTable en tant que source de données de votre rapport. Dans la page Concepteur de DataSet de Visual Studio, vous devriez voir le DataTable que vous avez ajouté (le nom par défaut est DataTable1), répertoriant les colonnes résultant de votre définition de requête. Dans le menu Données, vous pouvez sélectionner Aperçu des données, puis cliquer sur le bouton Aperçu pour vérifier les résultats de votre requête.
Dans la page Choisir les méthodes à générer, cliquez sur Terminer.
Enregistrez le fichier.
Conception du rapport à l'aide de l'Assistant Rapport
Assurez-vous que le site Web de niveau supérieur est sélectionné dans l'Explorateur de solutions.
Cliquez avec le bouton droit sur le site Web et sélectionnez Ajouter un nouvel élément.
Dans la boîte de dialogue Ajouter un nouvel élément, sélectionnez Assistant Rapport, entrez un nom pour le fichier de rapport, puis cliquez sur Ajouter.
L'Assistant Rapport démarre.
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éé.
Cliquez sur Suivant.
Dans la page Organiser les champs, procédez comme suit :
Faites glisser Dept à partir des champs disponibles vers la zone Groupes de lignes.
Faites glisser Shift à partir des champs disponibles vers la zone Groupes de colonnes.
Faites glisser EmployeeID à partir des champs disponibles vers la zone Valeurs.
Cliquez sur la flèche en regard de Sum(EmployeeID) et sélectionnez Count.
Cliquez sur Suivant à deux reprises, puis sur Terminer pour fermer l'Assistant Rapport.
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.
Enregistrez le fichier .rdlc.
Ajout d'un contrôle ReportViewer à l'application
Dans l'Explorateur de solutions, cliquez avec le bouton droit sur le formulaire Web Default.aspx, puis sélectionnez Concepteur de vues.
Ouvrez la fenêtre Boîte à outils. À partir du groupe Extensions AJAX, faites glisser un contrôle ScriptManager vers l'aire de conception.
Dans la fenêtre Boîte à outils, dans le groupe Création de rapports, faites glisser un contrôle ReportViewer vers la page sous le contrôle ScriptManager.
S'il ne l'est pas déjà, ouvrez le panneau des balises actives des tâches ReportViewer en cliquant sur le glyphe de balise active dans le coin supérieur droit. Dans la zone Choisir un rapport, sélectionnez le rapport que vous avez créé.
Lorsque vous sélectionnez un rapport, les instances de sources de données utilisées dans le rapport sont créées automatiquement. Un code est généré pour instancier chaque DataTable (et son conteneur DataSet) et un contrôle ObjectDataSource correspondant à chaque source de données employée dans le rapport. Le contrôle de source de données est configuré automatiquement.
Génération et exécution de l'application
Appuyez sur CTRL+F5 pour exécuter la page sans débogage ou sur F5 pour une exécution avec débogage.
Au cours du processus de génération, le rapport est compilé et les éventuelles erreurs détectées (par exemple une erreur de syntaxe dans une expression utilisée dans le rapport) sont ajoutées à la liste des tâches.
La page Web s'affiche dans le navigateur. Le contrôle ReportViewer affiche le rapport. Vous pouvez utiliser la barre d'outils pour naviguer dans le rapport, effectuer un zoom et exporter les données dans Excel.
Fermez le navigateur.
Voir aussi
Référence
LocalReport.SubreportProcessing
LocalReport.SubreportProcessing
Concepts
Utilisation du panneau des balises actives des tâches ReportViewer