共用方式為

教學課程：讀取與設定子報表的參數

  • 發行項
Note附註

為了完成本教學課程，您必須先完成上一個教學課程「教學課程：讀取與設定離散參數」。

簡介

在之前的教學課程 (「教學課程：讀取與設定離散參數」) 中，您已經學會如何建立包含參數的報表，以及如何撰寫程式碼以便在執行階段設定該參數，這兩者都具有固定寫入的參數值與從 ListBox 控制項傳來的參數值。

在此教學課程中，您將學習如何將參數加入子報表。

您必須針對在「教學課程：讀取與設定離散參數」中建立的專案進行下列四項變更：

  • 首先將子報表加入原始報表中。

    此子報表說明 Xtreme 資料庫的「訂貨主檔」資料表。「訂貨主檔」資料表會與之前教學課程中所使用的「客戶」資料表相關 (藉由「客戶編號」外部索引鍵)。

  • 然後將範圍參數加入依訂貨日期範圍篩選之子報表中。

  • 您要將兩個 Text 控制項 (orderStartDate 與 orderEndDate) 加入至表單，以在執行階段設定訂貨日期範圍。

  • 您將加入新的方法。

    此方法會建立包含 startDate 和 endDate 值的 ParameterRangeValue 執行個體，然後將 ParameterRangeValue 執行個體傳遞至子報表中的範圍參數。

完成此教學課程之後，就可以篩選執行階段時顯示在此報表上的值。您加入的程式碼會限制顯示在主報表的城市個數，並且限制子報表中要顯示的訂貨日期範圍。

您也可以使用 CrystalReportViewer 物件模型類別來完成此教學課程，不過，仍建議使用 ReportDocument 物件模型。如需物件模型用法的詳細資訊，請參閱「我應該使用哪一個物件模型？」

若要使用 CrystalReportViewer 物件模型建構此教學課程，請參閱「教學課程：讀取與設定子報表的範圍參數」。

範例程式碼

本教學課程隨附 Visual Basic 和 C# 範例程式碼，以示範專案的完成版本。請遵循這個教學課程的指示以建立新的專案，或是開啟範例程式碼專案，從完成的版本開始進行。

範例程式碼是以資料夾的形式儲存，並以語言和專案類型來加以分類。下面列出每個範例程式碼版本的資料夾名稱：

  • C# 網站：CS_Web_RDObjMod_ParametersSubrpt
  • C# Windows 專案：CS_Win_RDObjMod_ParametersSubrpt
  • Visual Basic 網站：VB_Web_RDObjMod_ParametersSubrpt
  • Visual Basic Windows 專案：VB_Win_RDObjMod_ParametersSubrpt

若要找出包含這些範例的資料夾，請參閱「教學課程的範例程式碼目錄」。

在本節中：

請參閱