将设备信息设置传递给呈现扩展插件

在 Reporting Services中,设备信息设置用于将呈现参数传递到呈现扩展插件。 报表服务器 Web 服务中的设置将以 DeviceInfo XML 元素的形式传递并由报表服务器进行处理。 由于设备信息设置均具有默认值,因此在呈现进程中可将其视为可选参数。 但是,您可以使用设备信息设置对呈现进行自定义并覆盖由服务器提供的默认值。

可以用多种方式指定设备信息设置。 可以通过编程方式使用 Render 方法。 如果要通过报表的 URL 访问报表,则可以指定设备信息作为 URL 参数。 还可以在 Reporting Services 配置文件中编辑设备信息设置,以指定全局呈现参数。 有关全局指定呈现参数的详细信息,请参阅在 RSReportServer.Config 中自定义呈现扩展插件参数

使用 Render 方法传递设备信息

要将设备信息设置传递到呈现扩展插件,请使用 M:Microsoft.WSSUX.ReportingServicesWebService.RSExecutionService2005.ReportExecutionService.Render(System.String,System.String,System.String@,System.String@,System.String@,Microsoft.WSSUX.ReportingServicesWebService.RSExecutionService2005.Warning[]@,System.String[]@) 方法。 例如,当以 HTML 格式呈现时,可将以下 XML 字符串传递到 Render 方法以创建一个 HTML 段落。

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

当报表作为 HTML 段落呈现时,报表的内容包含在 TABLE 元素内,而不使用 HTML 或 BODY 元素。 可以使用 HTML 段落将报表并入现有 HTML 文档中。 有关 HTML 输出的设备信息设置的详细信息,请参阅 HTML 设备信息设置

使用 URL 访问传递设备信息

您也可以通过 URL 访问传递设备信息设置。 设备信息设置以 URL 参数的形式传递。 可以将以下 URL 访问字符串传递到报表服务器以生成不带 HTML 查看器工具栏的所呈现报表。

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

有关详细信息,请参阅在 URL 中指定设备信息设置

另请参阅

呈现扩展插件的设备信息设置 (Reporting Services)
在 RSReportServer.Config 中自定义呈现扩展插件参数
使用 Web 服务和 .NET Framework 生成应用程序