教學課程:讀取與設定離散參數
簡介
離散參數為單一的值,而範圍參數指的則是某範圍內的值。文字項目 (例如城市) 通常是透過離散參數存取。數字項目 (例如員工薪資) 通常是透過範圍參數存取。
在本教學課程中,您將學習如何設定離散參數的值來檢視以一個欄位為基礎的客戶報表。報表只會顯示居住在您從城市清單中所選取之城市的客戶。而城市清單則是從城市參數的預設值衍生而來。這些城市參數的預設值已封裝在報表中。
開始之前,您必須先以城市參數建立客戶報表。此報表的資料是從 Crystal Reports for Visual Studio 隨附的範例資料庫取得。當您產生程式碼中的報表執行個體時,您會建立包含城市名稱 (巴黎、東京) 的 ArrayList,並會將 ArrayList 執行個體傳遞到將前述城市名稱設為城市參數目前值的 Helper 方法。接著,您再將報表繫結到 CrystalReportViewer 控制項,並檢視只具有住在巴黎及東京客戶的報表。
在本教學課程的下個部分,您將執行下列動作:
- 建立會取得所有預設值,並將值以 ArrayList 傳回的方法。
- 將 ListBox 控制項加入表單,並依據 ArrayList 填入表單。
- 加入 Button 控制項,依據 ListBox 選擇重新顯示報表。
在教學課程的最後一部分中,您會撰寫按一下按鈕事件的程式碼,以從 ListBox 控制項擷取任何選取的項目,並將它們設成城市參數的目前值。報表將重新顯示,且只會顯示居住在您於 ListBox 控制項內所選取之城市的客戶。
您也可以使用 CrystalReportViewer 物件模型類別來完成此教學課程,不過,仍建議使用 ReportDocument 物件模型。如需有關要使用哪一個物件模型的詳細資訊,請參閱「我應該使用哪一個物件模型?」
若要使用 CrystalReportViewer 物件模型來建置此教學課程,請參閱「教學課程:登入安全 SQL Server 資料庫」。
範例程式碼
本教學課程隨附 Visual Basic 和 C# 範例程式碼,以示範專案的完成版本。請遵循這個教學課程的指示以建立新的專案,或是開啟範例程式碼專案,從完成的版本開始進行。
範例程式碼是以資料夾的形式儲存,並以語言和專案類型來加以分類。下面列出每個範例程式碼版本的資料夾名稱:
- C# 網站:CS_Web_RDObjMod_Parameters
- C# Windows 專案:CS_Win_RDObjMod_Parameters
- Visual Basic 網站: VB_Web_RDObjMod_Parameters
- Visual Basic Windows 專案:VB_Win_RDObjMod_Parameters
若要找出包含這些範例的資料夾,請參閱「教學課程的範例程式碼目錄」。