Progress® Telerik® Reporting R2 2017

Rendering Extensions

A rendering extension is a component of the Telerik Reporting engine that transforms report data and layout into a device-specific format. By default Telerik Reporting outputs reports in the following formats: Image, PDF, HTML, MHTML, Excel 97-2003, XLSX, PPTX, DOCX, RTF, XAML and CSV. Interactive rendering extensions (IMAGEInteractive, HTML5Interactive, XAMLInteractive, WPFXAMLInteractive) are used internally by viewers to allow interaction with the content e.g., toggling the visibility of items/sections. Interactive rendering extensions are for Telerik Internal use only.

You can specify rendering extension parameters in your application’s configuration file to override the default report rendering behavior. The rendering extension parameters are specified as device information settings.

Adding device information settings to an application configuration file is useful when you want to override the default values that are provided by the reporting engine. Specifying device information settings in the configuration files affects rendering extensions globally in the application. The settings in the configuration files are used in place of default values whenever a particular rendering extension is used. If you want to specify device information settings, you need to add Telerik Reporting Configuration Section and Extensions Element.

If you want to set rendering extension parameters for a specific report or rendering operation, you must specify device information programmatically using the RenderReport method. For more information about specifying device information settings for a rendering operation, and to view the complete list of device information settings, see Telerik Reporting Device Information Settings.

Caution note Caution

