报表函数使用说明

字段表达式：
最基本类型的表达式是在文本框中显示字段值的表达式。
表达式必须包括 Fields 集合、字段名称和 Value 属性
如：=Fields!Product.Value

表达式既可以是引用字段对象的短表达式，也可以是支持基于字段或其他报表项的判定函数或格式设置的长

表达式。报表项和属性中的表达式必须以等号 (=) 开头。如果文本不以此字符开头，则将该文本作为字段的

实际值进行计算。

如： =Fields!FirstName.Value & " " & Fields!LastName.Value
 =Sum(Fields!LineTotal.Value)

条件格式设置：
可以使用表达式来控制报表项的外观。例如，可以为文本框的 Color 属性编写一个表达式，以便根据不同的

数据，以不同颜色显示数据。条件格式设置的示例如下。
以下表达式（用于文本框的 Color 属性中）在“Cost”字段的值大于“Revenue”字段的值时，以红色显示值。在“

Cost”字段的值小于或等于“Revenue”字段的值时，以黑色显示值

=IIf(Fields!Cost.Value > Fields!Revenue.Value, "Red", "Black")

类引用和自定义代码：
表中的表达式也可以包含对 Microsoft.VisualBasic、System.Convert 和 System.Math 命名空间中的类的引用。如

果您使用其他系统命名空间的类或函数，则必须使用完整命名空间（如 System.Collections.ArrayList）。

如果您需要使用 Reporting Services 函数或默认类未提供的其他功能，可以使用自定义代码、其他标准程序集

或报表代码块。为此，可以先生成一个自定义程序集，然后在表达式内引用该程序集

ReportViewer 报表的内置函数：
ReportViewer 提供了可用于报表表达式的内置函数。这些内置函数分为两类：聚合函数和杂项函数。聚合数

据的示例包括使用 Sum 函数来计算特定字段中所有值的总和。可以在任何报表项的表达式中使用聚合函数。

InScope 函数 (ReportViewer)  ：指明项的当前实例是否在指定范围内。
Level 函数 (ReportViewer) ：返回在递归层次结构中的当前深度级别。
Previous 函数 (ReportViewer) ：返回指定范围内的前一个实例。

标准聚合函数：
Avg ：返回指定表达式的所有非空值的平均值。
 
Count  ：返回指定表达式的值的计数。
 
CountDistinct ：返回指定表达式的所有不同值的计数。
 
CountRows ：返回指定范围内的行的计数。
 
First ：返回指定表达式的第一个值。
 
Last ：返回指定表达式的最后一个值。
 
Max ：返回指定表达式的所有非空值中的最大值。
 
Min ：返回指定表达式的所有非空值中的最小值。
 
StDev ：返回指定表达式的所有非空值的标准偏差。
 
StDevP ： 返回指定表达式的所有非空值的总体标准偏差。

Sum:
 返回指定表达式的值的总和。
 
Var
 返回指定表达式的所有非空值的方差。
 
VarP
 返回指定表达式的所有非空值的总体方差。
 

运行聚合函数：
RowNumber ：返回指定范围内的所有行的运行计数。
 
RunningValue ： 使用指定的函数返回指定表达式的运行聚合。
 

 
自定义聚合函数：
Aggregate  ：按照数据访问接口的定义返回指定表达式的自定义聚合。

Scope

每个聚合函数都使用 Scope 参数，该参数定义执行聚合函数的范围。有效的范围值是分组、数据集或数据区

域的名称。只有直接或间接包含表达式的分组或数据区域才能作为范围。如果表达式位于数据区域内，则对

于所有聚合函数，Scope 都是可选参数。如果省略 Scope 参数，则聚合的范围就是报表项所属的最里面的数

据区域或分组。如果将范围指定为 Nothing，则表示将范围设置为报表项所属的最外面的数据区域。

如果表达式位于数据区域外，Scope 参数将引用数据表或业务对象。如果报表包含多个数据集，则必须使用

Scope 参数。如果报表只包含一个数据集，并且省略了 Scope 参数，则范围将设置为该数据集。如果报表项

