Пользовательские библиотеки классов элементов отчета

Пользовательские элементы отчета используют классы из пространства имен Microsoft.ReportDesigner. Классы, используемые для реализации пользовательского элемента отчета, можно разделить на две основные группы: уникальные классы, созданные для поддержки инфраструктуры пользовательских элементов отчетов, и управляемые классы-оболочки, инкапсулирующие функциональные возможности соответствующих элементов языка определения отчетов. Образец кода для использования этих классов см. на странице Образцы продуктов служб SQL Server Reporting.

Классы инфраструктуры пользовательских элементов отчета

Для реализации пользовательского элемента отчета используются следующие классы.

Примечание.

Приводимые далее в таблицах списки неполны; в них перечислены только наиболее часто используемые методы и свойства для каждого класса.

Microsoft.ReportDesigner.CustomReportItemDesigner

Microsoft.ReportDesigner.CustomReportItemDesigner является основным пользовательским классом элемента отчета. Главный класс реализации пользовательского элемента отчета должен быть производным от этого класса.

Открытые свойства

Свойство	Описание
Имя	Имя пользовательского элемента отчета.
Тип	Тип пользовательского элемента отчета.
CustomData	Объект CustomData, инкапсулирующий свойства данных пользовательского элемента отчета, заданные во время разработки.
CustomProperties	Коллекция пользовательских свойств пользовательского элемента отчета.
Высота	Высота элемента управления пользовательского элемента отчета.
Ширина	Ширина элемента управления пользовательского элемента отчета.
Отчет	Контейнер для свойств уровня отчета, таких как список наборов данных отчета.
AltReportItem	Альтернативный объект элемента отчета, используемый, где не поддерживается пользовательский элемент управления временем выполнения элемента отчета.
Style	Свойства стиля для пользовательского элемента отчета.
Adornment	Окно дополнения, используемое для интерактивного редактирования элемента управления.
Сайт	ISite компонента.
DesignerVerbCollection	Набор пользовательских команд, доступных через контекстное меню элемента управления.

Открытые методы

Метод	Description
BeginEdit	Активизирует интерактивное редактирование элемента управления.
DoDefaultAction	Вызывается двойным щелчком или нажатием клавиши ВВОД в элементе управления.
EndEdit	Деактивирует интерактивное редактирование элемента управления.
GetService	Возвращает объект, представляющий службу.
InitializeNewComponent	Вызывается при создании нового пользовательского элемента отчета.
Invalidate	Перерисовывает всю область элемента управления.
OnDragEnter OnDragDrop	Вызывается при перетаскивании объекта на элемент управления.
OnPaint	Вызывается в ответ на событие Paint.

Microsoft.ReportDesigner.CustomReportItemAttribute

Microsoft.ReportDesigner.CustomReportItemAttribute — это атрибут, используемый для идентификации типа пользовательского элемента отчета. Имя должно соответствовать значению атрибута <Name> элемента ReportItem в файле конфигурации конструктора отчетов.

Открытые методы

Метод	Description
CustomReportItemAttribute	Создает объект CustomReportItemAttribute.

Microsoft.ReportDesigner.LocalizedNameAttribute

Microsoft.ReportDesigner.LocalizedNameAttribute — это атрибут, используемый для указания отображаемого имени для пользовательского конструктора элементов отчета.

Открытые методы

Метод	Description
LocalizedNameAttribute	Создает объект LocalizedNameAttribute.

Microsoft.ReportDesigner.Adornment

Класс Adornment используется компонентом времени разработки пользовательского элемента отчета для предоставления областей за пределами основного прямоугольника области конструктора. Эти области могут обрабатывать события пользовательского интерфейса, такие как щелчки кнопкой мыши и операции перетаскивания.

Открытые методы

Метод	Description
OnShow	Вызывается при активации Adornment.
OnHide	Вызывается при деактивации Adornment.
Paint	Вызывается в ответ на событие Paint.
OnDragEnter OnDragOver OnDragLeave OnDragDrop	Вызывается при перетаскивании объекта в Adornment.

Microsoft.ReportDesigner.AdornerService

Этот класс используется для предоставления коллекции служб отображения, используемых пользовательским элементом отчета для поддержки объектов Adornment для компонента времени разработки пользовательского элемента отчета.

Открытые свойства

Свойство	Description
AdornerWindowBounds	Границы окна Adorner.
AdornerWindowRegion	Область окна Adorner.
AdornerWindowGraphics	Графический контекст окна Adorner.

Открытые методы

Метод	Description
ComponentRectInDesignerFrame	Возвращает границы компонента, преобразованные в координаты экрана конструктора.
InvalidateAdorner	Делает недействительным окно Adorner.
PointToAdorner	Возвращает точку в экранных координатах, преобразованных в координаты окна Adorner.

Microsoft.ReportDesigner.ExpressionEditor

Этот класс можно использовать из элемента управления времени разработки пользовательского элемента отчета для вызова редактора выражений.

Открытые методы

Метод	Description
EditValue	Вызывает редактор выражений, инициализированный значением данного объекта.

Microsoft.ReportDesigner.IFieldsDataObject

Этот класс представляет собой коллекцию полей Reporting Services и используется для поддержки событий перетаскивания в среде проектирования. Наследует от IReportItemDataObject.

Открытые свойства

Свойство	Description
DataSetName	Имя набора данных, содержащего поля, которые предназначены для перетаскивания.
Поля	Коллекция полей (Microsoft.ReportDesigner.Field) для удаления.

Связанный контент

Язык определения отчетов (SSRS)
Создание настраиваемого компонента времени выполнения элемента отчета
Создание пользовательского компонента конструктора элемента отчета