Ajout et configuration de contrôles ReportViewer

Article
05/09/2011

Vous pouvez ajouter une ou plusieurs instances d'un contrôle ReportViewer à une application Windows Forms ou ASP.NET en faisant glisser le contrôle de la section Création de rapports de la boîte à outils vers 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 un 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 unique du contrôle pour héberger les rapports un à 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 rend le rapport 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 Reporting Services. En mode de traitement distant, les traitements de données et du rapport sont entièrement effectués sur le serveur de rapports. Le mode de traitement distant est utilisé en général pour les rapports prépubliés, mais vous pouvez également utiliser le traitement distant pour une définition de rapport que vous fournissez à l'aide d'un flux. Pour plus d'informations, consultez LoadReportDefinition, ReportServerUrl et ReportPath.

Important

Vous ne pouvez pas utiliser des fichiers .rdlc en mode de traitement distant. Le mode de traitement distant nécessite une copie sous licence de SQL Server 2008 (ou version ultérieure) 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. 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 un formulaire Windows ou Web à un projet .NET Framework 3.5 ou 4.0.
En mode de conception graphique, faites glisser le contrôle ReportViewer du groupe Création de rapports de la Boîte à outils vers le formulaire Windows ou Web. Le contrôle inclut un panneau de balises actives de tâches ReportViewer permettant de sélectionner immédiatement un rapport.

Le fichier web.config est automatiquement mis à jour avec le gestionnaire HTTP pour le contrôle ReportViewer. Pour plus d'informations, consultez Paramètres Web.config pour ReportViewer.

Notes

Pour utiliser le contrôle ReportViewer dans un formulaire Web, vous devez également ajouter un contrôle ScriptManager à votre page. À partir de la fenêtre Boîte à outils, dans le groupe Extensions AJAX, faites glisser un contrôle ScriptManager vers l'aire de conception au-dessus du contrôle ReportViewer.
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 l'Assistant Rapport 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 2008 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. Lorsque vous faites référence à un rapport sur un serveur de rapports en mode natif, le chemin d'accès du rapport commence par une barre oblique (/) ; lorsque vous faites référence à un rapport sur un serveur de rapports en mode intégré SharePoint, le chemin d'accès du rapport est une URL complète. Par exemple :
  
  Mode natif : /Adventureworks 2008 Sample Reports/Company Sales 2008
  
  Mode intégré SharePoint : http://MyServer/sites/MySite/MyLibrary/Adventureworks 2008 Sample Reports/Company Sales 2008.rdl
  
  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. Pour plus d'informations, consultez Création de fichiers de définition de rapport client (.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).
Sélectionnez 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.