• 项目

使用 URL 访问参数

可以将下列参数作为 URL 的一部分使用来配置报表的外观。本节列出了最常用的参数。参数是区分大小写的，并且如果将其定向到报表服务器，则以参数前缀 rs: 开头，如果定向到 HTML 查看器，则以参数前缀 rc: 开头。您也可以指定特定于设备或呈现扩展插件的参数。有关特定于设备的参数的详细信息，请参阅在 URL 中指定设备信息设置。

HTML 查看器命令

下表说明的 URL 访问参数带有 rc: 前缀并以 HTML 查看器为对象。

参数

操作

Toolbar

显示或隐藏工具栏。如果此参数的值为 false，将忽略所有剩余的选项。如果您忽略此参数，则自动为支持工具栏的呈现格式显示此工具栏。此参数的默认值为 true。

重要说明重要提示
rc:Toolbar=false 对使用 IP 地址（而非域名）来针对在 SharePoint 站点上承载的报表的 URL 访问字符串不适用。

Parameters

显示或隐藏工具栏的参数区域。如果将此参数设置为 true，将显示工具栏的参数区域。如果此参数设置为 false，则不显示参数区域，用户也不能显示参数区域。如果此参数设置为 Collapsed 值，则不会显示参数区域，但最终用户可以对参数区域进行切换。此参数的默认值为 true。

Zoom

设置报表缩放值，缩放值以整数百分比或字符串常量表示。标准字符串值包括 Page Width 和 Whole Page。早于 Internet Explorer 5.0 的 Internet Explorer 版本和所有非 Microsoft 浏览器忽略此参数。此参数的默认值为 100。

Section

设置将显示报表中的哪一页。对于任何设置为大于报表页数的值，都将显示最后一页。对于任何小于 0 的值，都将显示报表的第 1 页。此参数的默认值为 1。

StartFind

指定要搜索的最后部分。此参数的默认值为报表的最后一页。

EndFind

设置要搜索的最后一页的页码。例如，值 5 指示要搜索的最后一页为报表的第 5 页。默认值为当前页的页码。请将此参数与 StartFind 参数一起使用。

FallbackPage

设置在搜索或文档结构图选择失败的情况下显示的页码。默认值为当前页的页码。

GetImage

获取 HTML 查看器用户界面的特定图标。

Icon

获取特定呈现扩展插件的图标。

Stylesheet

指定要应用于 HTML 查看器的样式表。

在 URL 上，您还可以传递其他参数来定向 HTML 呈现的输出。有关详细信息，请参阅 HTML 设备信息设置。

报表服务器命令

下表说明了带有 rs: 前缀的用于指向报表服务器的 URL 访问参数。

参数

操作

Command

指定要搜索的最后部分。此参数的默认值为报表的最后一页。

Format

指定报表呈现的格式。常用值包括 HTML3.2、HTML4.0、MHTML、IMAGE、EXCEL、WORD、CSV、PDF、XML 和 NULL。有关详细信息，请参阅在 URL 中指定呈现格式。

ParameterLanguage

提供在与浏览器语言无关的 URL 中传递的参数的语言。默认值为浏览器语言。该值可以为区域性值，如 en-us 或 de-de。

Snapshot

基于报表历史记录快照呈现报表。有关详细信息，请参阅使用 URL 访问呈现报表历史记录快照。

PersistStreams

呈现单个持久流中的报表。图像呈现器使用此参数，通过一次传输一块的方式传输呈现的报表。在 URL 访问字符串中使用此参数后，将相同的 URL 访问字符串用于 GetNextStream 参数而非 PersistStreams 参数可以获取持久流中的下一个块。此 URL 命令最终将返回 0 字节流，以指明持久流结束。默认值为 false。

GetNextStream

在使用 PersistStreams 参数访问的持久流中获取下一个数据块。有关详细信息，请参阅 PersistStreams 的说明。默认值为 false。

报表查看器 Web 部件命令

