更新及重新繫結資料來源參考 (Visual Studio 報表設計工具)

  • 發行項

ReportViewer 控制項和用戶端報表定義檔案 (.rdlc) 都含有關於提供資料給報表之資料來源的參考。如果您轉換報表定義，新增或刪除資料集，或修改報表所用的資料集，您必須更新所有資料來源參考和繫結，之後，才能部署或執行應用程式。

ReportViewer 控制項和報表所用的資料來源參考概觀

控制項和報表使用資料來源資訊的方式有許多。首先，報表定義會利用內嵌的結構描述資訊來建立報表配置項目和最後會合併到配置內之資料的關聯性。其次，ReportViewer 控制項需要資料來源繫結，以便您在執行階段將資料傳給它。

在執行階段，所有繫結和資料來源資訊都必須同步，報表才能包含您預期的資料。在整個開發周期中，當您修改應用程式所用的報表和資料集時，系統提供了許多選項來協助您維持資料來源資訊的同步。下列清單是不同可用選項的摘要：

  • 利用 [ReportViewer 工作] 智慧標籤面板中的 [選擇資料來源] 工作，將資料來源繫結到從伺服器報表定義檔案 (.rdl) 轉換來的用戶端報表定義檔案 (.rdlc)。

  • 利用 [ReportViewer 工作] 智慧標籤面板中的 [重新繫結資料來源] 工作，使控制項和報表定義與修改的資料集同步。

  • 利用 [報表] 功能表的 [報表資料來源] 對話方塊來更新報表定義檔案所儲存的結構描述資訊。當您在圖形設計模式中編輯用戶端報表定義檔案 (.rdlc) 時，可以使用 [報表] 功能表。

更新報表定義中的資料來源參考

報表定義包括定義報表所用的資料來源結構之資料集元素。在報表設計期間，會將資料集元素加入報表定義中。您每次將特定欄位拖曳至報表中的資料區域或文字方塊時，都會加入新元素。

如果您在有不同資料來源的專案之間複製報表定義檔案，或您修改了專案所用的資料集，就必須更新報表定義。如果您後來又移動或重新命名欄位或資料表來修改專案中實際的資料集，報表定義就不再包含有效的參考。若要更新報表定義，請依照下列步驟所說明來使用 [資料來源] 對話方塊。

如何更新報表定義中的參考

  1. 在圖形設計模式中，開啟用戶端報表定義檔案 (.rdlc)。

  2. 從 [報表] 功能表中，選取 [資料來源]。此時會出現 [報表資料來源] 對話方塊。您可以使用下列選項：

    • 若要將新的資料集加入報表定義中，請選取一個專案資料來源，按一下 [加入報表]。在大部份情況下，都不需要這個選項。當您將欄位拖曳至報表配置中，專案資料來源會自動加入報表定義中。

    • 若要從報表定義中移除現有的資料集參考，請選取資料集，再按一下 [移除]。

    • 如果您在專案中重新命名資料集，您可以利用 [報表資料來源] 對話方塊來更新報表定義中的資料集名稱。請按一下 [重新命名] 按鈕來設定資料集名稱覆寫模式，再輸入新名稱。

  3. 按一下 [全部重新整理]，利用您的變更來更新報表定義檔案。

將資料來源重新繫結到 ReportViewer 控制項

ReportViewer 控制項需要資料繫結，以便在執行階段存取應用程式資料來源。您在選取用戶端報表定義檔案 (.rdlc) 時，建立控制項的資料繫結。

如果您修改已繫結到控制項的報表定義、在控制項繫結到表單或網頁之後修改資料集，或在報表中加入新的資料集，就必須重新繫結資料來源。所有這些狀況都會使繫結過期。請利用 [ReportViewer 工作] 智慧標籤面板中的 [重新繫結資料來源] 工作來更新應用程式碼中的資料繫結。

Note附註

並非報表定義的所有修改都需要重新繫結資料來源。在多個資料區域中重新排列項目、將項目格式化或重複使用相同的資料繫結欄位，都是不會使現有資料繫結失效的修改範例。同樣地，如果您修改報表並不使用的資料來源部份，您就不需要更新繫結。

如何重新繫結資料來源

  1. 開啟包含 ReportViewer 控制項的表單或網頁。

  2. 在 [ReportViewer 工作] 智慧標籤面板中，按一下 [重新繫結資料來源]。您可以視察在表單或頁面後面的程式碼來確認變更。

選擇 ReportViewer 控制項的資料來源

當您將伺服器報表定義檔案 (.rdl) 轉換成用戶端報表定義 (.rdlc) 時，您必須確定您的應用程式包括 ReportViewer 控制項的資料繫結程式碼。當您從報表範本建立 .rdlc 檔時，會自動產生資料繫結程式碼。不過，如果您利用其他方式來建立 .rdlc 檔，就會遺漏資料繫結程式碼。若要新增資料繫結程式碼，請利用 [ReportViewer 工作] 智慧標籤面板中的 [選擇資料來源] 工作。若要進一步了解報表定義的轉換，請參閱轉換 RDL 和 RDLC 檔。

如何新增資料來源繫結

  1. 開啟包含 ReportViewer 控制項的表單或網頁。

  2. 在 [ReportViewer 工作] 智慧標籤面板中，按一下 [選擇資料來源]。您可以視察在表單或頁面後面的程式碼來確認變更。

另請參閱

概念

建立用戶端報表定義檔案 (.rdlc)
建立報表的資料來源
使用 [ReportViewer 工作] 智慧標籤面板
設定 ReportViewer 的本機處理