ASP.NET 2.0 RDLC 報表部署坑點總結：ReportViewer.LocalReport.Refresh 遺漏與預編譯路徑失效問題

記錄兩個 RDLC 報表開發與部署的關鍵坑點，避免重蹈覆轍。

坑點一：參數變更圖表不更新 — 遺漏 Refresh()

動態參數下圖表不重繪，根因：未呼叫 ReportViewer.LocalReport.Refresh()。每次參數變更後必須：

reportViewer.LocalReport.SetParameters(parameters);
reportViewer.LocalReport.Refresh(); // 關鍵！

坑點二：預編譯部署報表檔案找不到 — Marker 檔案機制

VS2005 Publish 預編譯 且未勾選 "Allow this precompiled site to be updatable" 時：

• .rdlc 檔案會被編譯成無內容的「Marker 檔案」
• 伺服器端找不到真實報表定義，報表無法顯示

解決方案

1. 勾選可更新：Publish 時勾選 "Allow this precompiled site to be updatable"（輕微效能影響）
2. 部署後覆蓋：發布完成後，手動將原始 .rdlc 檔案覆蓋至伺服器同路徑，替換 Marker 檔案

後者為無效能損失的最佳方案，但需納入部署腳本自動化。