c++经过这么多年的发展已经积累了大量的动态连接库,如果能够在.net环境里应用这些函数库,
可以很大的提高整个应用的开发速度。
使用c++编程的人员肯定对指针不会感到陌生,由于c++中的函数接口好多都可能定义成位指针,
而c#中只有在声明为unsafe code中才能够使用指针。如果想让c++的DLL支持在C#中调用,
那么在C++接口的声明中需要使用下面的这种格式:
extern "C" __declspec(dllexport) void __stdcall popMessage(char* message)
{
MessageBox(NULL, message, "C message from C#!", MB_OK);
}
并且在c#类声明中使用如下的导入编译好的DLL,例如:
[ DllImport( "test.dll", CallingConvention=CallingConvention.Cdecl )]
public static extern void Message(string theMessage);
当然你可以从一个DLL中导入多个方法的声明,例如:
[ DllImport( "test.dll", CallingConvention=CallingConvention.Cdecl )]
public static extern void Func1(string theMessage);
[ DllImport( "test.dll", CallingConvention=CallingConvention.Cdecl )]
public static extern void Func2(string theMessage);
[ DllImport( "test.dll", CallingConvention=CallingConvention.Cdecl )]
public static extern void Func3(string theMessage);
一、发生的背景
在开发新项目中使用了新的语言开发C#和新的技术方案WEB Service,但是在新项目中,一些旧的模块需要继续使用,一般是采用C或C++或Delphi编写的,如何利用旧模块对于开发人员来说,有三种可用方法供选择:第一、将C或C++函数用C#彻底改写一遍,这样整个项目代码比较统一,维护也方便一些。但是尽管微软以及某些书籍说,C#和C++如何接近,但是改写起来还是很痛苦的事情,特别是C++里的指针和内存操作;第二、将C或C++函数封装成COM,在C#中调用COM比较方便,只是在封装时需要处理C或C++类型和COM类型之间的转换,也有一些麻烦,另外COM还需要注册,注册次数多了又可能导致混乱;第三、将C或C++函数封装成动态链接库,封装的过程简单,工作量不大。因此我决定采用加载动态链接库的方法实现,于是产生了在C#中如何调用自定义的动态链接库问题,我在网上搜索相关主题,发现一篇调用系统API的文章,但是没有说明如何解决此问题,在MSDN上也没有相关详细说明。基于此,我决定自己从简单出发,逐步试验,看看能否达到自己的目标。
(说明一点:我这里改写为什么很怕麻烦,我改写的代码是变长加密算法函数,代码有600多行,对算法本身不熟悉,算法中指针和内存操作太多,要想保证算法正确,最可行的方法就是少动代码,否则只要有一点点差错,就不能肯定算法与以前兼容)
二、技术实现
下面看看如何逐步实现动态库的加载,类型的匹配:
动态链接库函数导出的定义,这个不需要多说,大家参考下面宏定义即可:
#define LIBEXPORT_API extern "C" __declspec(dllexport)
第一步,我先从简单的调用出发,定义了一个简单的函数,该函数仅仅实现一个整数加法求和:
LIBEXPORT_API int mySum(int a,int b){ return a+b;}
C#定义导入定义:
public class RefComm
{
[DllImport("LibEncrypt.dll", EntryPoint=" mySum ",CharSet=CharSet.Auto,CallingConvention=CallingConvention.StdCall)] public static extern int mySum (int a,int b);
}
在C#中调用测试:
int iSum= RefComm. mySum(2,3);
运行查看结果iSum为5,调用正确。第一步试验完成,说明在C#中能够调用自定义的动态链接库函数。
第二步,我定义了字符串操作的函数(简单起见,还是采用前面的函数名),返回结果为字符串:
LIBEXPORT_API char *mySum(char *a,char *b){sprintf(b,”%s”,a) return a;}
C#定义导入定义:
public class RefComm
{
[DllImport("LibEncrypt.dll", EntryPoint=" mySum ",CharSet=CharSet.Auto,CallingConvention=CallingConvention.StdCall)] public static extern string mySum (string a, string b);
}
在C#中调用测试:
string strDest=””;
string strTmp= RefComm. mySum(“12345”, strDest);
运行查看结果strTmp为“12345”,但是strDest为空。
我修改动态链接库实现,返回结果为串b:
LIBEXPORT_API char *mySum(char *a,char *b){sprintf(b,”%s”,a) return b;}
修改C#导入定义,将串b修改为ref方式:
public class RefComm
{
[DllImport("LibEncrypt.dll", EntryPoint=" mySum ",CharSet=CharSet.Auto,CallingConvention=CallingConvention.StdCall)] public static extern string mySum (string a, ref string b);
}
在C#中再调用测试:
string strDest=””;
string strTmp= RefComm. mySum(“12345”, ref strDest);
运行查看结果strTmp和strDest均不对,含不可见字符。
再修改C#导入定义,将CharSet从Auto修改为Ansi:
public class RefComm
{
[DllImport("LibEncrypt.dll", EntryPoint=" mySum ",CharSet=CharSet.Ansi,CallingConvention=CallingConvention.StdCall)] public static extern string mySum (string a, string b);
}
在C#中再调用测试:
string strDest=””;
string strTmp= RefComm. mySum(“12345”, ref strDest);
运行查看结果strTmp为“12345”,但是串strDest没有赋值。第二步实现函数返回串,但是在函数出口参数中没能进行输出。
再次修改C#导入定义,将串b修改为引用(ref):
public class RefComm
{
[DllImport("LibEncrypt.dll", EntryPoint=" mySum ",CharSet=CharSet.Ansi,CallingConvention=CallingConvention.StdCall)] public static extern string mySum (string a, ref string b);
}
运行时调用失败,不能继续执行。
第三步,修改动态链接库实现,将b修改为双重指针:
LIBEXPORT_API char *mySum(char *a,char **b){sprintf((*b),”%s”,a) return *b;}
C#导入定义:
public class RefComm
{
[DllImport("LibEncrypt.dll", EntryPoint=" mySum ",CharSet=CharSet.Ansi,CallingConvention=CallingConvention.StdCall)] public static extern string mySum (string a, ref string b);
}
在C#中调用测试:
string strDest=””;
string strTmp= RefComm. mySum(“12345”, ref strDest);
运行查看结果strTmp和strDest均为“12345”,调用正确。第三步实现了函数出口参数正确输出结果。
第四步,修改动态链接库实现,实现整数参数的输出:
LIBEXPORT_API int mySum(int a,int b,int *c){ *c=a+b; return *c;}
C#导入的定义:
public class RefComm
{
[DllImport("LibEncrypt.dll", EntryPoint=" mySum ",CharSet=CharSet.Ansi,CallingConvention=CallingConvention.StdCall)] public static extern int mySum (int a, int b,ref int c);
}
在C#中调用测试:
int c=0;
int iSum= RefComm. mySum(2,3, ref c);
运行查看结果iSum 和c均为5,调用正确。
经过以上几个步骤的试验,基本掌握了如何定义动态库函数以及如何在C#定义导入,有此基础,很快我实现了变长加密函数在C#中的调用,至此目标实现。
三、结论
在C#中,调用C++编写动态链接库函数,如果需要出口参数输出,则需要使用指针,对于字符串,则需要使用双重指针,对于C#的导入定义,则需要使用引用(ref)定义。
对于函数返回值,C#导入定义和C++动态库函数申明定义需要保持一致,否则会出现函数调用失败。
定义导入时,一定注意CharSet和CallingConvention参数,否则导致调用失败或结果异常。
运行时,动态链接库放在C#程序的目录下即可,我这里是一个C#的动态链接库,两个动态链接库就在同一个目录下运行。
然后你可以在你的c#类中调用上面声明的方法。