通过

报表设计器的表达式中的自定义代码和程序集引用 (SSRS)

  • 项目

您可以添加对报表中嵌入的自定义代码的引用，或添加对生成并保存到您的计算机并且部署到报表服务器的自定义程序集的引用。 对于自定义常量、复杂的函数，或在一个报表中多次使用的函数，可使用嵌入代码。 可以使用自定义代码程序集在一个位置中维护代码，并共享该代码以便由多个报表使用。 自定义代码可包含新的自定义常量、变量、函数或子例程。 可以包含对内置集合（例如，Parameters 集合）的只读引用。 但是，无法将报表数据值集传递给自定义函数；特别要指出的是，不支持自定义聚合。

安全说明安全说明

对于在运行时计算一次以及希望在整个报表处理期间都保留相同值的时效性计算，请考虑使用报表变量或组变量。 有关详细信息，请参阅报表和组变量集合引用（报表生成器和 SSRS）。

报表设计器是用于向报表中添加自定义代码的首选创作环境。 报表生成器支持处理具有有效表达式的报表，或者支持处理包括对报表服务器上自定义程序集的引用的报表。 报表生成器不提供添加对自定义程序集的引用的方法。

注意注意

请注意，在报表服务器的升级过程中，依赖自定义程序集的报表可能需要额外的步骤才能完成升级。 有关详细信息，请参阅使用升级顾问来准备升级。
注意注意

在 SQL Server Data Tools 中，您可以在报表生成器和报表设计器中创建和修改报表定义 (.rdl)。每个创作环境提供了不同的方式来创建、打开和保存报表和相关项。有关详细信息，请参阅 Web 上 microsoft.com 中的“在报表设计器和报表生成器中设计报表 (SSRS)”。

本文内容

在报表生成器中使用自定义代码

包括对常用函数的引用

包括对不太常用函数的引用

包括对外部程序集的引用

包括嵌入代码

包括对代码中的参数的引用

包括对自定义程序集中的代码的引用

将内置集合传递到自定义程序集中

在报表生成器中使用自定义代码

在报表生成器中，您可以从报表服务器中打开包含对自定义程序集的引用的报表。 例如，您可以编辑通过使用 SQL Server Data Tools (SSDT) 中的报表设计器创建和部署的报表。 必须将自定义程序集部署到报表服务器。

您不能执行下列操作：

  1. 向报表中添加引用或类成员实例。

  2. 在本地模式下预览具有对自定义程序集的引用的报表。

用于“返回首页”链接的箭头图标返回页首

包括对常用函数的引用

使用**“表达式”对话框查看内置到 Reporting Services 的常见函数分类列表。 展开“常见函数”并单击一个类别时，“项”窗格显示表达式中包括的函数的列表。 常见函数包括 .NET Framework System.Math 和 System.Convert 命名空间和 Visual Basic 运行时库函数的类。 为方便起见，您可以在“表达式”**对话框中查看最常用的函数，这些函数按以下类别排列：文本、日期和时间、数学函数、检查函数、程序流函数、聚合函数、财务函数、转换函数和杂项函数。 不太常用的函数未显示在列表中，但仍然可以用在表达式中。

