程序与技术分享:C#调用DLL的几种方法

简介: 程序与技术分享:C#调用DLL的几种方法

c#中dll调用方法


一、 DLL与应用程序


动态链接库(也称为DLL,即为“Dynamic Link Library”的缩写)是Microsoft Windows最重要的组成要素之一,打开Windows系统文件夹,你会发现文件夹中有很多DLL文件,Windows就是将一些主要的系统功能以DLL模块的形式实现。


动态链接库是不能直接执行的,也不能接收消息,它只是一个独立的文件,其中包含能被程序或其它DLL调用来完成一定操作的函数(方法。注:C#中一般称为“方法”),但这些函数不是执行程序本身的一部分,而是根据进程的需要按需载入,此时才能发挥作用。


DLL只有在应用程序需要时才被系统加载到进程的虚拟空间中,成为调用进程的一部分,此时该DLL也只能被该进程的线程访问,它的句柄可以被调用进程所使用,而调用进程的句柄也可以被该DLL所使用。在内存中,一个DLL只有一个实例,且它的编制与具体的编程语言和编译器都没有关系,所以可以通过DLL来实现混合语言编程。DLL函数中的代码所创建的任何对象(包括变量)都归调用它的线程或进程所有。


下面列出了当程序使用 DLL 时提供的一些优点:【1】


1) 使用较少的资源


当多个程序使用同一个函数库时,DLL 可以减少在磁盘和物理内存中加载的代码的重复量。这不仅可以大大影响在前台运行的程序,而且可以大大影响其他在 //代码效果参考:http://www.lyjsj.net.cn/wx/art_24233.html

Windows 操作系统上运行的程序。

2) 推广模块式体系结构


DLL 有助于促进模块式程序的开发。这可以帮助您开发要求提供多个语言版本的大型程序或要求具有模块式体系结构的程序。模块式程序的一个示例是具有多个可以在运行时动态加载的模块的计帐程序。


3) 简化部署和安装


当 DLL 中的函数需要更新或修复时,部署和安装 DLL 不要求重新建立程序与该 DLL 的链接。此外,如果多个程序使用同一个 DLL,那么多个程序都将从该更新或修复中获益。当您使用定期更新或修复的第三方 DLL 时,此问题可能会更频繁地出现。


二、 DLL的调用


每种编程语言调用DLL的方法都不尽相同,在此只对用C#调用DLL的方法进行介绍。首先,您需要了解什么是托管,什么是非托管。一般可以认为:非托管代码主要是基于win 32平台开发的DLL,activeX的组件,托管代码是基于.net平台开发的。如果您想深入了解托管与非托管的关系与区别,及它们的运行机制,请您自行查找资料,本文件在此不作讨论。


(一) 调用DLL中的非托管函数一般方法


首先,应该在C#语言源程序中声明外部方法,其基本形式是:


【DLLImport(“DLL文件”)】


修饰符 extern 返回变量类型 方法名称 (参数列表)


其中:


DLL文件:包含定义外部方法的库文件。


修饰符: 访问修饰符,除了abstract以外在声明方法时可以使用的修饰符。


返回变量类型:在DLL文件中你需调用方法的返回变量类型。


方法名称:在DLL文件中你需调用方法的名称。


参数列表:在DLL文件中你需调用方法的列表。


注意:需要在程序声明中使用System.Runtime.InteropServices命名空间。


DllImport只能放置在方法声明上。


DLL文件必须位于程序当前目录或系统定义的查询路径中(即:系统环境变量中Path所设置的路径)。


返回变量类型、方法名称、参数列表一定要与DLL文件中的定义相一致。


若要使用其它函数名,可以使用EntryPoint属性设置,如:


【DllImport("user32.dll", EntryPoint="MessageBoxA")】


static extern int MsgBox(int hWnd, string msg, string caption, int type);


其它可选的 DllImportAttribute 属性:


CharSet 指示用在入口点中的字符集,如:CharSet=CharSet.Ansi;


SetLastError 指示方法是否保留 Win32"上一错误",如//代码效果参考:http://www.lyjsj.net.cn/wz/art_24231.html

:SetLastError=true;

ExactSpelling 指示 EntryPoint 是否必须与指示的入口点的拼写完全匹配,如:ExactSpelling=false;


PreserveSig指示方法的签名应当被保留还是被转换, 如:PreserveSig=true;


CallingConvention指示入口点的调用约定, 如:CallingConvention=CallingConvention.Winapi;


