Share via


Configuration de ReportViewer pour le traitement local

Vous pouvez configurer un contrôle ReportViewer pour traiter les rapports localement afin qu'ils utilisent le traitement intégré fourni par le contrôle. Lorsque vous configurez le contrôle ReportViewer pour le traitement local, la totalité du traitement d'un rapport est réalisée sur l'ordinateur qui héberge l'application. Toutes les données utilisées par le rapport doivent être extraites des données fournies par l'application cliente.

Les sources de données utilisées dans les rapports doivent être définies à l'avance, pendant la conception du rapport. Au moment de l'exécution, l'application doit générer la table de données ou extraire les données utilisées dans le rapport. Les données des rapports traités localement peuvent provenir de tables de données et d'objets métier. Les étapes de la configuration d'une source de données pour un rapport traité localement varient selon que vous utilisez le contrôle de serveur Web ou le contrôle Windows Forms. Pour plus d'informations sur les sources de données prises en charge, consultez Création de sources de données pour un rapport.

Configuration de ReportViewer pour le traitement local

Pour configurer un contrôle ReportViewer pour le traitement local, vous sélectionnez ou créez un fichier de définition de rapport client (.rdlc) à utiliser avec ce contrôle :

  1. Ajoutez le contrôle ReportViewer depuis la section Données de la boîte à outils à la page Web ou de formulaire dans le projet.

  2. Dans le panneau de balises actives Tâches ReportViewer, cliquez sur Concevoir un nouveau rapport pour créer le fichier .rdlc à utiliser. Sinon, vous pouvez sélectionner Choisir un rapport pour utiliser un fichier .rdlc faisant déjà partie du projet. Vous ne pouvez choisir qu'un rapport. Si le rapport comprend des sous-rapports ou des liens d'extraction, des rapports supplémentaires apparaissent dans la liste de fichiers.

    Le fait de cliquer sur Concevoir un nouveau rapport ajoute un fichier .rdlc vide au projet, ouvre un rapport vierge en mode de création graphique et fournit des menus et des zones de conception permettant de créer un nouveau rapport. Pour créer un rapport, vous devez avoir déjà défini les datasets à utiliser. Pour plus d'informations sur la création de fichiers .rdlc, consultez Création de fichiers de définition de rapport client (.rdlc)

  3. Créez ou déployez l'application pour vérifier que le rapport y apparaît correctement.

Vous pouvez utiliser les procédures pas à pas pour savoir comment configurer et utiliser les contrôles ReportViewer en mode de traitement local. Toutes les procédures pas à pas comprennent des configurations de contrôle qui traitent les rapports localement. Pour plus d'informations, consultez Exemples et procédures pas à pas.

Vous pouvez modifier un rapport et les options de traitement afin que le rapport soit traité sur un serveur de rapports Microsoft SQL Server 2005 Reporting Services distant. Pour plus d'informations, consultez Conversion de fichiers RDL et RDLC.

Important

Contrairement à la version WinForms du contrôle ReportViewer, la version WebForm ne prend pas en charge la modification de la définition de rapport après son rendu. Pour modifier la définition de rapport, vous devez créer une nouvelle instance du contrôle ReportViewer.

Situations justifiant l'utilisation du traitement local

Le mode de traitement local est recommandé pour les applications qui comprennent des rapports et des datasets de taille petite ou moyenne. Étant donné que la totalité du traitement des données et du rapport est réalisée sur le client, le traitement de requêtes et de rapports complexes ou volumineux peut se traduire par une dégradation des performances. Le mode de traitement local est également recommandé si vous avez besoin d'une stratégie de déploiement simple dans laquelle toutes les parties de l'application sont exécutées ensemble sur le même ordinateur.

Le mode de traitement local est moins puissant que le traitement distant et s'adresse aux applications autonomes qui n'ont pas besoin d'un serveur de rapports. Les utilisateurs familiarisés avec les rapports de serveur exécutés sur un serveur de rapports SQL Server Reporting Services distant doivent prendre note des différences suivantes :

  • Les paramètres de rapport dans les définitions de rapport client (.rdlc) ne correspondent pas à des paramètres de requête. Dans une définition de rapport client, aucune zone d'entrée de paramètre n'accepte des valeurs utilisées ensuite dans une requête.

  • Les définitions de rapport client ne comprennent pas d'informations de requêtes incorporées. Vous devez définir les sources de données qui renvoient les données du rapport prêtes à l'emploi.

  • L'impression à partir du navigateur par le biais du contrôle ActiveX RSClientPrint n'est pas disponible pour les définitions de rapport client exécutées dans le contrôle de serveur Web ReportViewer. Le contrôle d'impression fait partie de l'ensemble des fonctionnalités du serveur de rapports.

Si ces différences vous posent problème, vous devez effectuer une migration vers une installation Reporting Services ou écrire du code d'application qui fournit les fonctionnalités requises.

Considérations particulières concernant l'utilisation de contrôles ReportViewer dans des applications Windows C++ non managées

Lorsque vous utilisez un contrôle ReportViewer pour traiter un rapport localement dans une application Windows C++ non managée, vous devez ajouter le rapport en tant que fichier de ressources managé incorporé. Pour définir ces propriété de l'éditeur de liens, dans le menu Projet, ouvrez <Projet> Propriétés, développez Propriétés de configuration, Éditeur de liens, puis cliquez sur Entrée. Dans la zone Incorporation du fichier de ressources managé, tapez le nom du fichier de rapport.

Voir aussi

Concepts

Ajout et configuration de contrôles ReportViewer
Configuration de ReportViewer pour un traitement distant