萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> ASP.NET 程式設計

ASP.NET Crystal Reports 程式碼動態傳遞參數欄位完整範例

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);

常見坑點與解決

  1. 參數名稱大小寫/空白必須與 .rpt 完全一致:建議在報表設計師複製參數名稱再貼上代碼。
  2. 日期型別:ParameterRangeValue 的 StartValue/EndValue 需為 DateTime,不可傳字串。
  3. 多值參數:若報表參數設為「允許多值」,需加入多個 ParameterDiscreteValue 至同一 ParameterField.CurrentValues。
  4. Viewer 重新整理:參數變更後需呼叫 viewer.RefreshReport() 或重設 ReportSource 觸發重跑。
  5. 權限:執行身分需具備報表資料來源的資料庫讀取權限。

效能提示

  • 大量報表建議啟用 ReportDocument 快取或改用 ExportToStream 直接輸出 PDF/Excel,避免 Viewer 互動開銷。
  • 參數集合建立可封裝為 ReportParameterBuilder 流式 API,提升可讀性。

掌握參數程式化傳遞,即可在 ASP.NET 中靈活整合 Crystal Reports,滿足動態篩選、多租戶報表等進階需求。

copyright © 萬盛學電腦網 all rights reserved