报表生成器FastReport .Net用户指南：报告参数

FastReport .Net是一款全功能的Windows Forms、ASP.NET和MVC报表分析解决方案，使用FastReport .NET可以创建独立于应用程序的.NET报表，同时FastReport .Net支持中文、英语等14种语言，可以让你的产品保证真正的国际性。

FastReport.NET官方版下载（qun：585577353）https://www.evget.com/product/1861/download

您可以在报告中定义参数。参数是一个变量，其值既可以在报告本身中定义，也可以在报告之外定义（调用报告的程序可以将参数值传送到报告中）。详见 "程序员手册"）。参数可以在表达式中使用，也可以在报表对象（如 "Text "对象）中显示。

使用参数的最常用方法:

• 根据参数设置的条件进行数据过滤；
• 在报表中打印参数值。

参数具有以下属性：

Property	Description
Name	参数名称可以 使用除点". "以外的任何符号。
DataType	参数数据类型。
Expression	返回参数值的表达式。有关表达式的更多详情，请参阅 "表达式 "一章。调用参数时将处理该表达式。
Value	参数值。该属性在设计器中不可用，可通过编程填写。

您必须设置 "Name "和 "DataType "属性。"Expression "属性可以留空。在这种情况下，应通过编程传递参数值。

创建参数

要创建参数，请在 "Data"窗口中选择 "Parameters "元素，右击该元素并在右键菜单中选择 "New parameter "项：

按 F2 给参数命名，然后进入 "Properties "窗口，设置参数的 "DataType "属性。

参数可以嵌套。要创建嵌套参数，请选择父参数，右键单击该参数，然后在右键菜单中选择 "New parameter "项：

您可以同时引用父参数和嵌套参数。嵌套级别不受限制。

在报告中使用参数

您可以使用方括号从表达式中引用参数：

[Parametername]

您需要使用此方法引用嵌套参数：

[Parentparameter.Childparameter]

由于参数有明确的类型（在DataType属性中给出），因此可以使用参数执行数据类型允许执行的操作。因此，字符串类型的参数可以按以下方式在表达式中使用：

[StringParameter].Substring(0,2）

让我们来看一个使用参数的例子。假设我们有一份打印"Employees"表的报表。我们想修改该报告，以打印带有指定编号的雇员信息。为此，我们需要过滤"EmployeeID"数据列上的数据。创建一个名称为"EmployeeID"的参数。指明参数的类型--Int32，因为"EmployeeID"数据列正是这种类型。要使用指定的ID过滤雇员，我们需要进入"Data"带编辑器，并在"Filter"选项卡中输入以下表达式：

[Employees.EmployeeID]==[EmployeeID]

要将参数值从程序传递到报告，请使用以下代码：

report1.SetParameterValue("EmployeeID",2);