Crystal Reports for Visual Studio 常需在執行期動態指定參數值 (如報表篩選條件、使用者代碼)。本文示範如何以 ParameterFields、ParameterField、ParameterDiscreteValue、ParameterRangeValue 建立參數集合並指派給 CrystalReportViewer,涵蓋單一離散值、多重離散值、區間值三種常見類型。
ParameterFields (集合)
└─ ParameterField (單一參數定義)
├─ ParameterFieldName (對應 .rpt 參數名稱)
├─ CurrentValues (ParameterValues 集合)
│ ├─ ParameterDiscreteValue (單一值)
│ └─ ParameterRangeValue (範圍值: StartValue/EndValue)
└─ HasCurrentValue (唯讀)
private void BindReportParameters(CrystalReportViewer viewer, string customerId, DateTime startDate, DateTime endDate) {
var paramFields = new ParameterFields();
// 1. 字串離散值參數:客戶代碼 (可多值)
var paramCust = new ParameterField { ParameterFieldName = "CustomerId" };
paramCust.CurrentValues.Add(new ParameterDiscreteValue { Value = customerId });
// 若支援多選:paramCust.CurrentValues.Add(new ParameterDiscreteValue { Value = "C002" });
paramFields.Add(paramCust);
// 2. 日期區間參數:訂單日期範圍
var paramDate = new ParameterField { ParameterFieldName = "OrderDateRange" };
paramDate.CurrentValues.Add(new ParameterRangeValue {
StartValue = startDate,
EndValue = endDate,
LowerBoundType = RangeBoundType.Inclusive,
UpperBoundType = RangeBoundType.Inclusive
});
paramFields.Add(paramDate);
// 3. 整數離散值:狀態代碼
var paramStatus = new ParameterField { ParameterFieldName = "StatusCode" };
paramStatus.CurrentValues.Add(new ParameterDiscreteValue { Value = 1 }); // 1=已出貨
paramFields.Add(paramStatus);
// 指派給 Viewer
viewer.ParameterFieldInfo = paramFields;
viewer.ReportSource = Server.MapPath("~/Reports/OrderList.rpt");
}
public void SetSingleParameter(CrystalReportViewer viewer, string paramName, object value) {
var fields = new ParameterFields();
var field = new ParameterField { ParameterFieldName = paramName };
field.CurrentValues.Add(new ParameterDiscreteValue { Value = value });
fields.Add(field);
viewer.ParameterFieldInfo = fields;
}
// 呼叫
SetSingleParameter(crystalReportViewer1, "ARC_I_ID", orderId);
ParameterRangeValue 的 StartValue/EndValue 需為 DateTime,不可傳字串。ParameterDiscreteValue 至同一 ParameterField.CurrentValues。viewer.RefreshReport() 或重設 ReportSource 觸發重跑。ReportDocument 快取或改用 ExportToStream 直接輸出 PDF/Excel,避免 Viewer 互動開銷。ReportParameterBuilder 流式 API,提升可讀性。掌握參數程式化傳遞,即可在 ASP.NET 中靈活整合 Crystal Reports,滿足動態篩選、多租戶報表等進階需求。