此外,关于“数据封送处理”及“封送数字和逻辑标量”请参阅其它一些文章【2】。


C#例子:


1. 启动新建一个项目,项目名称为“Tzb”,模板为“Windows 应用程序”。


2. 在“工具箱”的“ Windows 窗体”项中双击“Button”项,向“Form1”窗体中添加一个按钮。


3. 改变按钮的属性:Name为 “B1”,Text为 “用DllImport调用DLL弹出提示框”,并将按钮B1调整到适当大小,移到适当位置。


4. 在类视图中双击“Form1”,打开“Form1.cs”代码视图,在“namespace Tzb”上面输入“using System.Runtime.InteropServices;”,以导入该命名空间。


5. 在“Form1.cs[设计]”视图中双击按钮B1,在“B1_Click”方法上面使用关键字 static 和 extern 声明方法“MsgBox”,将 DllImport 属性附加到该方法,这里我们要使用的是“user32.dll”中的“MessageBoxA”函数,具体代码如下:


【DllImport("user32.dll", EntryPoint="MessageBoxA")】


static extern int MsgBox(int hWnd, string msg, string caption, int type);


然后在“B1_Click”方法体内添加如下代码,以调用方法“MsgBox”:


MsgBox(0," 这就是用 DllImport 调用 DLL 弹出的提示框哦! "," 挑战杯 ",0x30);


6. 按“F5”运行该程序,并点击按钮B1,便弹出如下提示框:


// 导出函数,使用“ _stdcall ” 标准调用


extern "C" _declspec(dllexport)int _stdcall count(int init);


int _stdcall count(int init)


{//count 函数,使用参数 init 初始化静态的整形变量 S ,并使 S 自加 1 后返回该值


static int S=init;


S++;


return S;


}


5) 按“F7”进行编译,得到Count.dll(在工程目录下的Debug文件夹中)。


2. 用DllImport调用DLL中的count函数


1) 打开项目“Tzb”,向“Form1”窗体中添加一个按钮。


2) 改变按钮的属性:Name为 “B2”,Text为 “用DllImport调用DLL中count函数”,并将按钮B1调整到适当大小,移到适当位置。


3) 打开“Form1.cs”代码视图,使用关键字 static 和 extern 声明方法“count”,并使其具有来自 Count.dll 的导出函数count的实现,代码如下:


【DllImport("Count.dll")】


static extern int count(int init);


4) 在“Form1.cs[设计]”视图中双击按钮B2,在“B2_Click”方法体内添加如下代码:


MessageBox.Show(" 用 DllImport 调用 DLL 中的 count 函数, \n 传入的实参为 0 ,得到的结果是: "+count(0).ToString()," 挑战杯 ");


MessageBox.Show(" 用 DllImport 调用 DLL 中的 count 函数, \n 传入的实参为 10 ,得到的结果是: "+count(10).ToString()+"\n 结果可不是想要的 11 哦!!! "," 挑战杯 ");


MessageBox.Show(" 所得结果表明: \n 用 DllImport 调用 DLL 中的非托管 \n 函数是全局的、静态的函数!!! "," 挑战杯 ");


3. C#动态调用DLL中的函数


因为C#中使用DllImport是不能像动态load/unload assembly那样,所以只能借助API函数了。在kernel32.dll中,与动态库调用有关的函数包括【3】:


①LoadLibrary(或MFC 的AfxLoadLibrary),装载动态库。


②GetProcAddress,获取要引入的函数,将符号名或标识号转换为DLL内部地址。


③FreeLibrary(或MFC的AfxFreeLibrary),释放动态链接库。


它们的原型分别是:


HMODULE LoadLibrary(LPCTSTR lpFileName);


FARPROC GetProcAddress(HMODULE hModule, LPCWSTR lpProcName);


BOOL FreeLibrary(HMODULE hModule);


现在,我们可以用IntPtr hModule=LoadLibrary(“Count.dll”);来获得Dll的句柄,用IntPtr farProc=GetProcAddress(hModule,”_count@4”);来获得函数的入口地址。


但是,知道函数的入口地址后,怎样调用这个函数呢?因为在C#中是没有函数指针的,没有像C++那样的函数指针调用方式来调用函数,所以我们得借助其它方法。经过研究,发现我们可以通过结合使用System.Reflection.Emit及System.Reflection.Assembly里的类和函数达到我们的目的。为了以后使用方便及实现代码的复用,我们可以编写一个类。


1) dld类的编写:


