grid++报表使用时注意事项

#开始使用：Grid++Report 可以在 Visual C#.Net 与 Visual Basic.Net 下的 WinForm 项目中使用。在项目中使用 Grid++Report 之前，首先必须对 Grid++Report 的引用。

在 Visual Studio.Net(2003/2005/2008/2010)中引用 Grid++Report 的过程：

首先打开或新建 Visual Studio.Net 项目。

★在‘工具箱’面板中加入 Grid++Report 对应构件：
1、在‘工具箱’面板中右击鼠标按钮打开弹出式关联菜单，执行菜单项‘添加/移除项...’，打开‘自定义工具箱’窗口。(注：VS.Net2005及以后版本的菜单项名称为‘选择项...’，窗口名为‘选择工具箱’。)
2、在‘自定义工具箱’窗口中选择‘COM’选项卡，从列表中选取对‘Grid++Report DisplayViewer 5.6’与‘Grid++Report PrintViewer 5.6’两项。 
3、执行‘确定’按钮关闭‘自定义工具箱’窗口，在‘工具箱’面板中会加入两个控件项：‘Grid++Report DisplayViewer 5.6’与‘Grid++Report PrintViewer 5.6’，此时我们可以象使用其它控件一样使用这两个控件。 
4、如果在项目中需要为用户提供运行时设计报表的功能，需要使用类似的过程加入对‘Grid++Report Designer 5.6’的引用。

★在项目中加入 Grid++Report 类型库的引用：
1、打开 ‘解决方案资源管理器’窗口，展开项目节点。 
2、在‘引用’节点上右击鼠标按钮打开弹出式关联菜单，执行菜单项‘添加引用...’，打开‘添加引用’窗口。 
3、在‘添加引用’窗口中选择‘COM’选项卡，在列表中双击‘Grid++Report Engine5.0 Type Library’项。 
4、执行‘确定’按钮关闭‘添加引用’窗口，完成添加过程。 
5、如果在项目中需要为用户提供运行时设计报表的功能，需要使用类似的过程加入对‘Grid++Report Designer5.0 Type Library’的引用。 
注：如果在设计 Form 上要加入查询显示控件或打印显示控件，上面对类型库的引用步骤可以不做，因为在控件被加入到 Form 中的时候，项目会自动加入对类型库的引用。

★关于C#与VB.NET开发兼容64位WinForm程序说明：
设置WinForm 项目的目标平台为“x86”可以保证用 Grid++ 开发的软件在64位Windows下正常运行。设置说明：
1、C#: 项目->属性->生成->目标平台->x86
2、VB.NET: 项目->属性->编译->高级编译选项...->目标CPU->x86
3、也可以在项目的配置管理器中将“Any CPU”平台去掉，增加“x86”平台。操作菜单：生成->配置管理器->活动解决方案平台，下拉选择“新建...”项可以在打开的对话框中增加“x86”平台，下拉选择“编辑...”项可以在打开的对话框中移除“Any CPU”平台。 
4、如果是在Windows7 64位或其它64位系统下开发，也一定要按以上要求设置项目的目标平台。
5、在 VS2005/2008/2010 中都通过测试，在Windows server 2008与Windows7 的 64 位系统下都可以正常发布。例子 11.CustomDesign 升级到VS2005/2008/2010 并把目标平台改为“x86”，制作出来的安装程序就可以在各种Windows系统下安装运行。

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

★关于C#与VB.NET中数据多次重复填入的问题:
原因: 挂接报表事件的代码被多次执行，因此同一事件函数被多次挂接上；在事件一次触发过程中，这个事件函数会被多次调用。如 FetchRecord 事件就会多次填入报表数据，从而造成报表数据重复。
解决方式1：移动挂接报表事件的代码的位置，让这些代码只执行一次。一般是在 From 的启动函数或事件中。如下C#与VB.NET代码：
public Form1()
{
 ...

//连接报表事件
 Report.Initialize += new _IGridppReportEvents_InitializeEventHandler(ReportInitialize);
 Report.FetchRecord = new _IGridppReportEvents_FetchRecordEventHandler(ReportFetchRecord);
 Report.GroupBegin += new _IGridppReportEvents_GroupBeginEventHandler(ReportGroupBegin);
 Report.ProcessRecord += new _IGridppReportEvents_ProcessRecordEventHandler(ReportProcessRecord);
 Report.SectionFormat += new _IGridppReportEvents_SectionFormatEventHandler(ReportSectionFormat);

...
}
Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles MyBase.Load
 ...

'连接报表事件
        AddHandler Report.Initialize, AddressOf ReportInitialize
        AddHandler Report.FetchRecord, AddressOf ReportFetchRecord
        AddHandler Report.ProcessRecord, AddressOf ReportProcessRecord
        AddHandler Report.GroupBegin, AddressOf ReportGroupBegin
        AddHandler Report.SectionFormat, AddressOf ReportSectionFormat
 
 ...
End Sub
解决方式2：在挂接事件前，先移除原来的挂接事件。如下C#与VB.NET代码：
 Report.FetchRecord -= new _IGridppReportEvents_FetchRecordEventHandler(ReportFetchRecord);
 Report.FetchRecord += new _IGridppReportEvents_FetchRecordEventHandler(ReportFetchRecord);

RemoveHandler Report.FetchRecord, AddressOf ReportFetchRecord
        AddHandler Report.FetchRecord, AddressOf ReportFetchRecord