Configuration et utilisation de la barre d'outils ReportViewer

Vous pouvez définir des propriétés dans la fenêtre Propriétés ou sous forme de code pour configurer le contrôle ReportViewer et la barre d'outils ReportViewer. Vous pouvez supprimer ou désactiver des commandes spécifiques et définir des valeurs permettant d'initialiser la barre d'outils. Pour plus d'informations sur les propriétés du contrôle serveur Web ReportViewer, consultez Propriétés ReportViewer (Microsoft.Reporting.WebForms). Pour plus d'informations sur les propriétés du contrôle Windows Forms, consultez Propriétés ReportViewer (Microsoft.Reporting.WinForms).

Barre d'outils ReportViewer

Le contrôle ReportViewer comprend une barre d'outils qui fournit des fonctionnalités de navigation, de recherche, d'exportation et d'impression permettant d'utiliser des rapports dans une application déployée. Vous pouvez définir des propriétés sur la barre d'outils au moment de la conception pour contrôler son aspect et déterminer la disponibilité des options d'exécution. Si vous souhaitez une implémentation de barre d'outils différente, vous pouvez créer une barre d'outils personnalisée afin de remplacer la barre d'outils par défaut.

Remarque
Les éléments d'interface utilisateur n'étant pas restitués de la même façon dans les formats HTML et GDI (Graphics Design Instrumentation), la barre d'outils de rapport peut varier légèrement selon que vous utilisez le contrôle de serveur Web ou le contrôle Windows Forms.

Plans de document

La barre d'outils ReportViewer comprend une icône permettant d'afficher/masquer un plan de document sur un rapport. Un plan de document est une zone de navigation attachée au côté gauche de la zone d'affichage du rapport. Il contient une liste de liens sur lesquels les utilisateurs peuvent cliquer pour naviguer jusqu'à une zone spécifique du rapport. Tous les rapports ne possèdent pas un plan de document ; vous devez en définir un dans la définition de rapport si vous souhaitez utiliser cette fonctionnalité. Pour plus d'informations sur les plans de document et autres fonctionnalités de rapport interactives, consultez Ajout d'interactivité, de visibilité et de navigation à un rapport (Concepteur de rapports Visual Studio).

Navigation dans un rapport

La barre d'outils ReportViewer comprend une série de fonctions permettant de naviguer entre les pages. Vous pouvez sélectionner une page spécifique ou naviguer directement jusqu'à la première ou la dernière page. Les pages sont déterminées par des sauts de page définis explicitement dans la définition de rapport. Les sauts de page peuvent également être calculés automatiquement, selon le format de sortie de rapport utilisé. Pour plus d'informations, consultez Définition de la taille de la page et des sauts de page dans un rapport (Concepteur de rapports Visual Studio).

Lorsque vous naviguez dans des rapports HTML composés de plusieurs pages, vous pouvez utiliser le bouton Précédent du navigateur. Si vous n'utilisez pas la barre d'outils du navigateur dans votre application, une autre solution consiste à recourir au bouton Précédent de la barre d'outils ReportViewer. Par défaut, le bouton Précédent de la barre d'outils ReportViewer est désactivé. Si vous souhaitez utiliser ce bouton, activez la propriété ShowBackButton du contrôle ReportViewer.

Pour naviguer dans des rapports d'extraction, vous pouvez utiliser la commande Revenir au rapport parent de la barre d'outils ReportViewer, le bouton Précédent du navigateur ou le bouton Précédent de la barre d'outils ReportViewer. Lorsque vous visualisez des rapports d'extraction dans le contrôle de serveur Web ReportViewer, vous devez toujours utiliser un seul type de bouton Précédent. Si vous utilisez une combinaison de boutons Précédent dans la même session de rapport, vous pouvez vous trouver dans une situation où vous essayez de naviguer jusqu'à un rapport d'extraction qui ne figure plus dans la session. Si cela se produit, vous obtenez un message d'erreur. L'utilisation de la commande Revenir au rapport parent empêche cette condition d'erreur de se produire.

Arrêt et actualisation d'un rapport

Vous pouvez utiliser les boutons Actualiser et Arrêter pour déclencher ou arrêter la génération de rapport. Si vous cliquez sur Actualiser pour un rapport de serveur traité à distance, le serveur de rapports traite immédiatement celui-ci avec les données les plus récentes. Les options d'exécution de rapport configurées sur le rapport déterminent si les données sont en réalité actualisées ou extraites du cache. Le contrôle ne vérifie pas les propriétés de rapport de serveur ; par conséquent, vous devez consulter l'administrateur du serveur de rapports pour savoir si le rapport est configuré de manière à utiliser des données en direct.

L'actualisation diffère pour le mode de traitement local. Étant donné que les rapports traités localement utilisent des données fournies par votre application, le code d'application est supposé gérer les opérations d'actualisation. Pour utiliser le bouton Actualiser de la barre d'outils, vous devez fournir du code qui gère l'événement Refresh. Si vous ne gérez pas cet événement, le fait de cliquer sur Actualiser n'a aucun effet. Pour plus d'informations sur l'événement Refresh du contrôle de serveur Web, consultez Refresh. Pour plus d'informations sur la version du contrôle Windows Forms, consultez Refresh.

Impression d'un rapport

La barre d'outils ReportViewer prend en charge l'impression. La prise en charge de l'impression est implémentée différemment pour chaque version du contrôle et suivant le mode de traitement utilisé. Bien que vous ne puissiez pas personnaliser ou configurer les fonctionnalités d'impression, vous devez activer la prise en charge de l'impression sur le serveur de rapports pour les rapports de serveur exécutés dans le contrôle de serveur Web ReportViewer. Pour plus d'informations, consultez Impression des rapports depuis ReportViewer.

Application du zoom à la page de rapport

La barre d'outils ReportViewer fournit des fonctionnalités de zoom standard qui vous permettent d'agrandir ou de réduire le rapport.

Consultation d'un rapport

La barre d'outils ReportViewer comprend un champ de recherche qui vous permet de rechercher du texte spécifique dans un rapport. Recherchez du contenu dans le rapport en tapant le mot ou l'expression à rechercher. La recherche respecte la casse et commence au niveau de la page ou de la section actuellement sélectionnée. Les caractères génériques et les opérateurs de recherche booléens ne sont pas pris en charge. Seul le contenu visible est compris dans une opération de recherche. Si le rapport utilise la fonctionnalité Afficher/Masquer, le contenu masqué n'est pas exposé par le biais des opérations de recherche. Pour rechercher d'autres occurrences de la même valeur, cliquez sur Suivant.

Exportation d'un rapport

La barre d'outils ReportViewer met à votre disposition des formats d'exportation qui vous permettent d'enregistrer un rapport en tant que fichier d'application Excel ou PDF. Si vous utilisez le contrôle de serveur Web, vous pouvez définir la propriété ExportContentDisposition du contrôle pour afficher immédiatement, dans Excel ou dans une visionneuse PDF, le rapport exporté au lieu de l'enregistrer dans un fichier.

Le format de génération sélectionné détermine l'aspect et les fonctionnalités du rapport. Un rapport qui a des liens, des plans de document et des signets peut ne pas fonctionner correctement une fois enregistré dans un fichier. Selon la façon dont vous alignez les éléments dans un rapport, sa mise en page dans un format de fichier différent peut comprendre des pages ou des espaces supplémentaires inattendus.

Voir aussi

Concepts

Impression des rapports depuis ReportViewer
Contrôles de serveur Web et Windows Forms de ReportViewer
Configuration de ReportViewer pour le traitement local
Configuration de ReportViewer pour un traitement distant