Tutoriel : Lecture et définition des paramètres de plage d'un sous-rapport
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 discret 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 ou TextBox.
Dans ce tutoriel, vous allez apprendre à ajouter des paramètres de plage à un sous-rapport.
Vous devez apporter quatre modifications au projet que vous avez précédemment créé :
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 modifiez la méthode SetCurrentValuesForParameter() que vous avez créée lors du tutoriel précédent.
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 ReportDocument ; voir Tutoriel : Lecture et définition des paramètres avec un sous-rapport utilisant 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 ?.
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_CRVObjMod_ParametersSubrpt
- Projet Windows C# : CS_Win_CRVObjMod_ParametersSubrpt
- Site Web Visual Basic : VB_Web_CRVObjMod_ParametersSubrpt
- Projet Windows Visual Basic : VB_Win_CRVObjMod_ParametersSubrpt
Pour trouver les dossiers contenant ces exemples, voir Répertoire des exemples de code des tutoriels.