ASP.NET RDLC 報表加入參數後 ReportViewer 不顯示：常見原因與排查步驟

問題現象

在 RDLC 報表設計師中新增參數後，網頁執行時 ReportViewer 控制項完全不顯示（空白），且無任何例外拋出、無錯誤訊息於 Output 視窗。

常見原因檢查清單

1. 參數名稱大小寫不一致

• RDLC 參數名稱區分大小寫，程式碼傳遞 ReportParameter("ParamName", ...) 時必須與報表定義完全相同。
• 子報表參數同理，需在父報表 SubreportProcessing 事件中正確對應。

2. 參數值為 null 或型別不符

• 傳遞 null 給非可為 null 參數會導致報表處理失敗而不顯示。
• 確認 ReportParameter 建構子的值型別（字串、整數、日期）與報表定義一致。

3. 子報表參數未正確傳遞

protected void ReportViewer1_SubreportProcessing(object sender, SubreportProcessingEventArgs e)
{
    // 必須為子報表的每個參數加入值
    e.DataSourceCredentials.Add(...); // 若有資料源憑證
    e.ReportParameters.Add(new ReportParameter("ChildParam", "Value"));
}

4. 報表資料源未重新繫結

• 加入參數後，需在 Page_Load（非 PostBack）或按鈕事件中重新設定 ReportViewer.LocalReport.DataSources 並呼叫 ReportViewer.LocalReport.Refresh()。

5. 報表伺服器模式 vs 本地模式衝突

• 若 ReportViewer.ProcessingMode = Remote，參數需透過 ServerReport.SetParameters() 傳遞，而非 LocalReport。

6. 瀏覽器快取 / ScriptManager 缺失

• 確認頁面包含 <asp:ScriptManager>。
• 清除瀏覽器快取或嘗試無痕模式。

偵錯技巧

1. 啟用 LocalReport.EnableHyperlinks = true 觀察是否有超連結錯誤。
2. 暫時移除所有參數，確認報表能正常顯示，再逐一加回參數定位問題參數。
3. 檢查 ReportViewer 的 AsyncRendering 屬性，嘗試設為 false。
4. 查看 IIS 日誌與 Windows 事件檢視器是否有 Microsoft.Reporting 相關錯誤。

快速修正範例

protected void Page_Load(object sender, EventArgs e)
{
    if (!IsPostBack)
    {
        ReportViewer1.ProcessingMode = ProcessingMode.Local;
        ReportViewer1.LocalReport.ReportPath = Server.MapPath("~/Reports/MyReport.rdlc");
        
        // 設定資料源
        var dt = GetData();
        ReportViewer1.LocalReport.DataSources.Clear();
        ReportViewer1.LocalReport.DataSources.Add(new ReportDataSource("DataSet1", dt));
        
        // 設定參數（名稱、值完全對應 RDLC 定義）
        var paramsList = new List<ReportParameter> {
            new ReportParameter("StartDate", DateTime.Now.AddDays(-7).ToString("yyyy-MM-dd")),
            new ReportParameter("EndDate", DateTime.Now.ToString("yyyy-MM-dd"))
        };
        ReportViewer1.LocalReport.SetParameters(paramsList);
        
        ReportViewer1.LocalReport.Refresh();
    }
}

總結

RDLC 加參數後 ReportViewer 空白通常源於參數名稱/值/型別不符、子報表參數未傳遞、資料源未重繫或模式設定錯誤。建議逐項對照上述清單，並善用「移除參數測試」法快速定位。