1. 打开项目“Tzb”,打开类视图,右击“Tzb”,选择“添加”-->“类”,类名设置为“dld”,即dynamic loading dll 的每个单词的开头字母。


2. 添加所需的命名空间及声明参数传递方式枚举:


using System.Runtime.InteropServices; // 用 DllImport 需用此 命名空间


using System.Reflection; // 使用 Assembly 类需用此 命名空间


using System.Reflection.Emit; // 使用 ILGenerator 需用此 命名空间


在“public class dld”上面添加如下代码声明参数传递方式枚举:


///


/// 参数传递方式枚举 ,ByValue 表示值传递 ,ByRef 表示址传递


///


public enum ModePass


{


ByValue = 0x0001,


ByRef = 0x0002


}


3. 声明LoadLibrary、GetProcAddress、FreeLibrary及私有变量hModule和farProc:


///


/// 原型是 :HMODULE LoadLibrary(LPCTSTR lpFileName);


///


///


DLL 文件名


/// 函数库模块的句柄


【DllImport("kernel32.dll")】


static extern IntPtr LoadLibrary(string lpFileName);


///


/// 原型是 : FARPROC GetProcAddress(HMODULE hModule, LPCWSTR lpProcName);


///


///


包含需调用函数的函数库模块的句柄


///


调用函数的名称


/// 函数指针


【DllImport("kernel32.dll")】


static extern IntPtr GetProcAddress(IntPtr hModule, string lpProcName);


///


/// 原型是 : BOOL FreeLibrary(HMODULE hModule);


///


///


需释放的函数库模块的句柄


/// 是否已释放指定的 Dll


【DllImport("kernel32",EntryPoint="FreeLibrary",SetLastError=true)】


static extern bool FreeLibrary(IntPtr hModule);


///


/// Loadlibrary 返回的函数库模块的句柄


///


private IntPtr hModule=IntPtr.Zero;


///


/// GetProcAddress 返回的函数指针


///


private IntPtr farProc=IntPtr.Zero;


4. 添加LoadDll方法,并为了调用时方便,重载了这个方法:


///


/// 装载 Dll


///


///


DLL 文件名


public void LoadDll(string lpFileName)


{


hModule=LoadLibrary(lpFileName);


if(hModule==IntPtr.Zero)


throw(new Exception(" 没有找到 :"+lpFileName+"." ));


}


若已有已装载Dll的句柄,可以使用LoadDll方法的第二个版本:


public void LoadDll(IntPtr HMODULE)


{


if(HMODULE==IntPtr.Zero)


throw(new Exception(" 所传入的函数库模块的句柄 HMODULE 为空 ." ));


hModule=HMODULE;


}


5. 添加LoadFun方法,并为了调用时方便,也重载了这个方法,方法的具体代码及注释如下:


///


/// 获得函数指针


///


///


调用函数的名称


public void LoadFun(string lpProcName)


{ // 若函数库模块的句柄为空,则抛出异常


if(hModule==IntPtr.Zero)


throw(new Exception(" 函数库模块的句柄为空 , 请确保已进行 LoadDll 操作 !"));


// 取得函数指针


farProc = GetProcAddress(hModule,lpProcName);


// 若函数指针,则抛出异常


if(farProc==IntPtr.Zero)


throw(new Exception(" 没有找到 :"+lpProcName+" 这个函数的入口点 "));


}


///


/// 获得函数指针


///


///


包含需调用函数的 DLL 文件名


///


调用函数的名称


public void LoadFun(string lpFileName,string lpProcName)


{ // 取得函数库模块的句柄


hModule=LoadLibrary(lpFileName);


// 若函数库模块的句柄为空,则抛出异常


if(hModule==IntPtr.Zero)


throw(new Exception(" 没有找到 :"+lpFileName+"." ));


// 取得函数指针


farProc = GetProcAddress(hModule,lpProcName);


// 若函数指针,则抛出异常


if(farProc==IntPtr.Zero)


throw(new Exception(" 没有找到 :"+lpProcName+" 这个函数的入口点 "));


}


6. 添加UnLoadDll及Invoke方法,Invoke方法也进行了重载:


///


/// 卸载 Dll


///


public void UnLoadDll()


{


FreeLibrary(hModule);


hModule=IntPtr.Zero;


farProc=IntPtr.Zero;


}


Invoke方法的第一个版本:


///


/// 调用所设定的函数


///


///


实参


///


实参类型


///


实参传送方式


