Ajout et configuration de contrôles ReportViewer
Vous pouvez ajouter une ou plusieurs instances d'un contrôle ReportViewer à une application Microsoft Windows ou ASP.NET en faisant glisser le contrôle de la section Données de la boîte à outils Visual Studio à une page ou un formulaire de votre application. Vous pouvez utiliser un panneau de balises actives et des propriétés pour configurer le contrôle et lier le rapport. Vous pouvez également écrire du code si vous souhaitez configurer le contrôle par programme.
Le contrôle ReportViewer affiche une définition de rapport à la fois. Vous pouvez combiner plusieurs instances du contrôle sur la même page ou le même formulaire si vous souhaitez afficher plusieurs rapports simultanément. Vous pouvez également utiliser une instance spécifique du contrôle pour héberger plusieurs rapports tant que le utilisateurs affichent un rapport à la fois. Pour afficher une série de rapports à l'aide d'un seul contrôle, vous devez écrire un code qui associe un rapport à l'instance du contrôle ReportViewer que vous souhaitez utiliser.
Les contrôles ReportViewer fonctionnent en mode de traitement local ou en mode de traitement distant.
En mode de traitement local, le contrôle ouvre une définition de rapport, la traite, puis la charge dans la zone d'affichage. En mode de traitement local, vous pouvez obtenir la définition de rapport à partir d'un fichier .rdlc sur le système de fichiers, à partir d'un flux, ou à partir d'une ressource incorporée dans votre application. Pour plus d'informations, consultez ReportPath, LoadReportDefinition et ReportEmbeddedResource.
En mode de traitement distant, le contrôle récupère un rapport entièrement traité à partir d'un serveur de rapports Microsoft SQL Server 2005 Reporting Services. En mode de traitement distant, le contrôle ReportViewer a deux fonctions : il sert d'afficheur et assure la prise en charge de l'interaction avec un rapport. En mode de traitement distant, le traitement de données et le rendu sont entièrement effectués sur le serveur de rapports. Le traitement distant nécessite des rapports prépubliés Vous pouvez obtenir le rapport à partir d'un flux ou en spécifiant l'URL de l'adresse du rapport. Vous ne pouvez pas utiliser des fichiers .rdlc en mode de traitement distant. Pour plus d'informations, consultez LoadReportDefinition, ReportServerUrl et ReportPath.
Important
Le mode de traitement distant nécessite une copie avec licence d'utilisation de SQL Server 2005 Reporting Services. Le traitement distant est destiné à prendre en charge des entreprises disposant d'un serveur de rapports SQL Server Reporting Services et souhaitant l'utiliser avec les contrôles. Une solution de serveur assure une meilleure évolutivité et de plus hautes performances, et offre des fonctions supplémentaires telles que les abonnements, la mise en mémoire cache et d'autres formats de sortie de rapport. Il est important de noter que certaines différences visuelles et fonctionnelles sont introduites dans un rapport lors d'un traitement distant. Pour plus d'informations sur le mode de traitement distant, consultez Configuration de ReportViewer pour un traitement distant et Déploiement de rapports et de contrôles ReportViewer.
Comment ajouter et configurer un contrôle ReportViewer
Ajoutez une page Windows Form ou Web à votre projet.
En mode de conception graphique, faites glisser le contrôle ReportViewer de la boîte à outils au formulaire ou à la page Web. Le contrôle ReportViewer se trouve dans la section Données de la boîte à outils. Le contrôle inclut un panneau de balises actives de tâches ReportViewer permettant de sélectionner immédiatement un rapport.
Dans le panneau des balises actives Tâches ReportViewer, sélectionnez les tâches pour ajouter un rapport et configurer le contrôle. La spécification du rapport détermine si le contrôle est configuré pour un traitement local ou distant.
Cliquez sur Concevoir un nouveau rapport pour démarrer le Générateur de rapports et créer un fichier de définition de rapport (.rdlc) dans votre application. Vous pouvez créer de nouveaux rapports dans votre application qui sont traités localement sur le client. Pour en savoir plus sur la création de rapports, consultez Création de fichiers de définition de rapport client (.rdlc).
Utilisez Choisir un rapport pour sélectionner une définition de rapport existante. Vous pouvez choisir un fichier de définition de rapport local (.rdlc) qui est défini dans le projet ou vous pouvez choisir Rapport du serveur pour sélectionner un rapport qui est publié sur un serveur de rapports SQL Server 2005 Reporting Services.
La sélection d'un rapport du serveur configure le contrôle pour un traitement distant. Pour sélectionner un rapport du serveur, vous devez connaître l'URL du serveur de rapports et le chemin d'accès au rapport. Le chemin du rapport doit commencer par une barre oblique ( / ). Pour exécuter le rapport, vous devez avoir une autorisation d'accès au rapport sur le serveur de rapports. Si vous ne connaissez pas l'URL ni le chemin d'accès au rapport, consultez l'administrateur de votre serveur de rapports. Pour plus d'informations sur les rapports du serveur, consultez Configuration de ReportViewer pour un traitement distant.
La sélection d'un fichier de définition de rapport existant (.rdlc) configure de contrôle en vue d'un traitement local. Lors du choix d'un rapport, vous devez choisir un fichier .rdlc ; vous ne pouvez pas spécifier un fichier .rdl même s'il en existe un dans votre projet. Si vous souhaitez utiliser un fichier .rdl, vous devez le convertir. Pour plus d'informations, consultez Création de fichiers de définition de rapport client (.rdlc) et Conversion de fichiers RDL et RDLC.
Cliquez sur Ancrer dans le conteneur parent pour développer la surface d'affichage du contrôle ReportViewer afin qu'il utilise tout l'espace disponible dans le formulaire ou la page. Cette option est disponible avec le contrôle Windows Forms.
Cliquez sur Relier les sources de données pour mettre à jour les liaisons de sources de données pour les tables et objets Business utilisés dans le rapport. Cette option est disponible après que vous avez sélectionné un rapport pour le contrôle. Vous devez relier une source de données si vous modifiez une source de données de rapport ou si vous modifiez un élément de rapport lié aux données à l'extérieur de l'environnement graphique de conception de rapport (par exemple si vous modifiez directement le code XML).
Sectionnez le contrôle ReportViewer et ouvrez la fenêtre Propriétés.
Définissez des propriétés sur le contrôle ReportViewer afin de déterminer la visibilité et la disponibilité des zones d'affichage. Utilisez la documentation de référence pour en savoir plus sur chaque propriété. Pour plus d'informations, consultez Propriétés ReportViewer. Pour en savoir plus sur la barre d'outils de ReportViewer, consultez Configuration et utilisation de la barre d'outils ReportViewer.
Construisez ou déployez l'application pour obtenir un aperçu du rapport dans le formulaire ou la page.
Voir aussi
Concepts
Utilisation du panneau des balises actives des tâches ReportViewer
Création de fichiers de définition de rapport client (.rdlc)
Configuration de ReportViewer pour le traitement local
Configuration de ReportViewer pour un traitement distant
Configuration de sous-rapports et de rapports d'extraction (Concepteur de rapports Visual Studio)
Contrôles de serveur Web et Windows Forms de ReportViewer