用C#写COM组件

 
 
说明:

我是一个C#程序员,但是有一次一个需求只能用C/C++去写,恰好需要读取的数据存放在DB(SQL CE v3)里面,而我又不会C/C++(关键是用OleDB访问DB,这个实在是繁琐),所以催生了用C#写一个COM组件,用C/C++去调用的想法.可谓,很傻很天真.但是也是一种思路,如果MS提供C API的话,问题就简单多了.可是事实是,MS自己的.NET CF用着C API,给用户却暴露着COM API.....OK,言归正传.

 

主要内容:

用C#创建一个简单的COM组件(通过COM Interop)
用VC++写一个客户端去访问COM组件.客户端用TLB文件.
本着易于使用的目的,我把Northwind导入到了SQLServer,然后测试了我的代码.(the sake of simplycity这个不知道啥意思,难道是由于出现纸尿布....).

修改COM组件里面的机器名为你的SQL Server的机器名.(2005以上需要 机器名/实例名)
当然我在里面也创建了一个用户scott密码是tiger,用来连接数据库.你可以选择这个用户名,或者重新建一个.
Part I: 用C#创建一个简单的COM组件

COM对象是一种类库.COM组件将产生DLL文件.在VS环境里面创建COM组件请选择....

　　File->New->Project->VisualC# Projects ->Class Library.

创建一个名为Database_COMObject的类库工程.

请记住:想要把C#对象当作COM对象需要以下几点...

class必须是public的
属性,方法和事件必须是public
属性和方法必须在Interface里面定义
事件必须在事件的接口中
未在接口中定义的成员,而在实现里面是public的成员,对COM是不可见的,但是对其他的.NET程序是可见的.为了把属性和方法暴露给COM,你必须在接口中定义他们,并且把他们用DispId属性标记,在class里面实现(.....).在接口里面定义的成员只是为了使用vtable(虚函数表).要想暴露事件,你也必须把成员定义在事件接口里面并且标记DispId属性.类不需要实现此接口(???).类可以实现接口(一个类可以实现多个接口,只有第一个接口才是默认的接口.).暴露给COM的那些属性方法其实就在类的实现里面.他们必须被标记为public,而且要符合接口里面的定义.Also, declare the events raised by the class here. They must be marked public and must match the declarations in the events interface. (这两句不知道具体的含义,代码里面也没看出端倪.)

每一个接口都要有一个GUID属性(我当时上学的时候,把他叫属性属性,或者定制属性,现在也不清楚到底叫什么..).你可以用guidgen.exe来产生一个GUID值.

这个接口就长这个样子:

 

show sourceview source

print?
[Guid("694C1820-04B6-4988-928F-FD858B95C880")]
public interface DBCOM_Interface
{
    [DispId(1)]
    void Init(string userid , string password);
    [DispId(2)]
    bool ExecuteSelectCommand(string selCommand);
    [DispId(3)]
    bool NextRow();
    [DispId(4)]
    void ExecuteNonSelectCommand(string insCommand);
    [DispId(5)]
    string GetColumnData(int pos);
}
 

    [Guid("694C1820-04B6-4988-928F-FD858B95C880")]    public interface DBCOM_Interface    {        [DispId(1)]        void Init(string userid , string password);        [DispId(2)]        bool ExecuteSelectCommand(string selCommand);        [DispId(3)]        bool NextRow();        [DispId(4)]        void ExecuteNonSelectCommand(string insCommand);        [DispId(5)]        string GetColumnData(int pos);    }COM事件:

 

show sourceview source

print?
// // Events interface Database_COMObjectEvents 
[Guid("47C976E0-C208-4740-AC42-41212D3C34F0"), 
InterfaceType(ComInterfaceType.InterfaceIsIDispatch)]
public interface DBCOM_Events 
{
}
 

实现接口的类:

 

view source

print?
1 <PRE class=brush:csharp;collapse:true;;gutter:false;>[Guid("9E5E5FB2-219D-4ee7-AB27-E4DBED8E123E"),
2     ClassInterface(ClassInterfaceType.None),
3     ComSourceInterfaces(typeof(DBCOM_Events))]
4     public class DBCOM_Class : DBCOM_Interface
5     {
6 </PRE>
在类的前面标记:

 

ClassInterface(ClassInterfaceType.None), ComSourceInterfaces(typeof(DBCOM_Events))]

