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

本文内容

在 Report Builder 3.0 中使用自定义代码

包括对常用函数的引用

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

包括对外部程序集的引用

包括嵌入代码

包括对来自代码的参数的引用

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

在 Report Builder 3.0 中使用自定义代码

在报表生成器中，您可以从报表服务器上打开包含对自定义程序集的引用的报表。例如，您可以编辑使用 Business Intelligence Development Studio 中的报表设计器创建和部署的报表。自定义程序集必须部署到报表服务器。

您不能执行下列操作：

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 运行时库成员。

返回页首

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

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

有关详细信息，请参阅 MSDN 上的 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

有关内置对象集合和初始化的详细信息，请参阅使用内置的全局和用户引用（Report Builder 3.0 和 SSRS）和初始化自定义程序集对象。

返回页首

包括对来自代码的参数的引用

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

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

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 集合的内容可在运行时动态更改，所以不应阻止它们对自定义程序集的调用（例如，在成员变量中）。同样的建议通常应用于所有内置集合。

请参阅

任务

参考

概念

其他资源