Création de fichiers de définition de rapport client (.rdlc)
Le contrôle ReportViewer prend en charge un mode de traitement local vous permettant d'exécuter les fichiers de définition de rapport client (.rdlc) en utilisant la fonction de traitement intégré du contrôle. Les rapports clients que vous exécutez en mode de traitement local peuvent être facilement créés dans votre projet d'application. Il existe quatre approches pour créer le rapport :
Vous pouvez créer un nouveau fichier de définition de rapport client (.rdlc) à l'aide de l'Assistant Rapport.
Vous pouvez créer un nouveau fichier de définition de rapport client (.rdlc) dans Visual Studio.
Vous pouvez convertir un fichier de définition de rapport existante (.rdl) au format de fichier de définition de rapport client (.rdlc), qui est utilisé dans le mode de traitement local.
Vous pouvez générer une définition de rapport via un programme.
Pour utiliser une définition de rapport existante, ajoutez un élément de rapport au projet d'application. Lorsque vous sélectionnez Ajouter un nouvel élément dans le menu Projet, vous pouvez choisir un modèle de rapport pour élaborer une mise en page de rapport à partir d'un rapport vide. Pour créer un nouveau rapport, cliquez sur Concevoir un nouveau rapport lors de la configuration du contrôle ReportViewer. Cette intervention ouvre un rapport vide.
Comment créer et prévisualiser un rapport local
Dans Microsoft Visual Studio 2008, ouvrez le projet d'application ou le site Web.
Créez les sources de données que vous souhaitez utiliser. Vous pouvez utiliser les tables de données ou les objets d'entreprise définis dans des datasets disponibles dans le projet. Pour plus d'informations, consultez Création de sources de données pour un rapport.
Créez un fichier de définition de rapport (.rdlc) à utiliser dans votre projet.
Définissez une disposition de rapport en ajoutant dans le rapport vide des tableaux, des zones de texte, des matrices, des listes ou des graphiques à partir de la boîte à outils. Ces éléments de données sont qualifiés de régions de données. Les régions de données sont liées aux sources de données. Spécifiquement, vous pouvez mapper chaque cellule d'une région de données à un champ de votre source de données. Pour plus d'informations, consultez Ajout de régions de données à un rapport (Concepteur de rapports Visual Studio).
Terminez le rapport en ajoutant un style, une mise en forme, des images, des bordures, des en-têtes, des pieds de page, un tri et d'autres fonctionnalités de rapport. Pour plus d'informations, consultez Définition d'une mise en page de rapport (Concepteur de rapports Visual Studio).
Sélectionnez le formulaire ou la page qui contiendra le contrôle.
En mode de conception graphique, ajoutez un contrôle ReportViewer à la page Web ou au formulaire. Le contrôle ReportViewer se trouve dans la section Données de la boîte à outils. Pour plus d'informations, consultez Ajout et configuration de contrôles ReportViewer.
Dimensionnez et positionnez le contrôle sur la page ou le formulaire.
Dans le panneau de balises actives des tâches ReportViewer, sélectionnez le fichier de définition de rapport client (.rdlc) que vous avez créé pour lier le rapport au contrôle. Pour plus d'informations sur l'ouverture du panneau des balises actives, consultez Utilisation du panneau des balises actives des tâches ReportViewer.
Pour prévisualiser le rapport, vous pouvez construire ou déployer l'application. Vous ne pouvez obtenir un aperçu du rapport qu'en l'exécutant dans un contrôle ReportViewer. Il n'y a pas de mode d'aperçu distinct pour le fichier .rdlc. Notez que vous pouvez ouvrir et modifier la définition de rapport à tout moment, puis construire ou déployer l'application pour vérifier les résultats.
Ajout d'un nouvel élément de rapport à un projet
Lorsque vous ajoutez un nouvel élément de rapport à un projet, un rapport vide est créé et un fichier Report.rdlc est ajouté au projet. La définition de rapport s'ouvre en mode de conception graphique. L'espace de noms de l'objet du rapport est ajouté au projet et les contrôles de rapport disponibles sont ajoutés à la boîte à outils.
Ajout d'éléments de rapport à un rapport
Vous pouvez facilement créer des rapports simples en faisant glisser des éléments de rapport (par exemple, des zones de texte, des tableaux, des graphiques et des images) sur une surface de dessin d'un rapport et en définissant des propriétés sur ces éléments.
Un rapport plus complexe pourrait inclure des paramètres et des expressions que vous utilisez pour personnaliser la sortie du rapport. Par exemple, pour obtenir un rapport d'analyse d'une action particulière, vous devez ajouter un paramètre au rapport pour spécifier le symbole de l'action. Vous pouvez fournir une interface utilisateur dans votre application qui collecte une valeur de paramètre auprès de l'utilisateur. Des paramètres peuvent être passés à la requête pour spécifier avec une plus grande précision des critères de sélection de données, ou peuvent être utilisés pour filtrer un jeu de résultats afin que seule une partie du jeu de résultats ne s'affiche dans le rapport. Les valeurs des paramètres peuvent être prédéfinies et passées par votre application ou spécifiées par l'utilisateur avant d'exécuter le rapport.
Des expressions, toujours écrites en Microsoft Visual Basic, sont utilisées pour agréger les données et effectuer une mise en forme conditionnelle. Les rapports peuvent également inclure du code personnalisé. Vous pouvez incorporer du code personnalisé dans votre rapport, ou appeler des méthodes sur un assembly personnalisé faisant partie de votre application. Contrairement aux expressions, le code personnalisé peut être écrit dans d'autres langages, et non seulement en Visual Basic.
Voir aussi
Concepts
Utilisation du panneau des balises actives des tâches ReportViewer
Création de sources de données pour un rapport
Définition d'une mise en page de rapport (Concepteur de rapports Visual Studio)
Vue d'ensemble des rapports (Visual Studio)
Déploiement de rapports et de contrôles ReportViewer
Ajout et configuration de contrôles ReportViewer
Création de définitions de rapport client à l'aide de l'Assistant Rapport Visual Studio