Reporting Services Device Information Settings

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 Customizing Rendering Extension Parameters in RSReportServer.Config.

Passing Device Information Using the Render Method

To pass device information settings to a rendering extension, use the Render(String, String, String%, String%, String%, array<Warning[]%, array<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 Specifying Device Information Settings in a URL.

In This Section

Topic

Description

CSV Device Information Settings

Describes the device information settings that are associated with CSV rendering output.

Excel Device Information Settings

Describes the device information settings that are associated with Excel rendering output.

Word Device Information Settings

Describes the device information settings that are associated with Word rendering output.

HTML Device Information Settings

Describes the device information settings that are associated with HTML rendering output.

Image Device Information Settings

Describes the device information settings that are associated with IMAGE rendering output.

MHTML Device Information Settings

Describes the device information settings that are associated with MHTML rendering output.

PDF Device Information Settings

Describes the device information settings that are associated with PDF rendering output.

XML Device Information Settings

Describes the device information settings that are associated with XML rendering output.