Mise à jour et reliaison des références de source de données (Concepteur de rapports Visual Studio)
Le contrôle ReportViewer et le fichier de définition de rapport client (.rdlc) incluent des références sur les sources de données qui fournissent des données au rapport. Si vous convertissez des définitions de rapport, ajoutez ou supprimez un dataset, ou modifiez un dataset utilisé dans un rapport, vous devez mettre à jour toutes les références et liaisons de sources de données avant de déployer ou d'exécuter l'application.
Présentation des références de sources de données utilisées par les contrôles et rapports ReportViewer
Les informations de sources de données sont utilisées par les contrôles et les rapports de diverses manières. D'abord, la définition de rapport utilise des informations de schéma incorporées pour établir l'association entre des éléments dans la mise en page du rapport et les données éventuellement fusionnées dans la mise en page. Ensuite, le contrôle ReportViewer nécessite des liaisons de sources de données afin que vous puissiez lui passer des données au moment de l'exécution.
Au moment de l'exécution, toutes les liaisons et informations de sources de données doivent être synchronisées afin que le rapport contienne les données attendues. Diverses options sont prévues pour vous aider à maintenir les informations de sources de données synchronisées sur l'ensemble du cycle de développement lors de la modification des rapports et des datasets utilisés dans votre application. La liste suivante énumère les différentes options disponibles :
Utilisez la tâche Choisir des sources de données dans le panneau des balises actives des tâches ReportViewer pour lier une source de données à un fichier de définition de rapport (.rdlc) que vous avez converti à partir d'un fichier de définition de rapport de serveur (.rdl).
Utilisez la tâche Relier les sources de données dans le panneau des balises actives des tâches ReportViewer pour synchroniser le contrôle et la définition de rapport avec les datasets modifiés.
Utilisez la boîte de dialogue Sources de données du rapport dans le menu Rapport pour mettre à jour les informations de schéma stockées dans le fichier de définition de rapport. Le menu Rapport est disponible lorsque vous modifiez un fichier de définition de rapport client (.rdlc) en mode de conception graphique.
Mise à jour de références de sources de données dans une définition de rapport
La définition de rapport inclut des éléments de dataset qui définissent la structure de source de données utilisée par le rapport. Les éléments de dataset sont ajoutés à la définition de rapport pendant la conception du rapport. Un nouvel élément est ajouté chaque fois que vous faites glisser un champ spécifique sur une région de données ou une zone de texte dans le rapport.
La mise à jour de la définition de rapport est nécessaire si vous copiez des fichiers de définition de rapport entre des projets ayant des sources de données différentes ou si vous avez modifié les datasets utilisés dans votre projet. Si vous modifiez par la suite le dataset proprement dit dans le projet en supprimant ou en renommant des champs ou des tables, la définition de rapport ne contient plus de références valides. Pour mettre à jour la définition de rapport, utilisez la boîte de dialogue Sources de données de la manière décrite dans les étapes suivantes.
Comment mettre à jour des références dans une définition de rapport
Ouvrez le fichier de définition de rapport client (.rdlc) en mode de conception graphique.
Dans le menu Rapport, sélectionnez Sources de données. La boîte de dialogue Sources de données du rapport s'affiche. Vous pouvez utiliser les options suivantes :
Pour ajouter un nouveau dataset à la définition de rapport, sélectionnez une source de données de projet et cliquez sur Ajouter au rapport. Dans la plupart des cas, cette option n'est pas nécessaire. Les sources de données de projet sont ajoutées à la définition de rapport automatiquement lorsque vous faites glisser des champs dans la mise en page du rapport.
Pour supprimer une référence de dataset existante de la définition de rapport, sélectionnez le dataset et cliquez sur Supprimer.
Si vous avez renommé un dataset dans votre projet, vous pouvez utiliser la boîte de dialogue Sources de données du rapport pour mettre à jour le nom du dataset dans la définition de rapport. Cliquez sur le bouton Renommer pour définir le nom du dataset en mode refrappe, puis tapez le nouveau nom.
Cliquez sur Actualiser tout pour mettre à jour le fichier de définition de rapport avec vos modifications.
Reliaison de sources de données au contrôle ReportViewer
Le contrôle ReportViewer nécessite des liaisons de données aux sources de données d'application au moment de l'exécution. Des liaisons de données sont créées pour le contrôle lorsque vous sélectionnez un fichier de définition de rapport client (.rdlc).
La reliaison d'une source de données est nécessaire si vous modifiez une définition de rapport qui a déjà été liée à un contrôle, si vous modifiez le dataset après que le contrôle a été lié à un formulaire ou une page Web, ou si vous avez ajouté un nouveau dataset au rapport. Tous ces scénarios produisent des liaisons périmées. Utilisez la tâche Relier les sources de données sur le panneau des balises actives des tâches ReportViewer pour mettre à jour les liaisons de données dans le code d'application.
.gif) Remarque |
|---|
Certaines modifications à une définition de rapport nécessitent une reliaison à une source de données. La réorganisation d'éléments, la mise en forme d'éléments ou la réutilisation du même champ lié aux données dans plusieurs régions de données constituent autant d'exemples de modifications ne remettant pas en cause la validité de liaisons de données existantes. De même, si vous modifiez une partie de la source de données qui n'est pas utilisée dans le rapport, vous n'avez pas besoin de mettre à jour les liaisons. |
Comment relier des sources de données
Ouvrez le formulaire ou la page Web contenant le contrôle ReportViewer.
Dans le panneau des balises actives des tâches ReportViewer, cliquez sur Relier les sources de données. Vous pouvez inspecter le code derrière le formulaire ou la page pour confirmer les modifications.
Choix de sources de données pour le contrôle ReportViewer
Lorsque vous convertissez un fichier de définition de rapport serveur (.rdl) en un fichier de définition de rapport client (.rdlc), vous devez vous assurer que l'application inclut le code de liaison de données du contrôle ReportViewer. Le code de liaison de données est généré automatiquement lors de la création d'un fichier .rdlc à partir d'un modèle de rapport. Cependant, le code de liaison de données sera absent si vous créez le fichier .rdlc d'une autre manière. Pour ajouter le code des liaison de données, utilisez la tâche Choisir des sources de données dans le panneau des balises actives des tâches ReportViewer. Pour en savoir plus sur la conversion de définitions de rapport, consultez Conversion de fichiers RDL et RDLC.
Comment ajouter des liaisons de sources de données
Ouvrez le formulaire ou la page Web contenant le contrôle ReportViewer.
Dans le panneau des balises actives des tâches ReportViewer, cliquez sur Choisir des sources de données. Vous pouvez inspecter le code derrière le formulaire ou la page pour confirmer les modifications.
Voir aussi
Concepts
Création de fichiers de définition de rapport client (.rdlc)
Création de sources de données pour un rapport
Utilisation du panneau des balises actives des tâches ReportViewer
Configuration de ReportViewer pour le traitement local