位于数据区域外，则不能为其指定 Nothing 关键字。

在页眉或页脚中不能使用 Scope 参数。

 

ReportViewer 报表的常用表达式：
报表中的许多表达式都包含函数。您可以编写使用 Microsoft.VisualBasic、System.Convert 和 System.Math 命名

空间中的函数的表达式，或将引用添加到其他程序集或自定义代码中。还可以使用 Microsoft .NET Framework

中的类。

 

 

函数
报表中的大部分函数为 Microsoft Visual Basic 函数或者内置报表函数。可以使用这些函数来设置数据格式、应

用逻辑和访问报表元数据。

Visual Basic 函数
可以使用 Visual Basic 函数来操作文本框中所显示的数据，或者操作参数、属性或报表其他区域中所用的数据

。本节举例说明了其中一些函数。有关 Visual Basic 函数的详细信息，请参阅 Visual Basic 文档。

日期函数
可以使用 Visual Basic 函数在报表中提供日期信息。

以下表达式包含 Today 函数，用于提供当前日期。此表达式可用在文本框中以在报表上显示日期，或用在参

数中以根据当前日期筛选数据：

=Today()

如果要根据单个参数来提供日期范围，则可使用 DateAdd 函数。以下表达式提供了 StartDate 参数中的日期之

后六个月的日期：

=DateAdd(DateInterval.Month, 6, Parameters!StartDate.Value)

以下表达式包含了 Year 函数，用于显示特定日期所属的年份。可以使用此表达式将日期组合在一起，或者

将年份作为一组日期的标签显示。此表达式为给定顺序的一组日期提供年份：

=Year(Fields!OrderDate.Value)

Month 函数和其他函数也可用于处理日期。有关详细信息，请参阅 Visual Basic 文档。

字符串函数：

可以使用 Visual Basic 函数操作报表中的字符串。
可以使用 Format 函数来设置字符串中的日期和数字的格式。

=Format(Parameters!StartDate.Value, "D") & " through " & 
Format(Parameters!EndDate.Value, "D")

如果文本框只包含日期或数字，则应当使用文本框的 Format 属性（而不是文本框中的 Format 函数）来应用

格式

 

Right、Len 和 InStr 函数用于返回子字符串，例如，修整 DOMAIN\username 以只返回用户名。 The following

expression returns a portion of a string to the right of a backslash (\) character from a parameter named User:

