reporting-docs/doc-output/export-formats.md

17 KiB
Исходник Постоянная ссылка Ответственный История

title page_title description slug previous_url tags published position
Overview Document Output Overview Learn more about export formats (rendering extensions or document outputs) in Telerik Reporting and how you may control the available ones in your project. telerikreporting/using-reports-in-applications/export-and-configure/export-formats /using-reports-in-applications/export-and-configure/export-formats, /configuring-rendering-extensions, /doc-output/ telerik, reporting, export, formats, document, output, overview True 0

Overview of the Available Export Formats

An export format is a component of the Telerik Reporting engine that transforms report data and layout into a device-specific format. The export formats are also referred to as rendering extensions because they render the report content into a specific output format and because they get plugged into the engine as extensions. 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 applications 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]({%slug telerikreporting/using-reports-in-applications/export-and-configure/configure-the-report-engine/overview%}) and [Extensions Element]({%slug telerikreporting/using-reports-in-applications/export-and-configure/configure-the-report-engine/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]({%slug telerikreporting/using-reports-in-applications/export-and-configure/configure-the-export-formats/overview%}).

note 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 Apps by using Configuration Files.

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]({%slug telerikreporting/designing-reports/rendering-and-paging/design-considerations-for-report-rendering/pdf-rendering-design-considerations%}) 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]({%slug telerikreporting/using-reports-in-applications/export-and-configure/configure-the-export-formats/pdf-device-information-settings%}) Telerik.Reporting.ImageRendering.PdfReport, Telerik.Reporting, Version= x.x.x.x, Culture=neutral, PublicKeyToken=a9d7983dfcc261be
[XLS]({%slug telerikreporting/designing-reports/rendering-and-paging/design-considerations-for-report-rendering/excel-rendering-design-considerations%}) Renders a report in Microsoft Excel. The report opens in Microsoft Excel 97 or later. [Excel 2003 Device Information Settings]({%slug telerikreporting/using-reports-in-applications/export-and-configure/configure-the-export-formats/excel-2003-device-information-settings%}) Telerik.Reporting.ExcelRendering.Excel97.ExcelReport, Telerik.Reporting, Version= x.x.x.x, Culture=neutral, PublicKeyToken=a9d7983dfcc261be
[CSV]({%slug telerikreporting/designing-reports/rendering-and-paging/design-considerations-for-report-rendering/csv-rendering-design-considerations%}) Renders a report in comma-delimited format. The report opens in a viewing tool associated with CSV file formats. [CSV Device Information Settings]({%slug telerikreporting/using-reports-in-applications/export-and-configure/configure-the-export-formats/csv-device-information-settings%}) Telerik.Reporting.CsvRendering.CsvRenderingExtension, Telerik.Reporting, Version= x.x.x.x, Culture=neutral, PublicKeyToken=a9d7983dfcc261be
[RTF]({%slug telerikreporting/designing-reports/rendering-and-paging/design-considerations-for-report-rendering/rtf-rendering-design-considerations%}) Renders a report in Rich Text Format. The report opens in Microsoft Word 97 or later. [RTF Device Information Settings]({%slug telerikreporting/using-reports-in-applications/export-and-configure/configure-the-export-formats/rtf-device-information-settings%}) Telerik.Reporting.RtfRendering.RtfReport, Telerik.Reporting, Version= x.x.x.x, Culture=neutral, PublicKeyToken=a9d7983dfcc261be
[XPS]({%slug telerikreporting/designing-reports/rendering-and-paging/design-considerations-for-report-rendering/xps-rendering-design-considerations%}) 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]({%slug telerikreporting/using-reports-in-applications/export-and-configure/configure-the-export-formats/xps-device-information-settings%}) Telerik.Reporting.XpsRendering.XpsReport, Telerik.Reporting.XpsRendering, Version= x.x.x.x, Culture=neutral, PublicKeyToken=a9d7983dfcc261be
[DOCX]({%slug telerikreporting/designing-reports/rendering-and-paging/design-considerations-for-report-rendering/word-rendering-design-considerations%}) 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]({%slug telerikreporting/using-reports-in-applications/export-and-configure/configure-the-export-formats/word-device-information-settings%}) Telerik.Reporting.OpenXmlRendering.Wordprocessing.WordprocessingReport, Telerik.Reporting.OpenXmlRendering, Version= x.x.x.x, Culture=neutral, PublicKeyToken=a9d7983dfcc261be
[XLSX]({%slug telerikreporting/designing-reports/rendering-and-paging/design-considerations-for-report-rendering/excel-rendering-design-considerations%}) 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]({%slug telerikreporting/using-reports-in-applications/export-and-configure/configure-the-export-formats/excel-2007-device-information-settings%}) Telerik.Reporting.OpenXmlRendering.Spreadsheet.SpreadsheetReport, Telerik.Reporting.OpenXmlRendering, Version= x.x.x.x, Culture=neutral, PublicKeyToken=a9d7983dfcc261be
[PPTX]({%slug telerikreporting/designing-reports/rendering-and-paging/design-considerations-for-report-rendering/powerpoint-rendering-design-considerations%}) 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]({%slug telerikreporting/using-reports-in-applications/export-and-configure/configure-the-export-formats/powerpoint-device-information-settings%}) Telerik.Reporting.OpenXmlRendering.Presentation.PresentationReport, Telerik.Reporting.OpenXmlRendering, Version= x.x.x.x, Culture=neutral, PublicKeyToken=a9d7983dfcc261be
[MHTML]({%slug telerikreporting/designing-reports/rendering-and-paging/design-considerations-for-report-rendering/html-rendering-design-considerations%}) 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]({%slug telerikreporting/using-reports-in-applications/export-and-configure/configure-the-export-formats/mhtml-device-information-settings%}) Telerik.Reporting.HtmlRendering.MHtmlRenderingExtension, Telerik.Reporting, Version= x.x.x.x, Culture=neutral, PublicKeyToken=a9d7983dfcc261be
[IMAGE]({%slug telerikreporting/designing-reports/rendering-and-paging/design-considerations-for-report-rendering/image-rendering-design-considerations%}) Renders a report in image format with [physical page layout]({%slug telerikreporting/using-reports-in-applications/display-reports-in-applications/interactive-vs.-print-layout%}). The format is shown as TIFF in the Export drop-down of the Report Viewer toolbar. [IMAGE Device Information Settings]({%slug telerikreporting/using-reports-in-applications/export-and-configure/configure-the-export-formats/image-device-information-settings%}) Telerik.Reporting.ImageRendering.PhysicalImageReport, Telerik.Reporting, Version= x.x.x.x, Culture=neutral, PublicKeyToken=a9d7983dfcc261be
[IMAGEInteractive]({%slug telerikreporting/designing-reports/rendering-and-paging/design-considerations-for-report-rendering/image-rendering-design-considerations%}) Renders a report with [interactive page layout]({%slug telerikreporting/using-reports-in-applications/display-reports-in-applications/interactive-vs.-print-layout%}). By default the output format is EMF, but when not available, any other supported bitmap format can be used. TIFF is not supported because it's a multi-page format. Telerik internal use only. [IMAGEInteractive Device Information Settings]({%slug telerikreporting/using-reports-in-applications/export-and-configure/configure-the-export-formats/imageinteractive-device-information-settings%}) Telerik.Reporting.ImageRendering.ImageReportInteractive, Telerik.Reporting, Version= x.x.x.x, Culture=neutral, PublicKeyToken=a9d7983dfcc261be
[IMAGEPrintPreview]({%slug telerikreporting/designing-reports/rendering-and-paging/design-considerations-for-report-rendering/image-rendering-design-considerations%}) Renders a report with [PrintPreview page layout]({%slug telerikreporting/using-reports-in-applications/display-reports-in-applications/interactive-vs.-print-layout%}). By default the output format is EMF, but when not available, any other supported bitmap format can be used. TIFF is not supported because it's a multi-page format. [IMAGE Device Information Settings]({%slug telerikreporting/using-reports-in-applications/export-and-configure/configure-the-export-formats/image-device-information-settings%}) Telerik.Reporting.ImageRendering.PrintPreviewImageReport, Telerik.Reporting, Version= x.x.x.x, Culture=neutral, PublicKeyToken=a9d7983dfcc261be
[IMAGEPrint]({%slug telerikreporting/designing-reports/rendering-and-paging/design-considerations-for-report-rendering/image-rendering-design-considerations%}) Renders a report as image for printing. By default the output format is EMF, but when not available, any other supported bitmap format can be used. TIFF is not supported because it's a multi-page format. [IMAGE Device Information Settings]({%slug telerikreporting/using-reports-in-applications/export-and-configure/configure-the-export-formats/image-device-information-settings%}) Telerik.Reporting.ImageRendering.PrintImageReport, Telerik.Reporting, Version= x.x.x.x, Culture=neutral, PublicKeyToken=a9d7983dfcc261be
[HTML5]({%slug telerikreporting/designing-reports/rendering-and-paging/design-considerations-for-report-rendering/html-rendering-design-considerations%}) Renders a report in XHTML 1.1 compliant HTML with [physical page layout]({%slug telerikreporting/using-reports-in-applications/display-reports-in-applications/interactive-vs.-print-layout%}).
(This is a multi-stream rendering extension and should be only used with RenderReport).
[HTML5 Device Information Settings]({%slug telerikreporting/using-reports-in-applications/export-and-configure/configure-the-export-formats/html5-device-information-settings%}) Telerik.Reporting.Html5Rendering.Html5Report, Telerik.Reporting, Version= x.x.x.x, Culture=neutral, PublicKeyToken=a9d7983dfcc261be
[HTML5Interactive]({%slug telerikreporting/designing-reports/rendering-and-paging/design-considerations-for-report-rendering/html-rendering-design-considerations%}) Renders a report in XHTML 1.1 compliant HTML with [interactive page layout]({%slug telerikreporting/using-reports-in-applications/display-reports-in-applications/interactive-vs.-print-layout%}).
(This is a multi-stream rendering extension and should be only used with RenderReport). Telerik internal use only.
[HTML5Interactive Device Information Settings]({%slug telerikreporting/using-reports-in-applications/export-and-configure/configure-the-export-formats/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]({%slug telerikreporting/using-reports-in-applications/display-reports-in-applications/interactive-vs.-print-layout%}).
(This is a multi-stream rendering extension and should be only used with RenderReport)
- 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]({%slug telerikreporting/using-reports-in-applications/display-reports-in-applications/interactive-vs.-print-layout%}).
(This is a multi-stream rendering extension and should be only used with RenderReport). 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]({%slug telerikreporting/using-reports-in-applications/display-reports-in-applications/interactive-vs.-print-layout%}).
(This is a multi-stream rendering extension and should be only used with RenderReport).
- 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]({%slug telerikreporting/using-reports-in-applications/display-reports-in-applications/interactive-vs.-print-layout%}).
(This is a multi-stream rendering extension and should be only used with RenderReport). Telerik internal use only.
- Telerik.Reporting.XamlRendering.WpfReportInteractive, Telerik.Reporting, Version= x.x.x.x, Culture=neutral, PublicKeyToken=a9d7983dfcc261be

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