Edit

Export a paginated report to an image file (Report Builder)

  • Article

Applies to: ✅ Microsoft Report Builder (SSRS) ✅ Power BI Report Builder ✅ Report Designer in SQL Server Data Tools

The Image rendering extension renders a paginated report to a bitmap or metafile. By default, the Image rendering extension produces a TIFF file of the report, which can be viewed in multiple pages. When the client receives the image, it can be displayed in an image viewer and printed. This article provides Image renderer-specific information and describes exceptions to the rendering rules.

The Image rendering extension can generate files in any of the formats supported by GDI+: BMP, EMF, EMFPlus, GIF, JPEG, PNG, and TIFF. For TIFF format, the file name of the primary stream is ReportName.tif. For all other formats, which render as a single page per file, the file name is ReportName_Page.ext where .ext is the file extension for the chosen format. To produce a file in another Image-supported format, specify any of the above listed strings in the OutputFormatDeviceInfo setting.

Note

You can create and modify paginated report definition (.rdl) files in Microsoft Report Builder, Power BI Report Builder, and in Report Designer in SQL Server Data Tools.

Supported image formats

The following table shows the file extension and MimeType for each Image renderer format.

Type Extension MIMEType
BMP bmp image/bmp
GIF gif image/gif
JPEG jpeg image/jpeg
PNG png image/png
TIFF tif image/tiff
EMF emf image/emf
EMFPlus emf image/emf

Render multiple pages

TIFF is the only format that supports multiple page documents in a single file. Other formats, such as JPG or PNG, output one page at a time and require a separate call to the rendering extension for each page.

Interactivity

Interactivity isn't supported in any Image formats generated by this renderer. The following interactive elements aren't rendered:

  • Hyperlinks

  • Show or Hide

  • Document Map

  • Drillthrough or clickthrough links

  • End user sort

  • Fixed headers

  • Bookmarks

Device information settings

You can change some default settings for this renderer by changing the device information settings. For more information, see Image device information settings.

Related content