初始化自定义程序集对象
在某些情况下,在实例化自定义程序集类时,可能需要初始化自定义程序集类中的属性和字段值。 你最可能需要使用报表的全局对象集合中可用的值初始化自定义类。 为此,需要覆盖报表的 Code 对象的 OnInit 方法。 若要访问 OnInit,请使用报表定义的 Code 元素。 有两种方法可用于初始化你计划要在报表中使用的自定义程序集中类的属性值或字段值:可以使用 OnInit 声明和创建类的新实例,或者可以使用 OnInit 调用可以公共使用的方法。
全局对象集合和初始化
若干集合可用于初始化您的自定义类变量。 可以使用 Globals 和 User 集合。 调用 OnInit 方法时,在报表生命周期中,参数、字段和 ReportItems 集合不可用。 若要使用共享集合(Globals 或 User),需要包括 Report 对象引用。 例如,若要基于访问报表的用户的当前语言初始化自定义类,则 Code 元素可能如下:
Dim m_myClass As MyClass
Protected Overrides Sub OnInit()
m_myClass = new MyClass(Report.User!Language, _
Report.Globals!ExecutionTime)
End Sub
初始化上述类的属性值和字段值的一个方法就是声明您的类并通过调用某一覆盖的构造函数创建其新实例。
初始化自定义程序集中类的属性值和字段值的另一个方法是调用从 OnInit 方法定义的可以公共使用的方法。 您首先需要在报表定义文件中为您的类添加一个实例名称。 添加适当的程序集引用和实例名称后,可以调用初始化方法来初始化类的属性和字段值。 OnInit 方法可能如下:
Protected Overrides Sub OnInit()
m_myClass.MyInitializationMethod(Report.User!Language, _
Report.Globals!ExecutionTime)
End Sub
有关为自定义类添加程序集引用和实例名称的详细信息,请参阅向报表添加程序集引用 (SSRS)。
有关全局对象集合的详细信息,请参阅表达式中的内置集合(报表生成器和 SSRS)。