教程：读取和设置离散参数
简介
离散参数是一个单独的值，它与范围参数相对，后者指某一范围的值。文本项（如城市）通常要通过离散参数来访问。数值项（如员工薪水）则通常通过范围参数来访问。
在本教程中，将为一个离散参数设置值，以查看基于一个字段的客户报表。报表将只显示居住在从城市列表中选定的城市中的客户。城市列表是根据“城市”参数的默认值生成的。城市参数的这些默认值封装在报表中。
首先，创建一个具有城市参数的客户报表。该报表的数据来自 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
欲知包含这些示例的文件夹的位置，请参见“教程的示例代码目录”。