SharePoint 集成中的报表查看器 Web 部件可编程性

  • 项目

报表查看器 Web 部件是一个 ReportViewerWebPart 服务器控件，其中包含一组公共应用程序编程接口 (API)，使开发人员能够创建自定义 SharePoint 应用程序。 您可以创建自定义 Web 部件，以使用 Web 部件连接向报表查看器 Web 部件提供报表路径和参数。 还可以在自定义 SharePoint Web 部件页中嵌入 Web 部件，并使用该公共 API 对其进行自定义。

使用自定义 Web 部件连接到报表查看器 Web 部件

报表查看器 Web 部件是实现 IWebPartRow 或 IFilterValues 的 SharePoint Web 部件的连接使用者。 当将 IWebPartRow Web 部件（如**“文档”** Web 部件）放在与报表查看器 Web 部件所在的相同 Web 部件页上时，它可以向报表查看器 Web 部件提供报表路径。 同样，将 IFilterValues Web 部件（如**“文本筛选器”或“选择筛选器”**）放在与报表查看器 Web 部件所在的相同 Web 部件页上时，它可以向报表查看器 Web 部件提供报表参数。

使用 IWebPartRow 实现报表路径访问接口

若要通过 Web 部件连接向报表查看器 Web 部件提供报表路径，请执行以下操作：

  1. 创建一个实现 IWebPartRow 接口的 Web 部件。

  2. 将 Web 部件添加到与报表查看器 Web 部件所在的相同 Web 部件页。

  3. 在基于 Web 的 Web 部件设计用户界面中将 Web 部件连接到报表查看器 Web 部件。

    注意注意

    一次只能将一个 IWebPartRow Web 部件连接到报表查看器 Web 部件，并且不能同时将一个 IWebPartRow Web 部件和一个 IFilterValues Web 部件连接到报表查看器 Web 部件。

若要使您的 IWebPartRow Web 部件可以正确地使用 ReportViewerWebPart，必须在 GetRowData(RowCallback) 方法中完成下列操作：

  • 使用 DataRowView 对象作为输入参数调用回调方法。

  • 确保 DataRowView 对象包含一个名为“DocUrl”的列，该列包含报表路径。

    注意注意

    Office SharePoint Server 2010 的外接程序中的报表查看器 Web 部件还支持使用“FileRef”列来接收报表路径。

使用 IfilterValues 实现报表参数访问接口

一个实现 IFilterValues 的 Web 部件可以向报表查看器 Web 部件提供一个参数值。 发送到报表查看器 Web 部件的参数值可能会受到与在报表定义中指定的报表参数相同的限制，如数据类型、有效值等。

若要向报表查看器 Web 部件提供报表参数，请执行以下操作：

  1. 创建一个实现 IFilterValues 接口的 Web 部件。

  2. 将此 Web 部件添加到与 [T:Microsoft.ReportingServices.SharePoint.UI.WebParts.ReportViewerWebPart.] 所在的相同页。

  3. 在基于 Web 的 Web 部件设计用户界面中，将您的 IFilterValues Web 部件连接到报表查看器 Web 部件。

    注意注意

    可以同时将多个 IFilterValues Web 部件连接到报表查看器 Web 部件。 但是，不能同时将 IWebPartRow Web 部件和 IFilterValues Web 部件连接到报表查看器 Web 部件。