报表的通用表达式（Visual Studio 报表设计器）

项目
08/22/2008

有些表达式在报表中很常用。其中包括更改报表中的数据外观的表达式、计算总数的表达式和更改报表项属性的表达式。本主题介绍了报表中可用于常见任务的一些表达式。

报表中的许多表达式都包含函数。您可以编写使用 Microsoft.VisualBasic、System.Convert 和 System.Math 命名空间中的函数的表达式，或将引用添加到其他程序集或自定义代码中。还可以使用 Microsoft .NET Framework SDK 中的类。有关详细信息，请参阅 .NET Framework SDK 类库文档。

函数

报表中的大部分函数为 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 函数来设置字符串中的日期和数字的格式。以下表达式以长日期格式显示 StartDate 和 EndDate 参数的值：
```
=Format(Parameters!StartDate.Value, "D") & " through " &  
Format(Parameters!EndDate.Value, "D") 
```
如果文本框只包含日期或数字，则应当使用文本框的 Format 属性（而不是文本框中的 Format 函数）来应用格式。
Right、Len 和 InStr 函数用于返回子字符串，例如，修整 DOMAIN\username 以只返回用户名。以下表达式从名为 User 的参数中返回右边到反斜线 (\) 字符为止的部分字符串：
```
=Right(Parameters!User.Value, Len(Parameters!User.Value) - 
InStr(Parameters!User.Value, "\"))
```
以下表达式的结果与上一个表达式的结果相同，但用 .NET Framework String 类的成员代替了 Visual Basic 函数：
```
=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")
```

报表函数

Reporting Services 提供了可用于操作报表中的数据的其他报表函数。本节举例说明了其中两个函数。有关报表函数和示例的详细信息，请参阅用于报表的内置函数（Visual Studio 报表设计器）。

Sum 函数可计算某一分组或数据区域中多个值的和。此函数可用于表格组的页眉或页脚中。以下表达式显示了订单分组或数据区域中数据的和：
```
=Sum(Fields!LineTotal.Value, "Order")
```
如果将包含 RowNumber 函数的表达式用于数据区域中的文本框中，则该表达式将显示表达式所在文本框的每个实例的行号。此函数可用于给表格中的各行加编号。还可以将其用于更复杂的情况，例如，根据行号提供分页符。有关详细信息，请参阅本主题中后面的“分页符”。

以下表达式显示了从最外面数据区域的第一行到最后一行的行号。Nothing 关键字表示函数将从最外面数据区域的第一行开始计数。若要从子数据区域开始计数，可使用数据区域的名称。
```
=RowNumber(Nothing)
```

报表数据的外观

可以使用表达式来控制数据在报表上的显示形式。例如，可以在一个文本框中显示两个字段的值、显示报表的有关信息或影响报表中分页符的插入方式。

页眉和页脚

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

以下表达式提供了报表的名称以及它的运行时间。可以将该表达式放入报表页脚或表体的文本框中。时间格式用 .NET Framework 格式字符串设置为短日期：
```
=Globals.ReportName & ", dated " & 
Format(Globals.ExecutionTime, "d")
```
以下表达式位于报表页脚的文本框中，提供了报表的页码和全部页。
```
=Globals.PageNumber & " of " & Globals.TotalPages
```

也可以在报表页眉或页脚中引用表体中的报表项。以下示例说明了如何在页眉中显示页面中的第一个值和最后一个值，类似于目录列表的形式。该示例假定存在一个包含名为 LastName 的文本框的数据区域。

以下表达式位于页眉左侧的文本框中，提供了页面上 LastName 文本框的第一个值：
```
=First(ReportItems!LastName.Value)
```
以下表达式位于页眉右侧的文本框中，它提供了页面上 LastName 文本框的最后一个值：
```
=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")
```

可见性

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

如果对某个组中的详细信息行的初始可见性使用以下表达式，则它会显示 PctQuota 字段中的总销售额超过 90% 的详细信息行：
```
=Iif(Fields!PctQuota.Value>.9, False, True)
```

报表参数

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

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

自定义代码

可以在报表中使用自定义代码。自定义代码既可以嵌入报表中，也可以存储在报表所使用的自定义程序集中。有关自定义代码的更多信息，请参见向报表中添加自定义代码（Visual Studio 报表设计器）。

以下示例调用了 ToUSD 嵌入代码方法，该方法将 StandardCost 字段值转换为美元值：
```
=Code.ToUSD(Fields!StandardCost.Value)
```

另请参见

概念

在报表中使用表达式（Visual Studio 报表设计器）
定义报表中的报表参数（Visual Studio 报表设计器）
向报表中添加页眉和页脚（Visual Studio 报表设计器）
向报表中添加样式和格式（Visual Studio 报表设计器）
向报表中添加交互性、可见性和导航（Visual Studio 报表设计器）

通过