创建自定义汇编后,将其提供给 报表设计器 或报告服务器,添加相应的安全策略,并在报告定义中添加自定义汇编的引用,您可以使用报告表达式访问汇编中类的成员。 若要在表达式中引用自定义代码,您必须调用程序集中某个类的成员。 调用方式取决于该方法是静态方法还是基于实例的方法。
调用报告定义文件中的静态成员
静态成员属于类或类型本身,而不是实例化的对象。 这些成员可以通过直接从类中调用来访问。 你应该尽可能使用静态成员来调用报表中的自定义函数,因为静态成员表现最佳。 要调用静态成员,你需要以表达式的形式引用它,形式为 =Namespace.Class.Method。
调用静态成员
要调用静态成员,将表达式设为成员的完全限定名称,包括命名空间、类名和成员名。 以下示例调用 了ToGBP 方法,该方法将 StandardCost 字段价值从美元转换为英镑,并在报告中显示:
=CurrencyConversion.DollarCurrencyConversion.ToGBP(Fields!StandardCost.Value)
关于静态场和性质的重要信息
目前,所有报告都在同一应用域中执行。 这意味着包含用户特定静态数据的报告会将这些数据暴露给同一报告的其他实例。 该条件可能使得某一用户的静态数据对所有正在运行该报告的用户开放。 因此,强烈建议不要在自定义装配或 代码 元素中使用静态字段或属性;相反,在报表中使用实例字段或属性。 静态方法仍然可以使用,因为它们不存储状态或数据。
调用报告定义文件中的实例成员
如果你的自定义汇编包含需要在报告定义中访问的实例成员,你必须在报告中添加你的类实例名称。 您可以使用“报告属性”对话框中的代码标签为类添加实例名称。 关于如何向报告添加类实例的更多信息,请参见 报表设计器 (SSRS) 中的表达式中的自定义代码和汇编引用。
要调用静态成员,你需要以表达式形式引用它,形式为 =Code*。实例名称.方法*。
调用实例成员
要调用自定义汇编的实例成员,必须引用 Code 关键字,后跟实例名和方法。 以下示例调用了 ToEUR 实例方法,该方法将 StandardCost 字段值从美元转换为欧元,并在报表中显示:
=Code.m_myDollarConversion.ToEUR(Fields!StandardCost.Value)