Skip to content

Latest commit

 

History

History
53 lines (44 loc) · 4.5 KB

passing-device-information-settings-to-rendering-extensions.md

File metadata and controls

53 lines (44 loc) · 4.5 KB
title description author ms.author ms.date ms.service ms.subservice ms.topic ms.custom helpviewer_keywords
Passing Device Information Settings to Rendering Extensions
Rendering parameters are passed a rendering extension. Specify device information settings by the Render method, as URL parameter, or in configuration files.
kfollis
kfollis
09/25/2024
reporting-services
report-server-web-service
reference
updatefrequency5
device information settings [Reporting Services]
Render method
Report Server Web service, device information settings
Web service [Reporting Services], device information settings
XML Web service [Reporting Services], device information settings
passing device information [Reporting Services]
rendering extensions [Reporting Services], device information settings
rendering [Reporting Services], settings
device information settings [Reporting Services], about device information settings
extensions [Reporting Services], device information settings

Passing Device Information Settings to Rendering Extensions

In [!INCLUDEssRSnoversion], device information settings are used to pass rendering parameters to a rendering extension. Settings in the Report Server Web service are passed as a DeviceInfo XML element and processed by the report server. Because device information settings have default values, they are considered optional arguments in the rendering process. However, you can use device information settings to customize rendering and to override the default values that are supplied by the server.

You can specify device information settings in a variety of ways. Programmatically, you can use the Render method. If you are accessing a report through its URL, you can specify device information as URL parameters. You can also edit the device information settings in the [!INCLUDEssRSnoversion] configuration files to specify rendering parameters globally. For more information about specifying rendering parameters globally, see Customize Rendering Extension Parameters in RSReportServer.Config.

Passing Device Information Using the Render Method

To pass device information settings to a rendering extension, use the M:Microsoft.WSSUX.ReportingServicesWebService.RSExecutionService2005.ReportExecutionService.Render(System.String,System.String,System.String@,System.String@,System.String@,Microsoft.WSSUX.ReportingServicesWebService.RSExecutionService2005.Warning[]@,System.String[]@) method. For example, the following XML string can be passed to the xref:ReportExecution2005.ReportExecutionService.Render%2A method to create an HTML fragment when rendering to HTML.

<DeviceInfo>  
   <HTMLFragment>True</HTMLFragment>  
</DeviceInfo>

When a report is rendered as an HTML fragment, the content of the report is contained within a TABLE element without the use of an HTML or BODY element. You can use the HTML fragment to incorporate the report into an existing HTML document. For more information about device information settings for HTML output, see HTML Device Information Settings.

Passing Device Information Using URL Access

You can also pass device information settings through URL access. Device information settings are passed as URL parameters. The following URL access string can be passed to the report server to generate a rendered report without the HTML viewer toolbar.

https://<Server Name>/reportserver?/SampleReports/Sales Order Detail&rs:Command=Render&rs:Format=HTML4.0&rc:Toolbar=False

For more information, see Specify Device Information Settings in a URL.

Related content