自定义报表项类库

自定义报表项使用 Microsoft.ReportDesigner 命名空间中的类。 用于实现自定义报表项的类可分为两个主要类别：旨在支持自定义报表项基础结构的唯一类和用于封装相关报表定义语言 (RDL) 元素功能的托管包装类。 有关如何使用这些类的代码示例，请参阅 SQL Server Reporting Services Product Samples（SQL Server Reporting Services 产品示例）。

自定义报表项基础结构类

以下类用于实现自定义报表项。

注意

以下表并非完整列表；这些表仅包括每个类最常用的属性和方法。

Microsoft.ReportDesigner.CustomReportItemDesigner

Microsoft.ReportDesigner.CustomReportItemDesigner 是主要的自定义报表项类。 自定义报表项实现的主类必须继承自此类。

公共属性

属性	说明
名称	自定义报表项的名称。
类型	自定义报表项的类型。
CustomData	用于封装在设计时指定的自定义报表项数据属性的 CustomData 对象。
CustomProperties	自定义报表项的自定义属性的集合。
Height	自定义报表项控件的高度。
Width	自定义报表项控件的宽度。
Report	报表级别属性（如报表中数据集的列表）的容器。
AltReportItem	备用报表项对象，用于不支持自定义报表项运行时控件的位置。
样式	自定义报表项的样式属性。
修饰	用于对控件进行交互式编辑的修饰窗口。
站点	组件的 ISite。
DesignerVerbCollection	控件快捷菜单的自定义谓词的数组。

公共方法

方法	说明
BeginEdit	激活控件的交互式编辑。
DoDefaultAction	在响应对控件的双击或在控件上按 Return 键时调用。
EndEdit	停用控件的交互式编辑。
GetService	返回一个对象，该对象表示服务。
InitializeNewComponent	当创建新的自定义报表项时调用。
Invalidate	重新绘制控件的整个图面。
OnDragEnter OnDragDrop	当将对象拖到控件上时调用。
OnPaint	当响应 Paint 事件时调用。

Microsoft.ReportDesigner.CustomReportItemAttribute

Microsoft.ReportDesigner.CustomReportItemAttribute 是用于标识自定义报表项类型的属性。 此名称必须与报表设计器配置文件中 ReportItem 元素的 <Name> 属性的值相匹配。

公共方法

方法	说明
CustomReportItemAttribute	构造 CustomReportItemAttribute 对象。

Microsoft.ReportDesigner.LocalizedNameAttribute

Microsoft.ReportDesigner.LocalizedNameAttribute 是用于指定要用于自定义报表项设计器的显示名称的属性。

公共方法

方法	说明
LocalizedNameAttribute	构造 LocalizedNameAttribute 对象。

Microsoft.ReportDesigner.Adornment

自定义报表项设计时组件使用修饰类来提供设计图面主矩形之外的区域。 这些区域可用来处理用户界面事件，如鼠标单击和拖放操作。

公共方法

方法	说明
OnShow	当激活修饰时调用。
OnHide	当停用修饰时调用。
画图	当响应 Paint 事件时调用。
OnDragEnter OnDragOver OnDragLeave OnDragDrop	当将对象拖入修饰时调用。

Microsoft.ReportDesigner.AdornerService

此类用于提供自定义报表项所使用的一组显示服务，以支持自定义报表项设计时组件中的修饰对象。

公共属性

属性	说明
AdornerWindowBounds	装饰器窗口的界限。
AdornerWindowRegion	装饰器窗口的区域。
AdornerWindowGraphics	装饰器窗口的图形上下文。

公共方法

方法	说明
ComponentRectInDesignerFrame	返回转换为设计器框架坐标的组件的边界。
InvalidateAdorner	使装饰器窗口失效。
PointToAdorner	返回转换为装饰器窗口坐标的屏幕坐标中的点。

Microsoft.ReportDesigner.ExpressionEditor

可以从自定义报表项设计时控件使用此类调用表达式编辑器。

公共方法

方法	说明
EditValue	调用以给定的对象值初始化的表达式编辑器。

Microsoft.ReportDesigner.IFieldsDataObject

此类是 Reporting Services 字段的集合，用于支持设计环境中的拖放事件。 继承自 IReportItemDataObject。

公共属性

属性	说明
DataSetName	包含要拖放的字段的数据集的名称。
Fields	要删除的字段 (Microsoft.ReportDesigner.Field) 集合。

相关内容

报表定义语言 (SSRS)
创建自定义报表项运行时组件
创建自定义报表项设计时组件