教程:读取和设置离散参数
简介
离散参数是一个单独的值,它与范围参数相对,后者指某一范围的值。文本项(如城市)通常要通过离散参数来访问。数值项(如员工薪水)则通常通过范围参数来访问。
在本教程中,将为一个离散参数设置值,以查看基于一个字段的客户报表。报表将只显示居住在从城市列表中选定的城市中的客户。城市列表是根据“城市”参数的默认值生成的。城市参数的这些默认值封装在报表中。
首先,创建一个具有城市参数的客户报表。该报表的数据来自 Crystal Reports for Visual Studio 附带的示例数据库。在代码中实例化该报表时,需要创建一个包含城市名称(Paris、Tokyo)的 ArrayList,并将该 ArrayList 实例传递给一个帮助器方法,通过该方法将这些城市名称设置为城市参数的当前值。随后,将报表绑定到 CrystalReportViewer 控件,并让报表仅显示居住在 Paris 和 Tokyo 的客户。
在教程的下一部分,将执行以下操作:
- 创建一个方法,该方法获取所有默认值并在 ArrayList 中返回它们。
- 向窗体添加一个 ListBox 控件,并用 ArrayList 的值填充该窗体。
- 添加一个 Button 控件,根据 ListBox 选定项重新显示报表。
在教程的最后一部分,将编写按钮单击事件的代码,从 ListBox 控件中获取所有选定项,并将它们设置为城市参数的当前值。报表将重新显示,且仅显示居住在 ListBox 控件中的选定城市中的客户。
也可使用 CrystalReportViewer 对象模型的类完成本教程,但推荐使用 ReportDocument 对象模型。有关选用对象模型的详细信息,请参见“应该使用哪种对象模型?”。
若要使用 CrystalReportViewer 对象模型构建本教程,请参见“教程:登录安全的 SQL Server 数据库”。
示例代码
此教程附带 Visual Basic 和 C# 示例代码,这些代码显示了项目完成后的版本。请按照本教程中的说明创建新项目或打开示例代码项目,以利用完成后的版本进行工作。
示例代码保存在按语言和项目类型分类的文件夹中。各示例代码版本的文件夹名称如下:
- C# 网站:CS_Web_RDObjMod_Parameters
- C# Windows 项目:CS_Win_RDObjMod_Parameters
- Visual Basic 网站:VB_Web_RDObjMod_Parameters
- Visual Basic Windows 项目:VB_Win_RDObjMod_Parameters
欲知包含这些示例的文件夹的位置,请参见“教程的示例代码目录”。