在C#开发过程中，当需要实现一些系统级的操作，比如控制其他窗口、获取鼠标键盘状态、弹出系统提示框等原生功能时，直接调用Windows API是最直接有效的方式，而user32.dll作为Windows用户界面相关的核心动态链接库，包含了大量常用的API函数，我们可以通过DllImport特性将其导入到C#项目中使用。
C#调用Windows API的核心：DllImport特性
DllImport是System.Runtime.InteropServices命名空间下的一个特性，它的作用是告诉CLR（公共语言运行时）需要从指定的非托管DLL中导入函数，让C#代码可以调用这些非托管的原生函数。要使用DllImport，首先需要引入对应的命名空间：
using System.Runtime.InteropServices;
DllImport的常用属性说明
DllImport特性有多个可选属性，用来指定导入函数的相关规则，常用的属性如下：
- DllName：必填属性，指定要导入的DLL名称，比如user32.dll、kernel32.dll等。
- EntryPoint：指定DLL中函数的实际名称，如果C#中定义的函数名和DLL中的函数名不一致，可以通过这个属性指定原函数名。
- CharSet：指定字符集，因为Windows API很多函数有ANSI和Unicode两个版本，设置为CharSet.Auto可以让运行时自动选择合适的版本。
- CallingConvention：指定函数的调用约定，Windows API大多使用CallingConvention.Winapi，也就是默认的调用约定。
导入user32.dll函数的完整步骤
下面以调用user32.dll中的MessageBox函数为例，讲解完整的导入和使用流程，这个函数的功能是弹出一个系统消息框。
第一步：定义导入的函数签名
首先需要知道MessageBox函数在user32.dll中的原型，它的原生C++定义如下：
int WINAPI MessageBox(HWND hWnd, LPCSTR lpText, LPCSTR lpCaption, UINT uType);
对应的C#函数签名需要按照非托管函数的参数类型进行映射，C#中对应的定义如下：
[DllImport("user32.dll", EntryPoint = "MessageBox", CharSet = CharSet.Auto, CallingConvention = CallingConvention.Winapi)]
public static extern int MessageBox(IntPtr hWnd, string text, string caption, uint type);
这里需要注意几个点：原生函数中的HWND句柄类型对应C#的IntPtr类型，字符串类型对应C#的string类型，并且需要设置CharSet为Auto，保证字符串编码正确。
第二步：调用导入的函数
定义好函数之后，就可以直接在C#代码中调用了，不需要额外的初始化操作，示例如下：
class Program
{
[DllImport("user32.dll", EntryPoint = "MessageBox", CharSet = CharSet.Auto, CallingConvention = CallingConvention.Winapi)]
public static extern int MessageBox(IntPtr hWnd, string text, string caption, uint type);
static void Main(string[] args)
{
// 调用MessageBox函数，弹出消息框
// 第一个参数IntPtr.Zero表示没有父窗口
// 第二个参数是消息框内容
// 第三个参数是消息框标题
// 第四个参数0表示只显示确定按钮
MessageBox(IntPtr.Zero, "这是通过调用user32.dll的MessageBox函数弹出的消息框", "提示", 0);
}
}
运行上面的代码，就会弹出一个Windows系统风格的消息框，说明我们成功调用了user32.dll中的函数。
更多user32.dll常用函数导入示例
除了MessageBox，user32.dll还有很多常用的函数，下面再举几个常见的导入示例。
获取当前前台窗口句柄
GetForegroundWindow函数可以获取当前用户正在操作的前台窗口的句柄，C#导入方式如下：
[DllImport("user32.dll")]
public static extern IntPtr GetForegroundWindow();
调用示例：
IntPtr foregroundWindowHandle = GetForegroundWindow();
Console.WriteLine($"当前前台窗口句柄：{foregroundWindowHandle}");
查找窗口句柄
FindWindow函数可以根据窗口类名和窗口标题查找对应的窗口句柄，C#导入方式如下：
[DllImport("user32.dll", CharSet = CharSet.Auto)]
public static extern IntPtr FindWindow(string className, string windowName);
调用示例，查找记事本窗口：
// 记事本的窗口类名是Notepad
IntPtr notepadHandle = FindWindow("Notepad", null);
if (notepadHandle != IntPtr.Zero)
{
Console.WriteLine("找到了记事本窗口");
}
else
{
Console.WriteLine("没有找到记事本窗口");
}
注意事项
在调用Windows API和导入user32.dll函数时，有几个需要注意的问题：
- 函数签名必须和DLL中的原生函数匹配，参数类型、返回值类型都要正确映射，否则可能会出现内存访问错误或者调用失败的情况。
- 如果调用的API函数涉及字符串参数，一定要注意字符集的设置，否则可能会出现乱码或者找不到函数的问题。
- 非托管代码没有CLR的内存管理机制，调用完成后如果有需要释放的资源，要记得调用对应的释放函数，避免内存泄漏。
- 不同版本的Windows系统，部分API的行为可能有差异，测试的时候要注意系统兼容性。
C#DllImportuser32.dllWindows_API修改时间：2026-07-15 12:54:39