下表介绍了 SQL Server 保留的报表参数名称，在 Reporting Services 与 Windows SharePoint Services (WSS) 3.0 或更高版本以及 Microsoft Office SharePoint Server 2007 或更高版本集成时，这些名称用于指向报表查看器 Web 部件。这些参数名称带有 rv: 前缀。报表查看器 Web 部件也接受 rs:ParameterLanguage 参数。

参数

操作

Toolbar

控制报表查看器 Web 部件的工具栏显示。默认值为 Full。可为以下值：

  • Full：显示完整的工具栏。

  • Navigation：只显示工具栏中的分页。

  • None：不显示工具栏。

HeaderArea

控制报表查看器 Web 部件的标头显示。默认值为 Full。可为以下值：

  • Full：显示完整的标头。

  • BreadCrumbsOnly：只显示标头中的痕迹导航以告知用户其在应用程序中所处的位置。

  • None：不显示标头。

DocMapAreaWidth

控制报表查看器 Web 部件中参数区域的显示宽度（以像素为单位）。默认值与报表查看器 Web 部件中的默认值一样。该值必须是非负整数。

AsyncRender

控制是否异步呈现报表。默认值为 true，该值指定将异步呈现报表。该值必须为布尔值 true 或 false。

ParamMode

控制报表查看器 Web 部件的参数提示区域将在整页视图中如何显示。有效值包括：

  • Full：显示参数提示区域。

  • Collapsed：折叠参数提示区域。

  • Hidden：隐藏参数提示区域。

默认值为 Full。

DocMapMode

控制报表查看器 Web 部件的文档映射区域将在整页视图中如何显示。有效值包括：

  • Full：显示文档映射区域。

  • Collapsed：折叠文档映射区域。

  • Hidden：隐藏文档映射区域。

默认值为 Full。

DockToolBar

控制报表查看器 Web 部件的工具栏是停靠到顶部还是底部。有效值为 Top 和 Bottom。默认值为 Top。

ToolBarItemsDisplayMode

控制将显示哪些工具栏项。这是一个按位枚举值。若要包含某一工具栏项，请将该项的值添加到总值中。例如，对于非“操作”菜单，使用 rv:ToolBarItemsDisplayMode=63（或 0x3F），这是 1+2+4+8+16+32 得出的结果；对于仅“操作”菜单项，使用 rv:ToolBarItemsDisplayMode=960（或 0x3C0）。有效值包括：

  1. 1 (0x1)：“返回”按钮

  2. 2 (0x2)：文本搜索控件

  3. 4 (0x4)：页面导航控件

  4. 8 (0x8)：“刷新”按钮

  5. 16 (0x10)：“缩放”列表框

  6. 32 (0x20)：“Atom 馈送”按钮

  7. 64 (0x40)：“操作”中的“打印”菜单选项

  8. 128 (0x80)：“操作”中的“导出”子菜单

  9. 256 (0x100)：“操作”中的“使用报表生成器打开”菜单选项

  10. 512 (0x200)：“操作”中的“订阅”菜单选项

默认值为 -1，这将包含所有工具栏项。

示例

下面的示例通过将 rc:Toolbar 参数值设置为 false 隐藏 HTML 查看器工具栏：

http://<Server Name>/reportserver?/Sales/YearlySalesSummary&rs:Command=Render&rs:Format=HTML4.0&rc:Toolbar=false

下面的示例传递了一个硬编码参数并隐藏了用户提供的参数的输入字段：

http://<Server Name>/reportserver?/Sales/YearlySalesSummary&rs:Command=Render&rs:Format=HTML4.0&rc:Parameters=false&Year=2002

下面的示例使用 rc:Zoom 参数将报表的缩放属性设置为 Page Width：

http://<Server Name>/reportserver?/Sales/YearlySalesSummary&rs:Command=Render&rs:Format=HTML4.0&rc:Zoom=Page Width

下面的示例命令用于切换至报表的第 13 部分：

http://<Server Name>/reportserver?/Sales/YearlySalesSummary&rs:Command=Render&rs:ShowHideToggle=13

请参阅

参考

在 URL 中使用参数前缀

其他资源

URL 访问