//代码效果参考:http://www.lyjsj.net.cn/wz/art_24229.html

///

返回类型


/// 返回所调用函数的 object


public object Invoke(object【】 ObjArray_Parameter,Type【】 TypeArray_ParameterType,ModePass【】 ModePassArray_Parameter,Type Type_Return)


{


// 下面 3 个 if 是进行安全检查 , 若不能通过 , 则抛出异常


if(hModule==IntPtr.Zero)


throw(new Exception(" 函数库模块的句柄为空 , 请确保已进行 LoadDll 操作 !"));


if(farProc==IntPtr.Zero)


throw(new Exception(" 函数指针为空 , 请确保已进行 LoadFun 操作 !" ) );


相关文章
|
6月前
|
存储 SQL 数据库连接
C#程序调用Sql Server存储过程异常处理:调用存储过程后不返回、不抛异常的解决方案
本文分析了C#程序操作Sql Server数据库时偶发的不返回、不抛异常问题,并提出了解决思路。首先解析了一个执行存储过程的函数`ExecuteProcedure`,其功能是调用存储过程并返回影响行数。针对代码执行被阻塞但无异常的情况,文章总结了可能原因,如死锁、无限循环或网络问题等。随后提供了多种解决方案:1) 增加日志定位问题;2) 使用异步操作提升响应性;3) 设置超时机制避免阻塞;4) 利用线程池分离主线程;5) 通过信号量同步线程;6) 监控数据库连接状态确保可用性。这些方法可有效应对数据库操作中的潜在问题,保障程序稳定性。
517 11
|
缓存 C# Windows
C#程序如何编译成Native代码
【10月更文挑战第15天】在C#中,可以通过.NET Native和第三方工具(如Ngen.exe)将程序编译成Native代码,以提升性能和启动速度。.NET Native适用于UWP应用,而Ngen.exe则通过预编译托管程序集为本地机器代码来加速启动。不过,这些方法也可能增加编译时间和部署复杂度。
709 2
|
编译器 C#
C#多态概述:通过继承实现的不同对象调用相同的方法,表现出不同的行为
C#多态概述:通过继承实现的不同对象调用相同的方法,表现出不同的行为
248 65
|
11月前
|
算法 Java 测试技术
Benchmark.NET:让 C# 测试程序性能变得既酷又简单
Benchmark.NET是一款专为 .NET 平台设计的性能基准测试框架,它可以帮助你测量代码的执行时间、内存使用情况等性能指标。它就像是你代码的 "健身教练",帮助你找到瓶颈,优化性能,让你的应用跑得更快、更稳!希望这个小教程能让你在追求高性能的路上越走越远,享受编程带来的无限乐趣!
531 13
|
JSON 程序员 C#
使用 C# 比较两个对象是否相等的7个方法总结
比较对象是编程中的一项基本技能,在实际业务中经常碰到,比如在ERP系统中,企业的信息非常重要,每一次更新,都需要比较记录更新前后企业的信息,直接比较通常只能告诉我们它们是否指向同一个内存地址,那我们应该怎么办呢?分享 7 个方法给你!
452 2
|
C# UED SEO
C# 异步方法async / await任务超时处理
通过使用 `Task.WhenAny`和 `Task.Delay`方法,您可以在C#中有效地实现异步任务的超时处理机制。这种方法允许您在指定时间内等待任务完成,并在任务超时时采取适当的措施,如抛出异常或执行备用操作。希望本文提供的详细解释和代码示例能帮助您在实际项目中更好地处理异步任务超时问题,提升应用程序的可靠性和用户体验。
522 3
|
存储 C#
【C#】大批量判断文件是否存在的两种方法效率对比
【C#】大批量判断文件是否存在的两种方法效率对比
389 1
|
API C#
C#实现Winform程序右下角弹窗消息提示
C#实现Winform程序右下角弹窗消息提示
702 1
|
设计模式 程序员 C#
C# 使用 WinForm MDI 模式管理多个子窗体程序的详细步骤
WinForm MDI 模式就像是有超能力一般,让多个子窗体井然有序地排列在一个主窗体之下,既美观又实用。不过,也要小心管理好子窗体们的生命周期哦,否则一不小心就会出现一些意想不到的小bug
1083 0
|
XML 存储 安全
C#开发的程序如何良好的防止反编译被破解?ConfuserEx .NET混淆工具使用介绍
C#开发的程序如何良好的防止反编译被破解?ConfuserEx .NET混淆工具使用介绍
1001 0