加入和設定 ReportViewer 控制項

您可以將一個或多個 ReportViewer 控制項執行個體加入到 Windows Form 或 ASP.NET 應用程式中，其方式是將此控制項從工具箱的 [報告] 區段拖曳到應用程式的頁面或表單中。 您可以使用智慧標籤面板和屬性來設定控制項及繫結報表。 如果您想要以程式設計方式設定此控制項，您也可以撰寫程式碼。

ReportViewer 控制項每次顯示一個報表。 如果您希望能夠並行檢視報表，您可以在相同頁面或表單上結合此控制項的多個執行個體。 您也可以使用此控制項的單一執行個體，每次主控一個報表。 若要使用單一控制項來顯示一連串報表，您必須撰寫程式碼，讓報表與您想要使用的 ReportViewer 控制項執行個體產生關聯。

ReportViewer 控制項會執行本機處理模式或遠端處理模式。

在本機處理模式中，控制項會開啟一個報表定義、處理它，然後在檢視區域中轉譯報表。 在本機處理模式中，您可以從檔案系統的 .rdlc 檔案中、從資料流中，或從應用程式的內嵌資源中，取得報表定義。 如需詳細資訊，請參閱ReportPath、LoadReportDefinition和ReportEmbeddedResource。

在遠端處理模式中，控制項會從 Reporting Services 報表伺服器中擷取已完整處理的報表。 在遠端處理模式中，所有資料處理和報表處理都是在報表伺服器執行。 遠端處理模式通常用於預先發行的報表，但是遠端處理模式也可以用於透過資料流提供的報表定義。 如需詳細資訊，請參閱LoadReportDefinition、ReportServerUrl和ReportPath。

如何加入和設定 ReportViewer 控制項

1. 將 Windows Form 或 Web Form 加入 .NET Framework 3.5 或 4.5 專案中。

2. 在圖形設計模式中，將 ReportViewer 控制項從 [工具箱] 的 [報告] 群組拖曳至 Windows Form 或 Web Form 中。 這個控制項包含一個 [ReportViewer 工作] 智慧標籤面板，供您立即選取報表。

   web.config 檔案會自動以 ReportViewer 控制項的 HTTP 處理常式更新。 如需詳細資訊，請參閱 ReportViewer 的 Web.config 設定。

   注意事項
   若要在 Web Form 中使用 ReportViewer 控制項，您也必須將 ScriptManager 控制項加入頁面中。將 ScriptManager 控制項從 [工具箱] 視窗的 [AJAX 擴充功能] 群組拖曳至 ReportViewer 控制項上方的設計介面。

3. 在 [ReportViewer 工作] 智慧標籤面板中，選取加入報表和設定控制項的工作。 指定報表會決定控制項是設定成進行本機或遠端處理。

   • 按一下 [設計新報表] 來啟動 [報表精靈]，並在應用程式內建立一份報表定義檔案 (.rdlc)。 您可以在應用程式內，建立在用戶端本機進行處理的新報表。 若要進一步了解報表建立，請參閱建立用戶端報表定義檔案 (.rdlc)。

   • 利用 [選擇報表] 來選取現有的報表定義。 您可以選擇專案所定義的本機報表定義檔案 (.rdlc)，也可以選擇 [伺服器報表] 來選取發行在 SQL Server 2008 Reporting Services 報表伺服器中的報表。

     選取伺服器報表會設定控制項進行遠端處理。 若要選取伺服器報表，您必須知道報表伺服器 URL 及報表的路徑。 在參考原生模式的報表伺服器上的報表時，報表路徑的開頭是正斜線 ( / )，而在參考 SharePoint 整合模式的報表伺服器上的報表時，報表路徑是完整 URL。 例如：

     原生模式：/Adventureworks 2008 Sample Reports/Company Sales 2008

     SharePoint 整合模式：http://MyServer/sites/MySite/MyLibrary/Adventureworks 2008 Sample Reports/Company Sales 2008.rdl

     若要執行這份報表，您必須有在報表伺服器中存取報表的權限。 如果您不知道 URL 或報表路徑，請洽詢報表伺服器管理員。 如需伺服器報表的詳細資訊，請參閱設定 ReportViewer 的遠端處理。

     選取現有的報表定義檔案 (.rdlc) 會設定控制項進行本機處理。 當選擇報表時，您必須選擇一個 .rdlc 檔；您不能指定 .rdl 檔案，即使專案中有 .rdl 檔案，也是如此。 如需詳細資訊，請參閱建立用戶端報表定義檔案 (.rdlc)。

   • 按一下 [停駐於父容器中] 來展開 ReportViewer 控制項的檢視介面，讓它使用表單或頁面中所有可用的空間。 Windows Form 控制項可以使用這個選項。

   • 按一下 [重新繫結資料來源] 來更新報表所用之資料表和商務物件的資料來源繫結。 您針對控制項來選取報表之後，便可以使用這個選項。 如果您修改了報表資料來源，或在圖形報表設計環境之外修改了資料繫結報表項目 (例如，您直接編輯 XML)，您就必須重新繫結資料來源。

4. 選取 ReportViewer 控制項，然後開啟 [屬性] 視窗。

5. 設定 ReportViewer 控制項的屬性來決定檢視區域的可見性和可用性。 請利用參考文件集來進一步了解每個屬性。 如需詳細資訊，請參閱ReportViewer 屬性。 若要了解 ReportViewer 工具列，請參閱設定和使用 ReportViewer 工具列。

6. 建立或部署應用程式，以在表單或頁面內預覽報表。

請參閱

概念

使用 [ReportViewer 工作] 智慧標籤面板

建立用戶端報表定義檔案 (.rdlc)

設定 ReportViewer 的本機處理

設定 ReportViewer 的遠端處理

ReportViewer Web 伺服器和 Windows Form 控制項

其他資源

範例和逐步解說