.NET简谈互操作(三:基础知识之DllImport特性)
2011-06-27 15:36 by 南京.王清培, 787 visits, 收藏, 编辑我们继续.NET互操作学习,上一篇文章中我们介绍了托管代码怎么与非托管代码C++之间的互操作;要想在托管代码中成功的进行非托管调用,要注意的细节还是很多的,下面我们就来介绍一下,在互操作方面托管代码要注意的必不可少的代码申明,为我们下面的互操作打下基础;
在.NET平台里面开发我们还是很幸运的,微软为我们做了很多很方便的东西,我们只需要了解一下就能快速上手;在互操作里面我们只需要借助 DllImport特性就能很好的切入到非托管代码中,微软为我们处理了复杂的内存分配、动态函数查找、地址解析等等本应该我们自己去处理的事情;所谓工 欲善其事,必先利其器;选择.NET是正确的;下面我们就来逐一讲解在互操作方面我们要用到的一些基本知识当然也是踏进互操作门槛的关键技术要点;[王清培版权所有,转载请给出署名]
DllImport特性
首先我们来了解一下DllImport代码特性,在进行互操作的时候,我们需要用DllImport来标识该方法是非托管的代码方法,在编译器编译 的时候它能够正确的认识出被该特性标记的是外来代码段,所以能顺利的通过编译,当到达程序运行的时候,也能够正确的认识出该代码是引用非托管的代码,这样 就让我们的CLR去加载非托管DLL文件,然后查找到入口点进行调用;我们拿上一篇文章中的示例来讲吧;
[DllImport("Win32DLL.dll", EntryPoint = "add", CharSet = CharSet.Auto, CallingConvention = CallingConvention.StdCall)]
public static extern int AddNumber(int x, int y);
这段代码申明了一个非托管代码AddNumber方法,我们来看DllImport特性的这几个属性具体什么意思;在DllImport构造函数里面有一个dllname的参数,请看图:
图1:
我们可以看到注释,这个构造函数的参数是非托管dll的名称,也就是我们所要用到的导入方法的具体位置;上图中的参数是 "Win32DLL.dll"字符串,也就是我们上篇文章中创建的非托管C++生成文件,在后面有几个相关属性,我们也逐一来解释;
DllImport特性中的EntryPoint可选属性;
图2:
EntryPoint属性是用来确定非托管方法的入口点是什么,在图1中,我的非托管代码的入口点名称是add,也就是说明一个问题,系统在识别非 托管代码名称是靠Entrypoint属性来的,而不是我们在C#编辑器中申明的托管代码的名称AddNumber,系统只用Entrypoint来确定 非托管入口点,而我们可以用随意的名称来定义非托管的调用名称,这往往是个好方法,由于我们托管代码经常要讲究一些对象化的编程方法,所以在命名方面也是 至关重要的,不能随意起一个没有任何对象意义的名称,这样我们就可以定义自己的,复合当前上下文的,很形象的名称;[王清培版权所有,转载请给出署名]
DllImport特性中的CharSet可选属性;
图3:
CharSet属性是用来确定在托管与非托管调用的过程中用什么字符编码来封送数据,因为我们的.NET平台是采用的Unicode编码,而标准 C++是采用的Ansi编码,在我们了解了非托管代码的编码方式之后,我们就很确定用什么编码,那么如果我们不清楚非托管代码是用什么语言编写的或者不清 楚它的编码方式时,我们可以使用CharSet枚举中的auto值,让CLR自动为我们处理相关细节;
DllImport特性中的CallingConvention可选属性;
CallingConvention属性也是一个比较重要的属性,在平台调用的过程中起到查找入口点的作用,在托管代码进行非托管代码入口点查找 时,会通过CallingConvention中的值进行确认非托管入口点的调用约定,上篇文章中我们提到了调用约定的一些概念,
extern "C" _declspec(dllexport) int _stdcall add(int x,int y)
{
return x+y;
}
这段是非托管C++代码,在这个方法前面有一个_stdcall的关键字,这个关键字的意思是说方法的调用约定,我们来看_stdcall调用的相 关概念说明:函数的参数自右向左通过栈传递,被调用的函数在返回前清理传送参数的内存栈;意思是说,有被调用方来清理调用堆栈;
还有_declspec(dllexport)关键代码,这段意思是说将该方法导出为可调用方法,也就是说外来者是可以调用的方法,由于DLL文件不是每一个方法都可以调用的,只有编写者愿意才能使用;;[王清培版权所有,转载请给出署名]
extern "C"关键代码,是名称修饰的意思,在编译期间采用C编译选项来编译这个函数,由于C和C++是不同的语言,具体的语法也不相同,所以在C++中提供了选 择的余地,让我们可以选择用什么编译方式来编译方法,如果我们用"C"代码修饰了之后,编译器会通过区分不同的调用约定来重新命名方法的名称;
摘:
__stdcall调用约定在输出函数名前加上一个下划线前缀,后面加上一个"@"符号和其参数的字节数,格式为_functionname@number,例如:function(int a, int b),其修饰名为:_function@8
__cdecl调用约定仅在输出函数名前加上一个下划线前缀,格式为_functionname。
__fastcall调用约定在输出函数名前加上一个"@"符号,后面也是一个"@"符号和其参数的字节数,格式为@functionname@number。
(由于本人非C++出身所以未能总结出自己的一套理解思路,再此先用一下网摘的说明)
总结:本篇文章重点是讲解DLLImport关键特性的使用,在P/Invoke过程中的基本约定需要用该特性来表示,由于托管与非托管在实现方面是不一样的,这样怎么来协调这两个平台之间的调用,我想.NET为我们做好了; ;[王清培版权所有,转载请给出署名]