Partager via


Déploiement de rapports et de contrôles ReportViewer

Vous pouvez librement distribuer des rapports et les contrôles ReportViewer en tant que partie intégrante de votre application. Les conditions de déploiement varient largement selon le type de contrôle et la configuration de votre rapport en vue d'un traitement local ou distant. Vous pouvez déployer des rapports traités localement et à distance dans la même application.

Redistribution des contrôles ReportViewer

Le contrôle ReportViewer redistribuable est un fichier auto-extractible nommé ReportViewer.exe qui inclut un fichier .msi ainsi que d'autres fichiers. Vous trouverez ReportViewer.exe à l'emplacement suivant : C:\Program Files\Microsoft Visual Studio 8\SDK\v2.0\BootStrapper\Packages\ReportViewer\ReportViewer.exe.

Lorsque vous exécutez ReportViewer.exe, les fichiers suivants sont copiés dans le dossier GAC (Global Assembly Cache) sur l'ordinateur de déploiement.

Fichier Description

Microsoft.ReportViewer.Common

Fournit des fonctionnalités centrales de création de rapports communes au contrôle Windows Forms ReportViewer et au contrôle serveur Web.

Microsoft.ReportViewer.ProcessingObjectModel

Expose le modèle objet de rapport de manière à ce qu'il soit accessible par programme au moment de l'exécution à partir d'expressions dans la définition de rapport.

Microsoft.ReportViewer.WebForms

Fournit le contrôle ReportViewer pour les pages ASP.NET.

Microsoft.ReportViewer.WinForms

Fournit le contrôle ReportViewer pour les applications Windows.

Exécution de ReportViewer.exe

Le type de contrôle que vous utilisez détermine où ReportViewer.exe doit être exécuté.

  • Pour les applications ASP.NET, exécutez ReportViewer.exe sur le serveur Web qui héberge votre application.

  • Pour les applications Windows Forms, incluez les contrôles en tant que composants nécessaires à l'application afin qu'ils soient installés automatiquement avec votre application. Vous pouvez utiliser l'application d'amorçage pour automatiser cette étape :

    1. Ouvrez la page des propriétés du projet.

    2. Cliquez sur Publier, puis sur Composants requis.

    3. Sélectionnez Visionneuse de rapportsMicrosoft Visual Studio 2008, puis cliquez sur OK.

    4. Publiez l'application.

Pendant l'installation de l'application, un contrôle est effectué sur l'ordinateur local pour voir si ReportViewer est déjà installé. S'il n'est pas installé, le programme d'installation effectue l'opération.

Déploiement des versions localisées des contrôles ReportViewer

Le contrôle ReportViewer inclut des modules linguistiques dans dix langues Visual Studio : Chinois simplifié, Chinois traditionnel, Français, Allemand, Italien, Japonais, Coréen, Portugais (Brésil), Russe et Espagnol. Pour utiliser une version localisée du contrôle, vous devez procéder comme suit :

  1. Exécutez ReportViewer.exe.

  2. Ouvrez le dossier qui contient le module linguistique souhaité. Les dossiers des modules linguistiques sont situés à l'adresse <lecteur>:\Program Files\Microsoft SDKs\Windows\v6.0A\BootStrapper\Packages\ReportViewer\<lang>.

  3. Exécutez ReportViewerLP.exe.

Pour utiliser d'autres langues dans un contrôle ReportViewer, vous pouvez implémenter l'interface Microsoft.Reporting.WebForms.IReportViewerMessages ou Microsoft.Reporting.WinForms.IReportViewerMessages pour créer des info-bulles et d'autres types de texte d'interface utilisateur dans un langage spécifique.

Détection des paramètres de langue et de culture du navigateur

Si vous utilisez le contrôle serveur Web ReportViewer pour héberger des rapports dans une application de navigateur, n'oubliez pas de définir la culture du thread si vous souhaitez fournir une interface utilisateur correspondant aux paramètres de langue et de culture du navigateur. ASP.NET ne définit pas la culture du thread en fonction des informations d'en-tête fournies par le client. Pour mettre votre application en adéquation avec les paramètres de culture du navigateur, vous pouvez définir les propriétés System.Threading.Thread.CurrentCulture et System.Threading.Thread.CurrentUICulture dans le code de votre application. Pour plus d'informations sur l'utilisation des paramètres de culture dans votre application, consultez System.Globalization.CultureInfo (page pouvant être an anglais).

Aspects de déploiement pour le contrôle de serveur Web de visionneuse de rapport

Le déploiement d'une application ASP.NET dans une batterie de serveurs Web nécessite une confirmation supplémentaire pour s'assurer que l'État d'affichage est maintenu dans l'ensemble de la batterie de serveurs. Si vous déployez le contrôle de serveur Web ReportViewer dans un environnement de batterie de serveurs Web, vous devez spécifier l'élément machineKey dans le fichier Web.config de votre application. Pour plus d'informations, consultez Paramètres Web.config pour ReportViewer.

Les rapports traités dans le contrôle serveur Web ReportViewer présentent différentes exigences relatives au navigateur. Les problèmes de compatibilité de navigateur peuvent affecter la disponibilité de certains types de fonctionnalités de rapport. Pour plus d'informations, consultez Prise en charge d'un navigateur pour les contrôles de serveur Web ReportViewer.

Distribution de rapports

Sauf si vous générez dynamiquement des fichiers de définition de rapport client (.rdlc) au moment de l'exécution, les rapports qui sont traités localement sont stockés sur le système de fichiers en tant que fichiers .rdlc et doivent être livrés avec votre application. Les fichiers peuvent être installés sur le disque dur ou compilés dans l'exécutable de l'application.

Les rapports qui sont traités sur un serveur distant sont stockés sur un serveur de rapports Microsoft SQL Server 2005 Reporting Services. Il n'y a aucun fichier de rapport à inclure dans votre application car les rapports sont traités à distance et n'existent pas sur le système local. Pour déployer des rapports qui sont publiés sur un serveur de rapports, vous devez fournir un accès permanent à un serveur de rapports et garantir que les utilisateurs d'applications sont autorisés à afficher des rapports sur ce serveur. Le déploiement de rapports de serveur nécessite une compréhension de l'extension d'authentification utilisée par le serveur de rapports et du modèle d'autorisation basé sur les rôles qui donne accès au contenu et aux opérations. Pour plus d'informations, consultez Aspects de déploiement pour les rapports de serveur.

Voir aussi

Concepts

Ajout et configuration de contrôles ReportViewer
Paramètres Web.config pour ReportViewer
Configuration de ReportViewer pour un rendu asynchrone
Configuration et utilisation de la barre d'outils ReportViewer