使用 URL 访问参数
可以将下列参数作为 URL 的一部分使用来配置报表的外观。本节列出了最常用的参数。参数是区分大小写的,并且如果将其定向到报表服务器,则以参数前缀 rs: 开头,如果定向到 HTML 查看器,则以参数前缀 rc: 开头。您也可以指定特定于设备或呈现扩展插件的参数。有关特定于设备的参数的详细信息,请参阅在 URL 中指定设备信息设置。
HTML 查看器命令
下表说明了带有 rc: 前缀并用于指向 HTML 查看器的 URL 访问参数。
参数 |
操作 |
---|---|
Toolbar |
显示或隐藏工具栏。如果此参数的值为 false,将忽略所有剩余的选项。如果忽略此参数,则自动显示工具栏以呈现支持工具栏的格式。此参数的默认值为 true。 |
Parameters |
显示或隐藏工具栏的参数区域。如果将此参数设置为 true,将显示工具栏的参数区域。如果此参数设置为 false,则不显示参数区域,用户也不能显示参数区域。如果此参数设置为 Collapsed 值,则不会显示参数区域,但最终用户可以对参数区域进行切换。此参数的默认值为 true。 |
Zoom |
设置报表缩放值,缩放值以整数百分比或字符串常量表示。标准字符串值包括 Page Width 和 Whole Page。早于 Internet Explorer 5.0 的 Microsoft 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 访问呈现报表历史记录快照。 |
PersistStream |
呈现单个持久流中的报表。图像呈现器使用此参数,通过一次传输一块的方式传输呈现的报表。在 URL 访问字符串中使用此参数后,将使用相同的 URL 访问字符串,除非用 GetNextStream 参数替换了 PersistStream 参数来获取持久流中的下一个块。此 URL 命令最终将返回 0 字节流,以指明持久流结束。默认值为 false。 |
GetNextStream |
在使用 PersistStream 参数访问的持久流中获取下一个数据块。有关详细信息,请参阅 PersistStream 的说明。默认值为 false。 |
报表查看器 Web 部件命令
下表介绍了新的 SQL Server 2008 保留的报表参数名称,这些名称在 Reporting Services 与 Windows SharePoint Services (WSS) 3.0 或 MicrosoftOffice SharePoint Server (MOSS) 2007 集成时用于指向报表查看器 Web 部件。这些参数名称带有 rv: 前缀。报表查看器 Web 部件也接受 rs:ParameterLanguage 参数。
参数 |
操作 |
---|---|
Toolbar |
控制报表查看器 Web 部件的工具栏显示。默认值为 Full。可为以下值:
|
HeaderArea |
控制报表查看器 Web 部件的标头显示。默认值为 Full。可为以下值:
|
DocMapAreaWidth |
控制报表查看器 Web 部件中参数区域的显示宽度(以像素为单位)。默认值与报表查看器 Web 部件中的默认值一样。该值必须是非负整数。 |
AsyncRender |
控制是否异步呈现报表。默认值为 true,该值指定将异步呈现报表。该值必须为布尔值 true 或 false。 |
示例
下面的示例通过将 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