Partager via

Tutoriel : Lecture et définition des paramètres avec un sous-rapport

  • Article
NoteRemarque 

Pour suivre ce tutoriel, vous devez terminer le tutoriel précédent Tutoriel : Lecture et définition des paramètres discrets.

Introduction

Dans le tutoriel précédent, Tutoriel : Lecture et définition des paramètres discrets, vous avez appris à créer un rapport avec un paramètre et à créer un code permettant de définir ce paramètre au moment de l'exécution, en utilisant chaque fois des valeurs de paramètres codées en dur et des valeurs de paramètres transmises à partir d'un contrôle ListBox.

Dans ce tutoriel, vous allez apprendre à ajouter des paramètres à un sous-rapport.

Vous devez apporter quatre modifications au projet que vous avez créé lors de la procédure Tutoriel : Lecture et définition des paramètres discrets :

  • Vous ajoutez un sous-rapport au rapport d'origine.

    Ce sous-rapport désigne la table Commandes de la base de données Xtreme. La table Commandes est liée à la table Clients utilisée dans le tutoriel précédent par la clé externe ID client.

  • Vous ajoutez un paramètre de plage au sous-rapport qui effectue un filtrage selon une plage de dates de commande.

  • Vous ajoutez deux contrôles Text au formulaire : orderStartDate et orderEndDate afin de définir la plage des dates de commande au moment de l'exécution.

  • Vous ajoutez une nouvelle méthode.

    Cette méthode crée une instance ParameterRangeValue contenant les valeurs startDate et endDate, puis transmet cette instance ParameterRangeValue au paramètre de plage dans le sous-rapport.

Une fois le tutoriel terminé, vous pouvez filtrer les valeurs affichées dans le rapport au moment de l'exécution. Le code que vous ajoutez limite le nombre de villes affichées dans le rapport principal ainsi que la plage de dates de commande qui apparaîtront dans le sous-rapport.

Ce tutoriel peut également être effectué avec des classes du modèle d'objet CrystalReportViewer, bien qu'il soit recommandé d'utiliser le modèle d'objet ReportDocument. Pour en savoir plus sur l'utilisation des modèles d'objet, voir Quel modèle d'objet utiliser ?.

Pour créer ce tutoriel à l'aide du modèle d'objet CrystalReportViewer, voir Tutoriel : Lecture et définition des paramètres de plage d'un sous-rapport à l'aide du modèle d'objet CrystalReportViewer.

Exemple de code

Ce tutoriel fournit des exemples de code Visual Basic et C# qui illustrent la version terminée du projet. Suivez les instructions de ce tutoriel pour créer un projet ou ouvrez le projet d'exemple de code pour travailler à partir d'une version terminée.

Les exemples de code sont stockés dans des dossiers classés par langue et par type de projet. Les noms des dossiers de chaque version d'exemple de code sont les suivants :

  • Site Web C# : CS_Web_RDObjMod_ParametersSubrpt
  • Projet Windows C# : CS_Win_RDObjMod_ParametersSubrpt
  • Site Web Visual Basic : VB_Web_RDObjMod_ParametersSubrpt
  • Projet Windows Visual Basic : VB_Win_RDObjMod_ParametersSubrpt

Pour trouver les dossiers contenant ces exemples, voir Répertoire des exemples de code des tutoriels.

Dans cette section :

Voir aussi