DotNet · 2022年5月6日

RDLC报表-ReportViewer 报表的常用表达式

ReportViewer 报表的常用表达式

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

报表中的许多表达式都包含函数。您可以编写使用 Microsoft.VisualBasic、System.Convert 和 System.Math
命名空间中的函数的表达式,或将引用添加到其他程序集或自定义代码中。还可以使用 Microsoft .NET Framework 中的类。有关详细信息,请参阅
.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 函数来设置字符串中的日期和数字的格式。 The following expression displays values of
    the StartDate and EndDate parameters in long date 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")

报表函数

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

  • 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

自定义代码

可以在报表中使用自定义代码。自定义代码既可以嵌入报表中,也可以存储在报表所使用的自定义程序集中。有关自定义代码的详细信息,请参阅
ReportViewer 报表中添加自定义代码

  • 以下示例调用了 ToUSD 嵌入代码方法,该方法将 StandardCost 字段值转换为美元值:

    =Code.ToUSD(Fields!StandardCost.Value)

另请参见

最新电影,电视剧,尽在午夜剧场

电影电视剧午夜不寂寞