C#使用DllImport调用外部DLL的方法

调用基本格式

在C#中调用非托管DLL函数，需先引入 `System.Runtime.InteropServices` 命名空间。基本结构如下：

[DllImport("DLL文件名", EntryPoint = "函数入口", CharSet = CharSet.Unicode, ...)]
public static extern 返回类型 方法名(参数列表);

以下是一个调用Windows内核函数的完整示例：

using System.Runtime.InteropServices;

[DllImport("KERNEL32.DLL", 
           EntryPoint = "MoveFileW",
           SetLastError = true,
           CharSet = CharSet.Unicode,
           ExactSpelling = true,
           CallingConvention = CallingConvention.StdCall)
]
public static extern bool MoveFile(String src, String dst);

声明规范解析

在源程序中声明外部方法时，需遵循以下规则：

• DLL文件：包含目标函数的库文件路径或名称。
• 修饰符：通常使用 static extern。extern表示方法体由非托管代码提供，static确保不依赖实例。
• 返回类型与方法名：必须与DLL中的实际定义一致。C#方法名可不同，但需通过 EntryPoint 映射到真实入口点。
• 参数列表：类型需兼容非托管签名。复杂类型可能需要自定义 StructLayout。

关键可选属性说明

DllImportAttribute 提供多种控制行为的关键参数：

• EntryPoint：明确指定要调用的DLL内部函数名。若省略，默认使用C#方法名。
• CharSet：控制字符串参数的编码。常用值为 CharSet.Ansi（默认）、CharSet.Unicode 或 CharSet.Auto。影响宽字符（Wide Char）与窄字符（Ansi）API的选择。
• SetLastError：设为 true 时，运行时会在调用前记录错误代码。随后可通过 Marshal.GetLastWin32Error() 获取详细错误信息，这对排查调用失败至关重要。
• CallingConvention：指定参数传递约定。对于Windows API，通常使用 CallingConvention.StdCall（对应 __stdcall）。默认值通常为 CallingConvention.Winapi，它会根据平台自动调整。
• ExactSpelling：设为 false 时（默认），允许CharSet后缀自动匹配（如 MoveFileW vs MoveFileA）。设为 true 则强制精确匹配入口点名称。
• PreserveSig：默认为 true，保持方法签名不变。若设为 false，编译器可能将HRESULT返回值转换为异常或自动添加输出参数，这取决于具体的COM互操作场景。

完成判断与验证

调用成功的标志是方法执行无异常，且返回预期的非托管结果。对于涉及状态变更的API，建议检查 SetLastError 是否为 true 以确认调用链的健康状态。

简要总结

通过合理使用 DllImport 及其属性，C#开发者可以无缝集成现有的C/C++库资源。重点在于准确匹配签名、正确设置字符集与调用约定，并利用错误处理机制保障程序稳定性。以上就是C#使用DllImport调用外部DLL的详细内容，更多关于C# P/Invoke互操作的资料请关注本站其它相关文章！