ClassInterfaceType.None表示,这个类不会产生类接口.如果没有显式的接口实现,那么这个类只能提供对IDispatch的访问.用户期待通过接口导出该类显式实现了的成员.所以需要使用设置ClassInterfaceAttribute.

ComSourceInterfaces(typeof(DBCOM_Events))]标明标记的这个类会把接口暴露给COM事件源.在我们的例子中,没有什么需要暴露的..

下面是完整的COM对象:

 

show sourceview source

print?
using System;
using System.Runtime.InteropServices;
using System.IO;
using System.Text;
using System.Data.SqlClient;
using System.Windows.Forms ;
  
namespace Database_COMObject
{
    [Guid("694C1820-04B6-4988-928F-FD858B95C880")]
    public interface DBCOM_Interface
    {
        [DispId(1)]
        void Init(string userid , string password);
        [DispId(2)]
        bool ExecuteSelectCommand(string selCommand);
        [DispId(3)]
        bool NextRow();
        [DispId(4)]
        void ExecuteNonSelectCommand(string insCommand);
        [DispId(5)]
        string GetColumnData(int pos);
    }
  
    // Events interface Database_COMObjectEvents 
  
    [Guid("47C976E0-C208-4740-AC42-41212D3C34F0"), 
    InterfaceType(ComInterfaceType.InterfaceIsIDispatch)]
    public interface DBCOM_Events 
    {
    }
  
  
    [Guid("9E5E5FB2-219D-4ee7-AB27-E4DBED8E123E"),
    ClassInterface(ClassInterfaceType.None),
    ComSourceInterfaces(typeof(DBCOM_Events))]
    public class DBCOM_Class : DBCOM_Interface
    {
        private SqlConnection myConnection = null ; 
        SqlDataReader myReader = null ;
  
        public DBCOM_Class()
        {
        }
  
        public void Init(string userid , string password)
        {
            try
            {
                string myConnectString = "user id="+userid+";password="+password+
                    ";Database=NorthWind;Server=SKYWALKER;Connect Timeout=30";
                myConnection = new SqlConnection(myConnectString);
                myConnection.Open();
                //MessageBox.Show("CONNECTED");
  
            }
            catch(Exception e)
            {
                MessageBox.Show(e.Message);
            }
        }
  
        public bool ExecuteSelectCommand(string selCommand)
        {
            if ( myReader != null ) 
                myReader.Close() ;
  
            SqlCommand myCommand = new SqlCommand(selCommand);
            myCommand.Connection = myConnection;
            myCommand.ExecuteNonQuery();
            myReader = myCommand.ExecuteReader();
            return true ;
        }
          
        public bool NextRow()
        {
            if ( ! myReader.Read() )
            {
                myReader.Close();
                return false ;
            }
            return true ;
        }
  
        public string GetColumnData(int pos)
        {
            Object obj = myReader.GetValue(pos);
            if ( obj == null ) return "" ;
            return obj.ToString() ;
        }
  
        public void ExecuteNonSelectCommand(string insCommand)
        {
            SqlCommand myCommand = new SqlCommand(insCommand , myConnection);
            int retRows = myCommand.ExecuteNonQuery();
        }
  
    }
}
 

 

在编译COM组件之前,需要在COM Interop那里注册.

打开Solution Explorer->Properties->Configuration->Build->Expand the output section->Register for COM Interop改为True.

(我在VS 2008里面貌似不是这么操作的,工程上面点右键->属性->Build->最下面的Output->Register for COM Interop改为True).

表明,我要把Managed程序导出一个COM对象,并且COM对象可以和我们的托管程序交互.

为了(真正)导出COM对象,程序集还需要强命名,可以用sn.exe生成一个StrongName:

sn -k Database_COM_Key.snk

在AssemblyInfo.cs文件里面修改:

[assembly: AssemblyKeyFile("Database_COM_Key.snk")]

编译这个对象.会产生一个tlb文件,通过这个可以使Managed代码和Native代码都能访问你的COM对象.

Part II : 用VC++创建一个客户端去访问这个COM对象

我已经在VC++6.0和VC++.NET下面访问呢过改COM对象.

创建一个简单的工程,通过 #import directive导入type library.

 

创建一个只能指针指向接口的实例,执行那些导出函数,确保在程序加载的时候执行CoInitialize().