ActiveReports for .NET 6.0是報表控件ActiveReports的最新版本，在豐富報表設(shè)計功能的同時，還增加了Visual Studio 2010支持、Flash報表瀏覽器、水晶報表文件轉(zhuǎn)換、PDF文件輸出、可再分發(fā)的最終用戶報表設(shè)計器等一系列新特性。如果現(xiàn)有的項目基于ActiveReports的舊版本開發(fā)，但現(xiàn)在希望使用ActitveReports for .NET 6.0的新功能，就需要把現(xiàn)有的項目升級到6.0上。ActiveReports 6.0提供了一些方便的工具和方法幫助現(xiàn)有用戶平滑升級。

升級ActiveReports for .NET 3.0 項目

如果現(xiàn)在的項目使用的是ActiveReports for .NET 3.0，那么有兩種升級方式：

• 一是使用ActiveReports 6.0附帶的轉(zhuǎn)換工具（參見下面“升級ActiveReports for .NET 1.0 或2.0項目”）；
• 二是在Visual Studio中打開工程，用新版本的DLL替換掉舊版本的DLL引用，并且修改代碼的編譯錯誤。

替換工程的DLL引用

• 在Visual Studio中打開需要升級的報表工程。
• 在解決方案資源管理器中，點擊“顯示所有文件”按鈕。

• 展開“引用”文件夾，記錄下來工程中當(dāng)前引用的ActiveReports DLL的名字。
• 右鍵點擊每個 ActiveReports3引用，選擇“移除”。
• 右鍵點擊“引用”文件夾，選擇“添加引用…”。
• 在彈出的添加引用對話框中，選擇版本為6.x.xxx.x 的ActiveReports引用。注意，除了與ActiveReports3對應(yīng)的ActiveReport6引用外，還需要添加GrapeCity ActiveReports Document引用。
• 點擊“確定”按鈕增加這些引用并關(guān)閉對話框。許多錯誤出現(xiàn)在Visual Studio的錯誤列表窗口。

修改代碼錯誤

• 如果Visual Studio的錯誤列表窗口沒有顯示出來，在視圖的下拉式菜單中選擇“錯誤列表”。
• 在錯誤列表窗口中，雙擊ActiveReports3沒有被定義的警告信息。
• 在報表代碼中，ActiveReports3被高亮顯示。把ActiveReports3 改為ActiveReport，這樣應(yīng)該可以消除錯誤列表中的大部分錯誤。
• 在錯誤列表窗口中，雙擊ActiveReports3.FetchEventArgs沒有被定義的警告信息。
• 在報表代碼中，把ActiveReports3 改為ActiveReport。
• 關(guān)閉報表的設(shè)計視圖并再次打開，升級完成。

升級ActiveReports for .NET 1.0 或2.0項目

　　因為ActiveReports 6用C#或Visual Basic.NET代碼描述報表布局，用ActiveReports for .NET 1.0和2.0生成的RPX文件需要被轉(zhuǎn)換后才能在新版本上運行。ActiveReports 6包含了一個轉(zhuǎn)換工具來幫助用戶輕松完成此轉(zhuǎn)換。

　　注意，轉(zhuǎn)換工具不支持使用了報表繼承的1.0或2.0報表。為轉(zhuǎn)換這些報表，需要先執(zhí)行如下操作：

• 把繼承報表對象的基類改為ActiveReport
• 確認(rèn)報表對象的InitializeReport方法能夠被重載。

　　ActiveReports從NET 3.0版本開始改變了控件命名規(guī)則。在1.0和2.0版本中，控件的名稱可以用大小寫區(qū)分，比如可以用”Test”和”test”表示兩個不同的控件，但ActiveReports 6（和3）要求控件的名稱必須是唯一的且不區(qū)分大小寫。如果裝載的RPX文件中包含兩個僅用大小寫區(qū)分名字的控件，裝載將會失敗。為了避免此問題，需要給每個控件一個單獨的名字，并且把代碼做相應(yīng)修改。

運行轉(zhuǎn)換工具轉(zhuǎn)換老版本的RPX文件：

• 在Visual Studio中打開現(xiàn)有的ActiveReports for .NET 1.0 或2.0工程，報表RPX文件將出現(xiàn)在解決方案資源管理器中。
• 在工具菜單下，選擇 Convert to ActiveReports 6.0 打開ActiveReport報表轉(zhuǎn)換工具，轉(zhuǎn)換工具會列出工程中的所有RPX文件。

• 點擊OK轉(zhuǎn)換報表文件。報表會以C#或者VB文件的形式出現(xiàn)在解決方案資源管理器中，所有ActiveReports老版本的引用也已經(jīng)被更新。
• 如果項目代碼中使用了rpt.Show方法，錯誤信息將會出現(xiàn)在錯誤列表窗口中。為修正次錯誤，用rpt.Run 代碼替代，然后增加一個Viewer control到Form上，并且設(shè)置viewer.Document = rpt.Document。

移植ActiveReports 2.0(COM)項目

　　ActiveReports 6 能夠使用ActiveReports 2.0 (COM) 的報表布局文件(RPX)，但需要對其中的腳本代碼進(jìn)行一些修改。必須在ActiveReports 2.0設(shè)計器中先把ActiveReports 2.0 的設(shè)計文件(DSR/DSX)保存為RPX文件，然后才能被裝載到ActiveReports 6當(dāng)中。因為ActiveReports不會裝載RPX文件中的VB代碼或腳本代碼，這些代碼需要用.NET環(huán)境中的相應(yīng)語言進(jìn)行重寫。