.NET 程序下锐浪报表 (Grid++ Report) 的绿色发布指南

.NET 程序下锐浪报表 (Grid++ Report) 的绿色发布指南

在锐浪报表官方为 CSharp 编写的开发文档：“在C#与VB.NET中开始使用说明.txt” 中，关于发布项目是这么描述的：

★发布你的项目，用VS.NET制作安装程序：
1、先创建安装项目：在解决方案资源管理器的根节点上点右键，在弹出的菜单里执行“添加->新建项目…”，创建一个“安装项目”。
2、加入项目发布文件：在解决方案资源管理器的新创建的安装项目节点上点右键，在弹出的菜单里执行“添加->项目输出…”，在打开的窗口里选择“主输出”，这样可以把程序的发布文件自动加入到安装项目中。
3、设置Grid++Report的DLL文件为COM自注册：分别设置“gregn6.dll”与“grdes6.dll”的“Register”属性为“vsdrfCOMSelfReg”。

C:\Grid++Report 6\Samples\CSharp\在C#与VB.NET中开始使用说明.txt

这种方式需要我们在运行程序之前将 Grid++Report 依赖的 COM 组件注册到操作系统中。有没有办法可以做到绿色发布呢？

以 C:\Grid++Report 6\Samples\CSharp\1.Tutorial\PrintReport\PrintReport.sln 项目为例，我们对项目进行改造，使其支持绿色发布（ xcopy-deploy）：

1. 在项目中增加 Files 文件夹
2. 将项目依赖的数据文件 1a.简单表格.grf 和 Northwind.mdb 复制到 Files 文件夹，并设置文件属性 “复制到输出目录” 为 “始终复制”。
3. 将 C:\Grid++Report 6\ 目录下的 “gregn6.dll”与“grdes6.dll” 复制到项目中，并设置文件属性 “复制到输出目录” 为 “始终复制”。

做完以上三步，解决方案管理器看上去应该是这个样子：（笔者对源文件进行了一些改动，并将 Form1 重命名为了 FrmMain 。）

接着，对代码进行改造，使其从程序所在目录读取数据，而不是 Grid++Report 的安装目录：

        public FrmMain() { // // Windows 窗体设计器支持所必需的 // InitializeComponent(); // // TODO: 在 InitializeComponent 调用后添加任何构造函数代码 // //载入报表模板文件，必须保证 Grid++Report 的安装目录在‘C:\Grid++Report 6’下， //关于动态设置报表路径与数据绑定参数请参考其它例子程序 var dir = Path.Combine(AppDomain.CurrentDomain.BaseDirectory, "Files"); Report.LoadFromFile(Path.Combine(dir, "1a.简单表格.grf")); Report.DetailGrid.Recordset.ConnectionString = @"Provider=Microsoft.Jet.OLEDB.4.0;" + @"User ID=Admin;Data Source=" + Path.Combine(dir, "Northwind.mdb"); }

如果你在电脑中安装了最新版的 Grid++Report ，那么你会有以下目录：C:\Grid++Report 6\manifest

本目录下的两个 .manifest 文件为Grid++Report的发布DLL的清单模板文件，利用这两个文件并适当调整可以实现免DLL注册发布用Grid++Report开发的软件，实现绿色发布。
更详细说明请参考帮助文档的“报表组件(C/S报表)->发布软件->免注册发布(推荐方式)”部分。
YourX86.exe.manifest：32位程序清单文件模板
YourX64.exe.manifest：64位程序清单文件模板

C:\Grid++Report 6\manifest\readme.txt

在项目中添加一个新建项 “应用程序清单文件”：

之后需要打开 YourX86.exe.manifest 文件，并将两个 file 标签的内容复制到项目的 app.manifest 文件中。这个操作完成后，app.manifest 的代码如下：

xml version="1.0" encoding="utf-8"?>  manifestVersion="1.0" xmlns="urn:schemas-microsoft-com:asm.v1">  version="1.0.0.0" name="MyApplication.app"/>  xmlns="urn:schemas-microsoft-com:asm.v2">   xmlns="urn:schemas-microsoft-com:asm.v3">   level="asInvoker" uiAccess="false" />     xmlns="urn:schemas-microsoft-com:compatibility.v1">                    name="grdes6.dll">  tlbid="{c5a16330-a084-48c9-bc0f-0d0b37a14123}" version="6.0" helpdir="" resourceid="0" flags="HASDISKIMAGE" />  clsid="{6edd80cb-9f08-4c71-b406-479e5cb80fce}" threadingModel="Apartment" tlbid="{c5a16330-a084-48c9-bc0f-0d0b37a14123}" progid="grdes.GRDesigner.6" description="Grid++Report Designer 6" />   name="gregn6.dll">  tlbid="{4018f953-1bfe-441e-8a04-dc8ba1ff060e}" version="6.0" helpdir="" resourceid="0" flags="HASDISKIMAGE" />  clsid="{f9364159-6aed-4f9c-8baf-d7c7ed6160a8}" threadingModel="Apartment" tlbid="{4018f953-1bfe-441e-8a04-dc8ba1ff060e}" progid="gregn.GridppReport.6" description="GridppReport Class" />  clsid="{1b5ea181-a38d-4f42-88b2-6af74cf6d6c0}" threadingModel="Apartment" tlbid="{4018f953-1bfe-441e-8a04-dc8ba1ff060e}" progid="gregn.GRDisplayViewer.6" description="Grid++Report DisplayViewer 6" />  clsid="{7fd5dc62-ded0-4138-9c48-55f0a0fe7b66}" threadingModel="Apartment" tlbid="{4018f953-1bfe-441e-8a04-dc8ba1ff060e}" progid="gregn.GRDisplayViewerProps.6" description="GRDisplayViewerProps Class" />  clsid="{44cbb5de-5afb-4c3d-8f3f-0f70ca5372ad}" threadingModel="Apartment" tlbid="{4018f953-1bfe-441e-8a04-dc8ba1ff060e}" progid="gregn.GRPrintViewer.6" description="Grid++Report PrintViewer 6" />  clsid="{6ca58cb2-2ad1-4ad0-b3cc-5f5c000bbdee}" threadingModel="Apartment" tlbid="{4018f953-1bfe-441e-8a04-dc8ba1ff060e}" progid="gregn.GRPrintViewerProps.6" description="GRPrintViewerProps Class" />  

至此，我们就可以在不注册 COM 组件的情况下使用 Grid++Report 了。

本文所涉及的代码可以在 Gitee 上找到： https://gitee.com/coderbusy/demo/tree/master/gridpp_xcopy 。