教程:读取和设置子报表的范围参数
简介
在前一教程“教程:读取和设置离散参数”中,您已学习了如何创建带离散参数的报表,以及如何编写代码以在运行时设置该参数(使用硬编码的参数值,以及从 ListBox 或 TextBox 控件传递的参数值。)
在本教程中,将学习如何把范围参数添加到子报表。
需要对以前创建的项目进行四处修改:
将一个子报表添加到原始报表中。
该子报表处理 Xtreme 数据库的“订单”表。“订单”表通过“客户 ID”外键与前一教程中使用的“客户”表相关。
向子报表添加一个范围参数,它按订单日期范围进行过滤。
向窗体添加两个 Text 控件 orderStartDate 和 orderEndDate,以在运行时设置订单日期范围。
修改在前一教程中创建的 SetCurrentValuesForParameter() 方法。
此方法创建一个包含 startDate 和 endDate 值的 ParameterRangeValue 实例,然后把该 ParameterRangeValue 实例传递到子报表中的范围参数。
完成本教程后,可过滤运行时在报表上显示的值。所添加的代码可限制在主报表中显示的城市数,以及限制要在子报表中显示的订单日期范围。
也可以使用 ReportDocument 对象模型的类完成本教程,请参见“教程:读取和设置子报表的参数”。有关对象模型用法的详细信息,请参见“应该使用哪种对象模型?”。
示例代码
此教程附带 Visual Basic 和 C# 示例代码,这些代码显示了项目完成后的版本。请按照本教程中的说明创建新项目或打开示例代码项目,以利用完成后的版本进行工作。
示例代码保存在按语言和项目类型分类的文件夹中。各示例代码版本的文件夹名称如下:
- C# 网站:CS_Web_CRVObjMod_ParametersSubrpt
- C# Windows 项目:CS_Win_CRVObjMod_ParametersSubrpt
- Visual Basic 网站:VB_Web_CRVObjMod_ParametersSubrpt
- Visual Basic Windows 项目:VB_Win_CRVObjMod_ParametersSubrpt
欲知包含这些示例的文件夹的位置,请参见“教程的示例代码目录”。