Configuration et utilisation de la barre d'outils ReportViewer

Article
05/09/2011

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.

Barre d'outils ReportViewer

Notes

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 varie selon que vous utilisez le contrôle de serveur Web ou le contrôle Windows Forms.

Explorateurs de documents

Un explorateur de documents est une zone de navigation qui contient une liste de liens sur lesquels les utilisateurs peuvent cliquer pour atteindre une zone spécifique du rapport. L'explorateur de documents est un curseur de fractionnement réductible situé sur le côté gauche de la zone d'affichage du rapport (ou sur le côté droit dans les environnements de droite à gauche). Tous les rapports ne possèdent pas un explorateur de documents ; vous devez en définir un dans la définition de rapport si vous souhaitez l'afficher dans la visionneuse de rapports. Pour plus d'informations sur les explorateurs de documents et autres fonctionnalités de rapport interactives, consultez Adding Interactivity and Navigation to a ReportViewer Report.

La barre d'outils ReportViewer comprend une série de fonctions permettant de naviguer entre les pages. L'utilisateur peut 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 Defining Page Size and Page Breaks in a ReportViewer Report.

Étant donné que le contrôle ReportViewer ASP.NET utilise des publications asynchrones pour l'interactivité par défaut, l'utilisateur ne peut pas employer le bouton Précédent du navigateur sauf si vous affectez à la propriété InteractivityPostBackMode la valeur AlwaysSynchronous.

Pour naviguer dans des rapports d'extraction, l'utilisateur peut employer le bouton Revenir au rapport parent de la barre d'outils ReportViewer ou le bouton Précédent du navigateur si vous définissez la propriété InteractivityPostBackMode en conséquence. Toutefois, il est recommandé de concevoir votre application avec une option de navigation à l'esprit afin de maintenir la cohérence de l'état de session lorsque l'utilisateur navigue dans des rapports d'extraction. Sinon, l'utilisateur peut recevoir un message d'erreur indiquant un retour au rapport parent sans rapport d'extraction lors de la navigation dans des rapports d'extraction. Pour aider l'utilisateur à s'en tenir à une option de navigation, vous pouvez :

Utiliser le mode AlwaysAsynchronous et affecter à ShowBackButton la valeur true.
Utiliser le mode AlwaysSynchronous ou SynchronousOnDrillthrough et affecter à ShowBackButton la valeur false. L'utilisateur se limite ainsi au bouton Précédent du navigateur. Notez que cette option ne tire pas parti des fonctionnalités AJAX du contrôle serveur Web.

Arrêt et actualisation d'un rapport

Dans le contrôle serveur Web, l'utilisateur peut cliquer sur le lien Annuler dans l'indicateur de disponibilité pour annuler le rendu du rapport. Dans le contrôle Windows Forms, l'utilisateur peut cliquer sur le bouton Arrêter dans la barre d'outils ReportViewer pour annuler le rendu du rapport. L'utilisateur peut employer le bouton Actualiser pour déclencher le rendu du rapport.

Si l'utilisateur clique sur Actualiser pour un rapport de serveur, le serveur de rapports traite à nouveau celui-ci avec les données les plus récentes. Notez que les données les plus récentes sont soumises à la mise en cache et aux stratégies d'instantanés définies sur le rapport.

Si l'utilisateur clique sur Actualiser pour un rapport local, le comportement peut être différent. Étant donné que les rapports traités localement utilisent des données fournies par votre application, il est possible que vous deviez mettre à jour votre source de données lors des opérations d'actualisation en fournissant un code qui gère l'événement ReportViewer.ReportRefresh. Si vous ne gérez pas cet événement pour le contrôle Windows Forms, le fait de cliquer sur Actualiser actualisera le rapport avec les anciennes données de votre application. Pour plus d'informations sur l'événement ReportViewer.ReportRefresh du contrôle serveur Web, consultez ReportRefresh. Pour plus d'informations sur la version du contrôle Windows Forms, consultez ReportRefresh.

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 ReportViewer. En outre, le contrôle serveur Web offre uniquement la prise en charge de l'impression dans Internet Explorer. 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. Le contrôle serveur Web offre uniquement la prise en charge du zoom dans Internet Explorer.

Recherche 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 ne respecte pas la casse et commence au niveau de la page actuellement affiché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, aucune recherche n'est effectuée dans le contenu masqué. Pour rechercher d'autres occurrences de la même valeur, cliquez sur Suivant.

Exportation d'un rapport

La barre d'outils ReportViewer fournit des formats d'exportation afin que l'utilisateur puisse enregistrer un rapport sous un format pris en charge. Un rapport local peut être exporté dans un fichier Excel, PDF ou Word. Un rapport de serveur peut être exporté sous n'importe quel format pris en charge par le serveur de rapports. Si vous utilisez le contrôle 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 un nombre différent de pages ou des espaces supplémentaires. Pour plus d'informations, consultez Exporting Reports dans la documentation en ligne de SQL Server.