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

升級ActiveReports for .NET 3.0 項(xiàng)目

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

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

替換工程的DLL引用

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

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

修改代碼錯(cuò)誤

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

升級ActiveReports for .NET 1.0 或2.0項(xiàng)目

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

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

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

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

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

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

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

移植ActiveReports 2.0(COM)項(xiàng)目

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