自定义报表查看器 Web 部件

项目
12/15/2008

新建日期： 2006 年 12 月 12 日

您可以使用报表查看器 Web 部件查看在 SQL Server 2005 Reporting Services 报表服务器上运行的报表。可显示的报表包括报表定义 (.rdl) 文件和报表生成器报表。报表在报表查看器 Web 部件的新页面中自动打开，但如果您希望始终在某现有网页中显示特定报表，也可以将报表查看器 Web 部件添加至该网页或站点。

您可以按如下方式自定义报表查看器 Web 部件：

通过设置属性更改 Web 部件的外观。
选择报表工具栏上可用的交互式报表功能。
指定可用的视图区域。报表查看器 Web 部件包含报表视图区域、参数区域和凭据区域。

您不能将报表查看器 Web 部件扩展为支持不同文件类型，并且不能用自定义工具栏替换报表工具栏或向现有工具栏添加新功能。如果需要自定义标准功能，应创建自定义 Web 部件。

设置 Web 部件属性

Web 部件具有用于配置特定功能的自定义属性。Web 部件还具有针对所有 Web 部件的标准通用属性。

更改默认属性

报表查看器 Web 部件的默认属性最适合按照需要从库或文件夹中打开报表。默认情况下，工具栏上将显示所有可用控件，并且将高度和宽度设置为可以使用网页上的所有可用空间。如果您希望修改默认属性，可以通过**“网站设置”**自定义 Web 部件。

在**“网站操作”菜单上，单击“网站设置”**。
在“库”下，单击**“Web 部件”**。
单击 ReportViewer.dwp。
打开工具窗格并设置要使用的属性。

自定义网页中的嵌入式报表查看器

您可以设置属性以使报表查看器恰好适合网页大小。报表查看器可以使用与所在页面相同的样式与颜色。您可以隐藏全部或部分工具栏、文档结构图和参数区域以使所分配空间内的报表视图区域最大化。报表始终使用创建时为其定义的样式。在将报表发布至 SharePoint 库后，不能再自定义报表外观。

如果要将报表查看器 Web 部件嵌入网页，应将 Report URL 属性设置为特定报表。如果未设置，报表查看器将显示有关链接至报表的说明。您不能自定义或删除这些说明。

报表查看器 Web 部件的自定义属性

设置自定义属性时请注意：某些属性仅在将报表查看器 Web 部件嵌入页面时才会用到。例如，其中包括“标题”、“高度”、“宽度”、“部件版式类型”和“区域”等。无论报表查看器是显示在页面内还是以整页模式打开报表，均可以使用其他属性（例如“工具栏”设置和“参数”设置）。

下面列出了报表查看器 Web 部件的自定义属性。

属性	说明
报表	报表的 URL，为当前 SharePoint 站点上或同一 Web 应用程序或场内站点上的报表的完全限定路径。为了在设置其他属性时能够获得最佳效果，请在指定报表 URL 后单击“应用”。
超链接目标	“超链接目标”是用于指定显示当前文档内链接内容的目标框架的标准 HTML。对于钻取报表和包含指向外部网站的超链接的报表，可以指定是用目标文档替换当前窗口中的现有报表还是在新浏览器窗口中打开目标文档。有效值包括 _Top、_Blank 和 _Self。_Top 使用当前窗口，_Blank 在新浏览器窗口中加载文档，而 _Self 在当前框架内打开文档。尽管 _Parent 是 HTML 中“目标”属性的有效值，但请勿对嵌入页面的报表查看器 Web 部件使用此值。
自动生成 Web 部件标题	生成的标题中包含报表查看器 Web 部件名称和报表名称，中间用破折号分隔。如果报表没有标题，则使用报表的文件名。将 Web 部件添加到页面时，即可看到此标题。如果选中此复选框，则每次刷新页面时都会生成标题。
自动生成 Web 部件标题详细信息链接	生成的显示在 Web 部件之上的超链接。单击此链接可以在新页面中以整页模式打开报表。
工具栏	有效值包括“完整”、“无”和“导航”。“完整”可显示整个工具栏。“无”将隐藏工具栏。“导航”将只显示页导航控件，不显示缩放、刷新功能以及“操作”菜单。
参数	有效值包括“显示”、“折叠”和“隐藏”。选择“显示”可为包括参数化值的报表显示参数区域，这需要用户在运行报表之前输入参数。如果已指定所有报表参数并且不希望用户看到参数区域，请使用“隐藏”。
参数区域宽度	可以选择度量单位和值。默认值为 200 像素。对于此属性，唯一的要求是其值大于零。
文档结构图	文档结构图是在报表中定义的并用于提供对报表的特定部分进行一键式访问的报表导航控件。可在 HTML 报表中使用此控件。文档结构图显示在报表视图区域旁的可折叠区域中。有效值包括“显示”、“折叠”和“隐藏”。如果已为报表定义文档结构图，并且未在 Web 部件属性中将其选为隐藏或折叠，则默认情况下将展开此区域。如果文档结构图处于折叠状态，可以单击箭头将其展开。
文档结构图区域宽度	可以选择度量单位和值。默认值为 200 像素。对于此属性，唯一的要求是其值大于零。
加载参数	单击此按钮可以检索报表的参数属性。并非所有报表都具有参数。如果报表不具有参数，则不返回任何值。如果为刚上载的报表设置属性，可能会收到错误信息，指明数据源连接已删除。如果遇到这种情况，请重置连接并在指定连接后完成参数属性的设置。有关如何设置连接的说明，请参阅如何创建和管理共享数据源（SharePoint 集成模式）。为了达到最佳效果，请在单击“加载参数”之前单击“应用”。加载参数属性之后，可以设置它们，方法与在报表的参数属性页上进行设置相同。有关如何设置参数的详细信息，请参阅如何设置已发布报表的参数（SharePoint 集成模式）。

自定义工具栏

工具栏显示在标题下方并扩展到报表顶部。工具栏上具有**“操作”菜单，并可按页浏览分页报表、刷新和缩放。它还包括适用于具有文档结构图的报表的文档结构图控件。“操作”**菜单中包括用于导出报表、搜索报表中的文本或数字、打印报表以及在报表生成器中打开报表（适合基于模型的报表）的命令。

您不能自定义**“操作”菜单或向其添加新命令，但可以通过设置工具栏上的属性隐藏它。此外，还可以通过使“打印”命令或特定导出格式在报表服务器上不可用，将这些功能删除。页导航控件可用于具有分页符的报表；不具分页符的报表为长度可变的单页报表。“刷新”**功能可使用报表的当前参数重新处理报表。若要在一行中显示所有控件，请将 Web 部件的总体宽度设为至少 400 像素。

自定义视图区域

视图区域用于显示报表。使用参数区域和凭据区域时，它们还将与报表视图区域共存。需要凭据时，凭据区域将显示在空报表视图区域的旁边。在用户提供凭据并运行报表后，凭据区域将关闭。若要自定义提示用户设置凭据的文本，请修改数据源连接属性。有关详细信息，请参阅如何创建和管理共享数据源（SharePoint 集成模式）。

参数区域提供用于在运行报表之前输入值的字段。仅在报表定义包括参数时才使用此区域。显示参数或凭据区域时，将调整报表视图以充分利用 Web 部件的其余部分。可以通过设置 Web 部件的属性来自定义参数区域的宽度。也可以定义显示在页面上各个参数旁的标签。有关如何修改参数标签的详细信息，请参阅如何设置已发布报表的参数（SharePoint 集成模式）。

请参阅

通过