使用VCSharp.net开发BOS插件

    如何使用VC#.net 开发BOS插件

技术支持看到这个问题http://dev.kingdee.com/ask/question.php?qid=4086　，稍稍研究了一下，然后有这篇总结。

这里的BOS插件是指传统的、VB的、GUI版本的BOS，不是指eBOS。VB能否开发eBOS的插件，我不清楚；不过VC#.net肯定是可以开发BOS插件的。

 

以下以BOS单据插件为例讲解。我使用的开发环境是VS2005 SP1英文版，其他版本设置可能稍有不同，可摹拟得之。步骤如下：

 

1、  新建VC# Class Library 工程：

2、 添加相关引用

添加COM组件K3ClassEvents，会自动引用它所依赖的KFO和ADODB。然后再手工添加System.Windows.Forms。 在程序开头加上：

using System.Runtime.InteropServices; //for com interop using System.Windows.Forms; //for MessageBox

3、 然后修改类属性：

[ClassInterface(ClassInterfaceType.AutoDual)] public class BillPlugin

{ }

4、 在用VB开发BOS插件时，我们必须在类模块中添加一个成员变量 m_oBillInterface，用于保存插件接口

对象；必须在类模块中添加一个公开的成员函数Show，供BOS初始化插件调用。在C#.net中开发插件时，要做同样的处理。代码如下：

[ClassInterface(ClassInterfaceType.AutoDual)] public class BillPlugin {

public void Show(object o) { try {

m_BillInterface = (K3ClassEvents.BillEvent)o; MessageBox.Show(\); }

catch(Exception e) {

MessageBox.Show(\); } }

K3ClassEvents.BillEvent m_BillInterface;

}

上述代码一看就懂，就不解释了。

5、 下一步我们要让插件响应BOS单据的事件。添加如下代码：

上面响应了菜单点击事件(MenuBarClick)与单元格值更改事件(Change)。跟.net对系统事件的处理完全一样。 在_MenuBarClick事件中，如果检测到点击的菜单项是“计算器”，就弹出一个对话框。 在_Change事件中，显示字段名称、修改的行号、字段保存值。 你可以在这里加入其他事件处理过程，项目中需要什么就加什么。

VS2005非常智能，当我输入m_BillInterface.MenuBarClick = new K3ClassEvents. 并选中事件之后，按两次Tab键就会跳出后面的事件处理器名称与参数列表，并给出相应的函数声明。这样连我这个.net菜鸟都能快速写出上面的代码来！什么时候VC也有这样的功能啊，可怜我总是要一行行手写接口啊。

6、 然后修改工程属性。要修改的地方有两处：

一是Build 下面的 Register for COM interop，要打上勾；

二是Application的Assembly Information…中的 Make assembly COM-Visible选项，要打上勾。

这一步很重要，如果不做这个设置的话，VB就无法调用.net的类库。保存设置以后，就可以编译生成.dll了。

7、 现在大功即将告成，不过行百里者半九十，我们立即测试一下。打开BOS IDE，新建单据，添加字段，

指定插件为NetPluginTest.BillPlugin(我的工程名称为NetPluginTest，类名为BillPlugin)，保存模板，F5运行，点工具栏的“计算器”，或修改任何字段的值，应该就可以看到效果了。

如果不能，嘿嘿嘿嘿嘿，我也不知道为啥，问我没用，自己研究吧！

8、 其他事项： 首先，上面的插件在我的机器上运行是很慢的，尤其是调试的时候。 其次，.net的程序需要.net framework runtime 支持，如果目标机器上没有装正确版本的.net运行时的话，插件当然是跑不起来的。而且上面也没有研究部署的问题，我的意思是，安装插件到客户机器上的时候，是否要注册到GAC什么的，这个问题需要你自己搞定。另外，这样生成的代码对K3ClassEvents的版本是否有依赖？K3ClassEvents升级后，本插件是否仍然可用？这个需要测试。因为我不懂.net，所以无法给你答案。上面的示例，目前来说仅供研究，风险自负。 最后，.net实在是方便、好用、够强大，连我这个从来没摸过.net的人，都可以花1.5小时研究出插件写法、编出代码并测试过，聪明的、精通.net的你肯定更不在话下啦！

using System;
using System.Collections.Generic;
using System.Text;
using System.Runtime.InteropServices;   //for com interop
using System.Windows.Forms;             //for MessageBox


