Passing Device Information Settings to Rendering Extensions

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.

Passing Device Information Using the Render Method

To pass device information settings to a rendering extension, use the 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 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.

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.

See Also

Concepts

Device Information Settings for Rendering Extensions (Reporting Services)

Customize Rendering Extension Parameters in RSReportServer.Config

Other Resources

Building Applications Using the Web Service and the .NET Framework