SharePoint 整合中的報表查看器網頁元件可程序設計性

報表檢視器 Web 組件是伺服器控制項，其包含一組公用應用程式開發介面 (API)，可讓開發人員建立自訂 SharePoint 應用程式。 您可以建立自訂 Web 組件，利用 Web 組件連接提供報表路徑和參數給報表檢視器 Web 組件。 您也可以將 Web 組件內嵌在自訂 SharePoint Web 組件頁面中，並使用公用 API 來自訂該組件。

使用自訂網頁元件 連線 報表查看器網頁元件

報表查看器網頁元件是實作 或 T:Microsoft.SharePoint.WebPartPages.IFilterValues之 SharePoint Web 組件 的連接取用IWebPartRow者。 如果將 IWebPartRow 網頁組件 (例如文件網頁組件) 放在與報表檢視器網頁組件相同的網頁組件頁面上，此網頁組件也可以提供報表路徑給報表檢視器網頁組件。 同樣地，如果將 T:Microsoft.SharePoint.WebPartPages.IFilterValues 網頁組件 (例如文字篩選或選擇篩選) 放在與報表檢視器網頁組件相同的網頁組件頁面上，此網頁組件也可以提供報表參數給報表檢視器網頁組件。

使用 IWebPartRow 實作報表路徑提供者

使用下列步驟，透過網頁元件連線提供報表查看器網頁元件的報告路徑：

1. 建立實作 IWebPartRow 介面的 Web 組件。

2. 將此 Web 組件加入至與報表檢視器 Web 組件相同的 Web 組件頁面上。

3. 在 Web 式 Web 組件設計使用者介面上，將您的 Web 組件連接到報表檢視器 Web 組件。

   注意

   您一次只能將一個 IWebPartRow 網頁組件連線到報表檢視器網頁組件，不能同時將 IWebPartRow 網頁組件和 T:Microsoft.SharePoint.WebPartPages.IFilterValues 網頁組件連線到報表檢視器網頁組件。

若要讓 IWebPartRow 網頁元件與 T：Microsoft.ReportingServices.SharePoint.UI.WebParts.ReportViewerWebPart 正常運作，您必須針對 GetRowData 方法使用下列步驟：

• 使用 DataRowView 物件當做輸入參數來叫用回撥方法。

• 確定 DataRowView 物件包含名為 "DocUrl" 的資料行 (其中包含報表路徑)。

  注意

  適用於 Office SharePoint Server 2010 的報表檢視器 Web 組件，也支援使用 "FileRef" 資料行接收報表路徑。

使用 IFilterValues 實作報表參數提供者

實作 T:Microsoft.SharePoint.WebPartPages.IFilterValues 的網頁組件可以提供一個參數值給報表檢視器網頁組件。 傳送至報表查看器網頁元件的參數值受限於報表參數上所指定的相同限制，例如數據類型、有效值等等。

使用下列步驟將報表參數提供給報表查看器網頁元件：

1. 建立實作 T:Microsoft.SharePoint.WebPartPages.IFilterValues 介面的網頁組件。

2. 將網頁組件新增至與 T:Microsoft.ReportingServices.SharePoint.UI.WebParts.ReportViewerWebPart 相同的頁面。

3. 在網頁式網頁組件設計使用者介面中，將您的 T:Microsoft.SharePoint.WebPartPages.IFilterValues 網頁組件連線到報表檢視器網頁組件。

   注意

   您可以一次將多個 T:Microsoft.SharePoint.WebPartPages.IFilterValues 網頁組件連線到報表檢視器網頁組件。 但是不能同時將 IWebPartRow 網頁組件和 T:Microsoft.SharePoint.WebPartPages.IFilterValues 網頁組件連線到報表檢視器網頁組件。