namespace NetPlugInTest
{
    [ClassInterface（ClassInterfaceType.AutoDual）]
    public class BillPlugin
    {
        public void Show（object o）
        {
            try {
                m_BillInterface = （K3ClassEvents.BillEvent）o;
                m_BillInterface.MenuBarClick += new 
                    K3ClassEvents.__BillEvent_MenuBarClickEventHandler（m_BillInterface_MenuBarClick）;
                m_BillInterface.Change += new 
                    K3ClassEvents.__BillEvent_ChangeEventHandler（m_BillInterface_Change）;
                MessageBox.Show（“I‘m in.“）;
            }
            catch（Exception e）
            {
                MessageBox.Show（“Invalid interface.“）;
            }

        }

        void m_BillInterface_Change（KFO.Dictionary dct 
                  

 属性            大小     日期    时间   名称
----------- ---------  ---------- -----  ----
     目录           0  2009-09-23 16:23  NetPlugInTest\
     目录           0  2009-09-23 16:23  NetPlugInTest\NetPlugInTest\
     目录           0  2009-09-23 16:23  NetPlugInTest\NetPlugInTest\Properties\
     文件        1396  2009-09-23 16:31  NetPlugInTest\NetPlugInTest\Properties\AssemblyInfo.cs
     文件        1945  2009-09-24 10:13  NetPlugInTest\NetPlugInTest\Class1.cs
     文件        3609  2009-09-23 17:01  NetPlugInTest\NetPlugInTest\NetPlugInTest.csproj
     目录           0  2009-09-23 16:23  NetPlugInTest\NetPlugInTest\bin\
     目录           0  2009-09-23 16:23  NetPlugInTest\NetPlugInTest\bin\Debug\
     文件       16384  2009-09-23 17:46  NetPlugInTest\NetPlugInTest\bin\Debug\NetPlugInTest.dll
     文件       13824  2009-09-23 17:46  NetPlugInTest\NetPlugInTest\bin\Debug\NetPlugInTest.pdb
     文件       73728  2009-09-23 16:27  NetPlugInTest\NetPlugInTest\bin\Debug\Interop.ActiveBarLibrary.dll
     文件      901120  2009-09-23 16:27  NetPlugInTest\NetPlugInTest\bin\Debug\Interop.K3ClassEvents.dll
     文件       40960  2009-09-23 16:27  NetPlugInTest\NetPlugInTest\bin\Debug\Interop.KFO.dll
     文件        2280  2009-09-23 17:46  NetPlugInTest\NetPlugInTest\bin\Debug\NetPlugInTest.tlb
     目录           0  2009-09-23 16:23  NetPlugInTest\NetPlugInTest\obj\
     目录           0  2009-09-23 16:23  NetPlugInTest\NetPlugInTest\obj\Debug\
     目录           0  2009-09-23 16:23  NetPlugInTest\NetPlugInTest\obj\Debug\TempPE\
     文件       40960  2009-09-23 16:27  NetPlugInTest\NetPlugInTest\obj\Debug\Interop.KFO.dll
     文件       73728  2009-09-23 16:27  NetPlugInTest\NetPlugInTest\obj\Debug\Interop.ActiveBarLibrary.dll
     文件       49152  2009-09-23 16:27  NetPlugInTest\NetPlugInTest\obj\Debug\Interop.VBRUN.dll
     文件       10752  2009-09-23 16:27  NetPlugInTest\NetPlugInTest\obj\Debug\Interop.VBA.dll
     文件      901120  2009-09-23 16:27  NetPlugInTest\NetPlugInTest\obj\Debug\Interop.K3ClassEvents.dll
     文件         966  2009-09-23 16:27  NetPlugInTest\NetPlugInTest\obj\Debug\NetPlugInTest.csproj.ResolveComReference.cache
     文件       16384  2009-09-23 17:46  NetPlugInTest\NetPlugInTest\obj\Debug\NetPlugInTest.dll
     文件       13824  2009-09-23 17:46  NetPlugInTest\NetPlugInTest\obj\Debug\NetPlugInTest.pdb
     文件        1025  2009-09-23 17:46  NetPlugInTest\NetPlugInTest\obj\NetPlugInTest.csproj.FileListAbsolute.txt
     文件         544  2009-09-23 17:46  NetPlugInTest\NetPlugInTest\obj\NetPlugInTest.csproj.UnmanagedRegistration.cache
     文件         313  2009-09-23 17:19  NetPlugInTest\NetPlugInTest\NetPlugInTest.csproj.user
     文件         928  2009-09-23 16:23  NetPlugInTest\NetPlugInTest.sln
     文件       14336  2009-09-24 10:14  NetPlugInTest\NetPlugInTest.suo
     文件      117760  2009-09-24 12:09  使用VCSharp.net开发BOS插件.doc
............此处省略0个文件信息