若要使用内置函数，请双击“项”窗格中的函数名称。 “说明”窗格中显示该函数的说明，“示例”窗格中显示函数调用的示例。在“代码”窗格中，在左圆括号 ( 后键入函数名称时，IntelliSense 将帮助显示函数调用的每个有效语法。 例如，若要计算表中一个名为 Quantity 的字段的最大值，首先将简单表达式 =Max( 添加到“代码”窗格，然后使用智能标记查看该函数调用的所有可能的有效语法。 若要完成本示例，请键入 =Max(Fields!Quantity.Value)。

有关每个函数的详细信息，请参阅 System.Math、System.Convert 和 MSDN 中的 Visual Basic Runtime Library Members（Visual Basic 运行时库成员）。

用于“返回首页”链接的箭头图标返回页首

包括对不太常用函数的引用

若要包括一个对不太常用的 CLR 命名空间的引用，必须使用完全限定引用，例如 System.Text.StringBuilder。 对于这些不太常用的函数，**“表达式”**对话框的“代码”窗格不支持 IntelliSense。

有关详细信息，请参阅 Visual Basic Runtime Library Members（Visual Basic 运行时库成员）。

包括对外部程序集的引用

若要包括对外部程序集中的类的引用，必须标识报表处理器的程序集。 使用**“报表属性”对话框的“引用”页指定要添加到报表中的程序集的完全限定名称。 在表达式中，必须使用程序集中的类的完全限定名称。 外部程序集中的类不显示在“表达式”**对话框中，您必须提供正确无误的类名称。 完全限定名称包括命名空间、类名称和成员名称。

用于“返回首页”链接的箭头图标返回页首

包括嵌入代码

若要将嵌入代码添加到某个报表，请使用**“报表属性”对话框的“代码”选项卡。 创建的代码块可以包含多个方法。 嵌入代码中的方法必须采用 Microsoft Visual Basic 编写，并且必须是基于实例的方法。对于 System.Convert 和 System.Math 命名空间，报表处理器会自动添加引用。 使用“报表属性”对话框的“引用”**页添加附加的程序集引用。有关详细信息，请参阅向报表添加程序集引用 (SSRS)。

嵌入代码中的方法可通过全局定义的 Code 成员使用。 您可以通过引用 Code 成员和方法名称来访问这些方法。 下列示例调用 ToUSD 方法，该方法将 StandardCost 字段中的值转换为美元值：

=Code.ToUSD(Fields!StandardCost.Value)

若要引用自定义代码的内置集合，请包含对内置 Report 对象的引用：

=Report.Parameters!Param1.Value

下面的示例显示如何定义某些自定义常量和变量。

Public Const MyNote = "Authored by Bob"
Public Const NCopies As Int32 = 2
Public Dim  MyVersion As String = "123.456"
Public Dim MyDoubleVersion As Double = 123.456

尽管自定义常量不会出现在**“表达式”对话框的“常量”**类别（仅显示内置常量）中，但是可以从任何表达式向其中添加引用，如下面的示例所示。 在表达式中，自定义常量被视为 Variant。

=Code.MyNote
=Code.NCopies
=Code.MyVersion
=Code.MyDoubleVersion

下面的示例包括 FixSpelling 函数的代码引用和代码实现，该函数用 "Bicycle" 文本替换 SubCategory 字段中出现的所有“Bike”文本。

=Code.FixSpelling(Fields!SubCategory.Value)

嵌入报表定义代码块后，以下代码显示 FixSpelling 方法的实现。 本示例演示如何对 Microsoft .NET Framework StringBuilder 类使用完全限定引用。

Public Function FixSpelling(ByVal s As String) As String
   Dim strBuilder As New System.Text.StringBuilder(s)
   If s.Contains("Bike") Then
      strBuilder.Replace("Bike", "Bicycle")
      Return strBuilder.ToString()
      Else : Return s
   End If
End Function

有关内置对象集合和初始化的详细信息，请参阅内置的全局和用户引用（报表生成器和 SSRS）和初始化自定义程序集对象。

用于“返回首页”链接的箭头图标返回页首

包括对代码中的参数的引用

可以通过所提供的报表定义代码块中或自定义程序集中的自定义代码来引用全局参数集合。 该参数集合是只读的，并且没有公共迭代器。 不能使用 Visual Basic For Each 单步构造该集合。 您需要首先知道在报表定义中定义的参数名称，然后才能在代码中引用该参数。 但是，可以遍历多值参数的所有值。

下表包含从自定义代码引用该内置集合 Parameters 的示例：

说明

表达式中的引用

自定义代码定义

将整个全局参数集合传递给自定义代码。

该函数会返回特定报表参数 MyParameter 的值。

=Code.DisplayAParameterValue(Parameters)

Public Function DisplayAParameterValue(

ByVal parameters as Parameters) as Object

Return parameters("MyParameter").Value

End Function

将单个参数传递给自定义代码。

此示例返回传入的参数的值。 如果该参数是多值参数，则返回字符串将是所有值的串联。

=Code.ShowParametersValues(Parameters!DayOfTheWeek)

 
Public Function ShowParameterValues(ByVal parameter as Parameter)
 as String
   Dim s as String 
   If parameter.IsMultiValue then
      s = "Multivalue: " 
      For i as integer = 0 to parameter.Count-1
         s = s + CStr(parameter.Value(i)) + " " 
      Next
   Else
      s = "Single value: " + CStr(parameter.Value)
   End If
   Return s
End Function

用于“返回首页”链接的箭头图标返回页首

包括对自定义程序集中的代码的引用

若要在报表中使用自定义程序集，您必须先创建程序集，使其可供报表设计器使用，然后在报表中添加对该程序集的引用，最后在报表中使用表达式来引用该程序集中包含的方法。 如果报表部署到报表服务器，您还必须向报表服务器部署该自定义程序集。

有关创建自定义程序集并使其可供 Reporting Services 使用的信息，请参阅将自定义程序集用于报表。

若要在表达式中引用自定义代码，您必须调用自定义程序集中某个类的成员。 调用方式取决于该方法是静态方法还是基于实例的方法。 自定义程序集中的静态方法可在报表内全局使用。 您可以在表达式中通过指定命名空间、类和方法名称来访问静态方法。 下面的示例调用 ToGBP 方法，该方法将 StandardCost 的值从美元转换为英镑：

=CurrencyConversion.DollarCurrencyConversion.ToGBP(Fields!StandardCost.Value)

基于实例的方法可通过全局定义的 Code 成员使用。 您可以通过先引用 Code 成员，再引用实例和方法名称，来访问这些方法。 下面的示例调用实例方法 ToEUR，该方法将 StandardCost 的值从美元转换为欧元：

=Code.m_myDollarCoversion.ToEUR(Fields!StandardCost.Value)
注意注意

在报表设计器中，除非您关闭 Visual Studio，否则一旦加载自定义程序集，就不会卸载该程序集。 如果预览报表后对报表所用的自定义程序集进行更改，然后再次预览该报表，则第二次预览结果中不会体现所做的更改。 若要重新加载程序集，请关闭 Visual Studio，再将其重新打开，然后预览报表。

有关访问代码的详细信息，请参阅通过表达式访问自定义程序集。

用于“返回首页”链接的箭头图标返回页首

将内置集合传递到自定义程序集

如果要将内置集合（如 Globals 或 Parameters 集合）传递到自定义程序集进行处理，则必须将代码项目中的程序集引用添加到定义内置集合的程序集中并且访问正确的命名空间。 根据您是为运行在报表服务器上的报表（服务器报表）开发自定义程序集，还是为在 .NET 应用程序中本地运行的报表（本地报表）开发自定义程序集，需要引用的程序集会有所不同。 有关详细信息，请参阅下面的内容。

  • 命名空间： Microsoft.ReportingServices.ReportProcessing.ReportObjectModel

  • 程序集（本地报表）： Microsoft.ReportingServices.ProcessingObjectModel.dll

  • 程序集（服务器报表）： Microsoft.ReportViewer.ProcessingObjectModel.dll

因为 Fields 和 ReportItems 集合的内容可在运行时动态更改，所以不应阻止它们对自定义程序集的调用（例如，在成员变量中）。 同样的建议通常应用于所有内置集合。

请参阅

任务

向报表添加代码 (SSRS)

向报表添加程序集引用 (SSRS)

参考

表达式示例（报表生成器和 SSRS）

其他资源

将自定义程序集用于报表

Reporting Services 教程 (SSRS)

报表示例（报表生成器和 SSRS）