加入和設定 ReportViewer 控制項

發行項
05/09/2011

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

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

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

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

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

重要事項
在遠端處理模式中，您不能使用 .rdlc 檔案。遠端處理模式需要一份獲授權的 SQL Server 2008 (含) 以後版本 Reporting Services。遠端處理的用途是支援有 SQL Server Reporting Services 報表伺服器且想要結合控制項來使用這部伺服器的組織。伺服器方案提供了較好的可調整性和效能，也提供了諸如訂閱、快取和其他報表輸出格式等附加功能。如需有關遠端處理模式的詳細資訊，請參閱設定 ReportViewer 的遠端處理和部署報表和 ReportViewer 控制項。

在遠端處理模式中，您不能使用 .rdlc 檔案。遠端處理模式需要一份獲授權的 SQL Server 2008 (含) 以後版本 Reporting Services。遠端處理的用途是支援有 SQL Server Reporting Services 報表伺服器且想要結合控制項來使用這部伺服器的組織。伺服器方案提供了較好的可調整性和效能，也提供了諸如訂閱、快取和其他報表輸出格式等附加功能。如需有關遠端處理模式的詳細資訊，請參閱設定 ReportViewer 的遠端處理和部署報表和 ReportViewer 控制項。

如何加入和設定 ReportViewer 控制項

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

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

注意

若要在 Web Form 中使用 ReportViewer 控制項，您也必須將 ScriptManager 控制項加入頁面中。將 ScriptManager 控制項從 [工具箱] 視窗的 [AJAX 擴充功能] 群組拖曳至 ReportViewer 控制項上方的設計介面。
在 [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)，您就必須重新繫結資料來源。
選取 ReportViewer 控制項，然後開啟 [屬性] 視窗。
設定 ReportViewer 控制項的屬性來決定檢視區域的可見性和可用性。請利用參考文件集來進一步了解每個屬性。如需詳細資訊，請參閱ReportViewer 屬性。若要了解 ReportViewer 工具列，請參閱設定和使用 ReportViewer 工具列。
建立或部署應用程式，以在表單或頁面內預覽報表。