Реализация интерфейса IRenderingExtension
Модуль подготовки отчетов извлекает результаты из определения отчета, объединенного с реальными данными, и преобразует результирующие данные в формат, готовый к применению. Преобразование объединенных данных и форматирование осуществляется при помощи класса среды CLR, который реализует интерфейс IRenderingExtension. Модель объекта преобразуется в формат вывода, который предназначен для средства просмотра, принтера или другого приложения вывода.
Интерфейс IRenderingExtension имеет три метода, которые должны быть реализованы.
Render подготавливает отчет к просмотру.
RenderStream подготавливает к просмотру определенный поток из отчета.
GetRenderingResource — получает дополнительные сведения, необходимые для отчета, например значки.
В следующих разделах данные методы обсуждаются более подробно.
метод Render
Метод Render содержит аргументы, представляющие следующие объекты.
report — отчет, который необходимо подготовить. Данный объект содержит свойства, данные и сведения о макете отчета. Report — это корневой узел дерева модели объектов отчета.
Параметр ServerParameters одержит объект словаря строк с параметрами сервера отчетов (если такие существуют).
Параметр deviceInfo , содержащий параметры устройства. Дополнительные сведения см. в разделе "Передача параметров сведений об устройстве" модулям отрисовки.
Параметр clientCapabilities , содержащий NameValueCollection объект словаря, содержащий сведения о клиенте, на котором выполняется отрисовка.
Параметр RenderProperties , содержащий сведения о результатах отрисовки.
Параметр createAndRegisterStream — это функция-делегат, которую можно вызвать для получения потока, в который будет осуществляться отрисовка.
параметр deviceInfo
Параметр deviceInfo содержит параметры отрисовки, а не параметры отчета. Данные параметры передаются модулю подготовки отчетов. Значения deviceInfo преобразуются сервером отчетов в объект NameValueCollection. Элементы в параметре deviceInfo рассматриваются как значения без учета регистра. Если запрос на отрисовку поступил в результате доступа по URL-адресу, то параметры URL-адреса в формате rc:key=value преобразовываются в пары "ключ-значение" в объекте словаря deviceInfo. Код обнаружения браузера также предоставляет следующие элементы в словаре clientCapabilities: EcmaScriptVersion, JavaScript, MajorVersion, MinorVersion, Win32, Type и AcceptLanguage. Модуль отрисовки игнорирует любую пару "имя-значение" в параметре deviceInfo , который не понимает. В следующем образце кода показывается образец метода GetRenderingResource, возвращающего значки:
public void GetRenderingResource (CreateStream createStreamCallback, NameValueCollection deviceInfo)
{
string[] iconTagValues = deviceInfo.GetValues("Icon");
if ((iconTagValues != null) && (iconTagValues.Length > 0) )
{
// Create a stream to output to.
Stream outputStream = createStreamCallback(m_iconResourceName, "gif", null, "image/gif", false);
// Get the GIF image for one of the buttons on the toolbar
Image requiredImage = (Image) m_resourcemanager.GetObject(m_iconResourceName
// Write the image to the output stream
requiredImage.Save(outputStream, requiredImage.RawFormat);
}
return;
}
Метод RenderStream
Метод RenderStream подготавливает к просмотру определенный поток из отчета. Все потоки создаются во время первоначального Render вызова, но потоки изначально не возвращаются клиенту. Этот метод используется для вторичных потоков, таких как изображения в отрисовке HTML или других страницах модуля отрисовки на нескольких страницах, таких как Image/EMF.
Метод GetRenderingResource
Метод GetRenderingResource получает данные, не выполняя полную подготовку отчета. Существует время, когда отчету требуется информация, которая не требует отрисовки самого отчета. Например, если нужно получить значок, связанный с модулем подготовки отчетов, следует использовать параметр deviceInfo, содержащий единственный тег <Icon>. В подобных случаях можно использовать метод GetRenderingResource.