=Right(Parameters!User.Value, Len(Parameters!User.Value) -
InStr(Parameters!User.Value, "\"))

The following expression results in the same value as the previous one, using members of the .NET Framework String class

instead of Visual Basic functions:

=Parameters!User.Value.Substring(Parameters!User.Value.IndexOf("\")+1,
Parameters!User.Value.Length-Parameters!User.Value.IndexOf("\")-1)

 

决策函数
可以使用 Visual Basic 函数来计算输入值并根据结果返回另一个值。

Iif 函数根据表达式的计算结果是否为 True 返回两个值中的一个。以下表达式使用了 Iif 函数，如果 LineTotal

的值超过 100，则返回布尔值 True，否则返回 False：
=Iif(Fields!LineTotal.Value > 100, True, False)

以下表达式使用了多个 Iif 函数（也称为“嵌套 Iif 函数”），根据 PctComplete 的值返回三个值中的一个
=Iif(Fields!PctComplete.Value >= .8, "Green",
Iif(Fields!PctComplete.Value >= .5, "Amber", "Red"))

以下表达式也是根据 PctComplete 的值返回三个值中的一个，不过使用的是 Switch 函数，该函数返回的是多

个表达式中计算结果为 True 的第一个表达式的值：
=Switch(Fields!PctComplete.Value >= .8, "Green",
Fields!PctComplete.Value >= .5, "Amber", Fields!PctComplete.Value <
.5, "Red")

报表函数：
Sum 函数可计算某一分组或数据区域中多个值的和。此函数可用于表格组的页眉或页脚中。以下表达式显示

了订单分组或数据区域中数据的和：

=Sum(Fields!LineTotal.Value, "Order")

如果将包含 RowNumber 函数的表达式用于数据区域中的文本框中，则该表达式将显示表达式所在文本框的

每个实例的行号。此函数可用于给表格中的各行加编号。还可以将其用于更复杂的情况，例如，根据行号提

供分页符。有关详细信息，请参阅本主题中后面的“分页符”。

以下表达式显示了从最外面数据区域的第一行到最后一行的行号。Nothing 关键字表示函数将从最外面数据区

域的第一行开始计数。若要从子数据区域开始计数，可使用数据区域的名称。
=RowNumber(Nothing)

报表数据的外观：

可以使用表达式来控制数据在报表上的显示形式。例如，可以在一个文本框中显示两个字段的值、显示报表

的有关信息或影响报表中分页符的插入方式。

页眉和页脚
在设计报表时，可能需要在报表的页脚显示报表名称和页码。为此，可使用以下表达式：

以下表达式提供了报表的名称以及它的运行时间。可以将该表达式放入报表页脚或表体的文本框中。 The

time is formatted with the .NET Framework formatting string for short date:

=Globals.ReportName & ", dated " &
Format(Globals.ExecutionTime, "d")

以下表达式位于报表页脚的文本框中，提供了报表的页码和全部页。
=Globals.PageNumber & " of " & Globals.TotalPages

也可以在报表页眉或页脚中引用表体中的报表项。以下示例说明了如何在页眉中显示页面中的第一个值和最

后一个值，类似于目录列表的形式。该示例假定存在一个包含名为 LastName 的文本框的数据区域。

以下表达式位于页眉左侧的文本框中，提供了页面上 LastName 文本框的第一个值：

=First(ReportItems!LastName.Value)

The following expression, placed in a textbox on the right side of the page header, provides the last value of the LastName

text box on the page:
=Last(ReportItems!LastName.Value)

可以对页眉或页脚中所引用的报表项应用聚合函数。（不过，不能对表体中所引用的报表项应用聚合函数。

）以下示例说明了如何显示页总页数。该示例假定存在一个包含名为 Cost 的文本框的数据区域。
以下表达式位于页眉或页脚中，提供了页面上的 Cost 文本框中的值的和：

=Sum(ReportItems!Cost.Value)
注意：页眉或页脚中的每个表达式只能引用一个报表项。

分页符：

在某些报表中，可能需要在指定行数之后、组或报表项上放置分页符。为此，在数据区域中创建组（通常是

紧挨着详细信息区域的组），在组中添加分页符，然后根据指定行数在组中添加组表达式。

如果将以下表达式放置在组表达式中，则它将给每 25 行指定一个编号。如果为组定义了分页符，将导致每

隔 25 行插入一个分页符。
=Int((RowNumber(Nothing)-1)/25)

属性：

表达式不仅用于显示文本框中的数据。还可以用于更改将属性应用于报表项的方式。可以更改报表项的样式

信息，或更改其可见性。

格式
可以使用表达式改变报表中报表项的外观。
如果在文本框的 Color 属性中使用以下表达式，则它可根据 Profit 字段的值更改文本的颜色：

=Iif(Fields!Profit.Value < 0, "Red", "Black")

如果在数据区域中的报表项的 BackgroundColor 属性中使用以下表达式，则它可更改淡绿色与白色之间的每

一行的背景颜色：

=Iif(RowNumber(Nothing) Mod 2, "PaleGreen", "White")

可见性
可以使用报表项的可见性属性来显示和隐藏报表中的项。在诸如表的数据区域中，最初可以根据表达式中的

值隐藏详细信息行。

The following expression, when used for initial visibility of detail rows in a group, shows the detail rows for all sales exceeding

90 percent in the PctQuota field:

=Iif(Fields!PctQuota.Value>.9, False, True)

报表参数：
可以在参数中使用表达式来更改参数的默认值。例如，可以使用参数，以根据用于运行报表的用户 ID 筛选

特定用户的数据。

如果将以下表达式用作参数的默认值，则它可收集运行报表的用户的用户 ID：
=User!UserID

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

转载于:https://www.cnblogs.com/jobin/articles/1152416.html