For Windows applications the configuration file is called app.config and for ASP.NET applications – web.config. For more information about configuring a .NET application, see Configuring Applications( http://msdn2.microsoft.com/en-us/library/kza1yk3a(VS.80).aspx).

Caution note Caution

All configuration settings on Telerik Reporting engine are applied only at runtime, not in design-time.

 The following table describes the rendering extensions that are included with Telerik Reporting:

Extension Name

Description

Optional Settings

Type

PDF

Renders a report in the Adobe Acrobat Reader. The format is shown as Acrobat (PDF) File in the Export drop-down of the report toolbar.

PDF Device Information Settings

Telerik.Reporting.ImageRendering.PdfReport, Telerik.Reporting, Version=x.x.x.x, Culture=neutral, PublicKeyToken=a9d7983dfcc261be

XLS

Renders a report in Microsoft Excel. The report opens in Microsoft Excel 97 or later.

Excel 2003 Device Information Settings

Telerik.Reporting.ExcelRendering.Excel97.ExcelReport, Telerik.Reporting, Version=x.x.x.x, Culture=neutral, PublicKeyToken=a9d7983dfcc261be

CSV

Renders a report in comma-delimited format. The report opens in a viewing tool associated with CSV file formats.

CSV Device Information Settings

Telerik.Reporting.CsvRendering.CsvRenderingExtension, Telerik.Reporting, Version=x.x.x.x, Culture=neutral, PublicKeyToken=a9d7983dfcc261be

RTF

Renders a report in Rich Text Format. The report opens in Microsoft Word 97 or later.

RTF Device Information Settings

Telerik.Reporting.RtfRendering.RtfReport, Telerik.Reporting, Version=x.x.x.x, Culture=neutral, PublicKeyToken=a9d7983dfcc261be

XPS

Renders a report in XML Paper Specification (XPS) format - electronic representation of digital documents based on XML. The report opens in Microsoft XPS Viewer.

XPS Device Information Settings

Telerik.Reporting.XpsRendering.XpsReport, Telerik.Reporting.XpsRendering, Version=x.x.x.x, Culture=neutral, PublicKeyToken=a9d7983dfcc261be

DOCX

Renders a report in Microsoft Word 2007 format (also known as OpenXML) - it is a zipped, XML-based file format developed by Microsoft for representing word processing documents.

Word Device Information Settings

Telerik.Reporting.OpenXmlRendering.Wordprocessing.WordprocessingReport, Telerik.Reporting.OpenXmlRendering, Version=x.x.x.x, Culture=neutral, PublicKeyToken=a9d7983dfcc261be

XLSX

Renders a report in Microsoft Excel 2007 format (also known as OpenXML) - it is a zipped, XML-based file format developed by Microsoft for representing spreadsheets.

Excel 2007 Device Information Settings

Telerik.Reporting.OpenXmlRendering.Spreadsheet.SpreadsheetReport, Telerik.Reporting.OpenXmlRendering, Version=x.x.x.x, Culture=neutral, PublicKeyToken=a9d7983dfcc261be

PPTX

Renders a report in Microsoft PowerPoint 2007 format (also known as OpenXML) - it is a zipped, XML-based file format developed by Microsoft for presentations.

PowerPoint Device Information Settings

Telerik.Reporting.OpenXmlRendering.Presentation.PresentationReport, Telerik.Reporting.OpenXmlRendering, Version=x.x.x.x, Culture=neutral, PublicKeyToken=a9d7983dfcc261be

MHTML

Renders a report in MHTML. The report opens in Internet Explorer. The format is shown as Web Archive in the Export drop-down of the report toolbar.

MHTML Device Information Settings

Telerik.Reporting.HtmlRendering.MHtmlRenderingExtension, Telerik.Reporting, Version=x.x.x.x, Culture=neutral, PublicKeyToken=a9d7983dfcc261be

IMAGE

Renders a report in image format with physical page layout. The format is shown as TIFF in the Export drop-down of the Report Viewer toolbar.

IMAGE Device Information Settings

Telerik.Reporting.ImageRendering.ImageReport, Telerik.Reporting, Version=x.x.x.x, Culture=neutral, PublicKeyToken=a9d7983dfcc261be

IMAGEInteractive

Renders a report in an EMF image format with interactive page layout. Telerik internal use only.

-

Telerik.Reporting.ImageRendering.ImageReportInteractive, Telerik.Reporting, Version=x.x.x.x, Culture=neutral, PublicKeyToken=a9d7983dfcc261be

HTML5

Renders a report in XHTML 1.1 compliant HTML with physical page layout. (This is a multi-stream rendering extension and should be only used with RenderReport(String, ReportSource, Hashtable, CreateStream, String)).

HTML5 Device Information Settings

Telerik.Reporting.Html5Rendering.Html5Report, Telerik.Reporting, Version=x.x.x.x, Culture=neutral, PublicKeyToken=a9d7983dfcc261be

HTML5Interactive

Renders a report in XHTML 1.1 compliant HTML with interactive page layout. (This is a multi-stream rendering extension and should be only used with RenderReport(String, ReportSource, Hashtable, CreateStream, String)). Telerik internal use only.

HTML5Interactive Device Information Settings

Telerik.Reporting.Html5Rendering.Html5ReportInteractive, Telerik.Reporting, Version=x.x.x.x, Culture=neutral, PublicKeyToken=a9d7983dfcc261be

XAML Renders a report in XAML for Silverlight with physical page layout. (This is a multi-stream rendering extension and should be only used with RenderReport(String, ReportSource, Hashtable, CreateStream, String))

-

Telerik.Reporting.XamlRendering.SilverlightReport, Telerik.Reporting, Version=x.x.x.x, Culture=neutral, PublicKeyToken=a9d7983dfcc261be

XAMLInteractive

Renders a report in XAML for Silverlight with interactive page layout. (This is a multi-stream rendering extension and should be only used with RenderReport(String, ReportSource, Hashtable, CreateStream, String)). Telerik internal use only.

-

Telerik.Reporting.XamlRendering.SilverlightReportInteractive, Telerik.Reporting, Version=x.x.x.x, Culture=neutral, PublicKeyToken=a9d7983dfcc261be

WPFXAML

Renders a report in XAML for WPF with physical page layout. (This is a multi-stream rendering extension and should be only used with RenderReport(String, ReportSource, Hashtable, CreateStream, String)).

-

Telerik.Reporting.XamlRendering.WpfReport, Telerik.Reporting, Version=x.x.x.x, Culture=neutral, PublicKeyToken=a9d7983dfcc261be

WPFXAMLInteractive

Renders a report in XAML for WPF with interactive page layout. (This is a multi-stream rendering extension and should be only used with RenderReport(String, ReportSource, Hashtable, CreateStream, String)). Telerik internal use only.

-

Telerik.Reporting.XamlRendering.WpfReportInteractive, Telerik.Reporting, Version=x.x.x.x, Culture=neutral, PublicKeyToken=a9d7983dfcc261be

Note Note

Replace the x.x.x.x version number above with the version of Telerik Reporting assembly that you are using.