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 pouvez télécharger ReportViewer.exe à partir du Centre de téléchargement Microsoft.

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

• Microsoft.ReportViewer.Common.dll

• Microsoft.ReportViewer.ProcessingObjectModel.dll

• Microsoft.ReportViewer.WebForms.dll

• Microsoft.ReportViewer.WinForms.dll

• Microsoft.ReportViewer.DataVisualization.dll

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. Cette opération doit être effectuée par un administrateur du serveur.

• Pour les applications ClickOnce Windows Forms, incluez les contrôles en tant que composants nécessaires à l'application afin qu'ils soient installés automatiquement avec votre application ClickOnce. 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 l'onglet Publier, puis cliquez sur le bouton Composants requis.

  3. Sélectionnez Visionneuse de rapports de Microsoft Visual Studio, Types CLR SQL Server, puis cliquez sur OK.

  4. Assurez-vous que l'option Télécharger les composants requis à partir du site Web du fournisseur de composant est activée. Cette option est la seule prise en charge. Cliquez ensuite sur OK.

  5. Cliquez sur le bouton Options.

  6. Dans l'onglet Déploiement, spécifiez une page Web de déploiement et activez la case à cocher Générer automatiquement la page Web de déploiement à chaque publication.

  7. Cliquez sur OK et publiez l'application.

  Lorsque vous accédez à une application ClickOnce, notamment via une page Web, un contrôle est effectué sur votre ordinateur client pour vérifier si les composants requis ReportViewer sont déjà installés. S'ils ne sont pas installés, le programme d'installation effectue l'opération.

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

Le contrôle ReportViewer redistribuable est localisé dans dix langues Visual Studio : Chinois simplifié, Chinois traditionnel, Français, Allemand, Italien, Japonais, Coréen, Portugais (Brésil), Russe et Espagnol. Si vous installez une version localisée de Visual Studio, vous pouvez télécharger tout redistribuable localisé ReportViewer à partir du Centre de téléchargement Microsoft.

Pour utiliser d'autres langues dans un contrôle ReportViewer, vous pouvez implémenter l'interface IreportViewerMessages3 ou IreportViewerMessages3 pour créer des info-bulles et d'autres types de texte d'interface utilisateur dans une langue 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 Thread.CurrentCulture et 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 des fichiers de rapports

Sauf si vous générez dynamiquement des fichiers de définition de rapport client au moment de l'exécution à l'aide de la méthode LocalReport.LoadReportDefinition ou ServerReport.LoadReportDefinition, différentes options sont à votre disposition pour distribuer des fichiers de rapports avec votre application, selon le mode de traitement du contrôle de la visionneuse de rapports.

Les rapports traités localement peuvent être stockés dans un dossier réseau ou compilés dans le fichier exécutable de l'application. Les rapports qui sont traités sur un serveur distant sont en général stockés sur un serveur de rapports SQL Server Reporting Services. À moins que vous ne vouliez utiliser la méthode ServerReport.LoadReportDefinition pour charger manuellement un rapport à partir d'un emplacement autre que le serveur de rapports, il n'existe aucun fichier de rapport à inclure dans votre application. 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