Passing Device Information Settings to Rendering Extensions
Topic Status: Some information in this topic is preview and subject to change in future releases. Preview information describes new features or changes to existing features in Microsoft SQL Server 2016 Community Technology Preview 2 (CTP2).
In Reporting Services, 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 Reporting Services configuration files to specify rendering parameters globally. For more information about specifying rendering parameters globally, see Customize Rendering Extension Parameters in RSReportServer.Config.
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 Render(String, String, String, String, String, Warning, String) 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.
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.
http://<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.