用途:在 .NET 中通过平台调用(P/Invoke)调用原生 C/C++ 库,覆盖声明方式、封送、回调与跨平台库解析。
主要能力:
- 声明方式:LibraryImport(.NET 7+ 首选,编译期源生成封送代码,AOT 兼容)与 DllImport(旧式,运行时封送)。方法需为 partial class 中的 static partial;字符串需显式指定 StringMarshalling 或 MarshalAs;bool 返回值需 [return: MarshalAs(UnmanagedType.Bool)];支持 Span/ReadOnlySpan。
- 迁移:SYSLIB1054 分析器可提示 DllImport 转 LibraryImport,需将 extern 改为 partial、CharSet 改为 StringMarshalling、IntPtr 改为 nint。
- 跨平台库名:Windows 用 .dll,macOS 用 .dylib,Linux 用 .so;.NET 会探测 foo、foo.dll/.so/.dylib、libfoo 等变体。iOS 不允许运行时加载动态库,须静态链接并用 __Internal;Android 从 APK 的 lib/<abi>/ 加载 .so。WASM 不支持传统 P/Invoke。
- NativeLibrary.SetDllImportResolver(.NET Core 3.0+)可在运行时按平台解析库,适用于带版本号的 .so、非标准路径、按 RID 打包等场景;NativeLibrary 提供 Load/TryLoad/GetExport/TryGetExport/Free。
- 封送:StructLayout 控制 Sequential/Explicit/Pack 布局;blittable 结构体直接传递;字符串显式指定 UTF-8/UTF-16;输出缓冲用 char[]/byte[] 配合 ArrayPool,而非 StringBuilder。
- 回调:优先用 [UnmanagedCallersOnly] 的非托管函数指针,需要托管状态时用委托并保持引用防止 GC。
- 资源生命周期:用 SafeHandle 子类(如 SafeHandleZeroOrMinusOneIsInvalid)管理原生句柄。
- 类型映射:固定宽度类型直接对应;size_t 用 nint/nuint;C/C++ long 在 Windows 为 4 字节、64 位 Unix 为 8 字节,应使用 CLong/CULong;Windows BOOL 为 4 字节 int。
使用方式:在 partial class 中声明 static partial 方法并标注 LibraryImport,指定库名与字符串封送;跨平台时注册 DllImportResolver;按平台在项目文件中引入原生库(如 NativeReference、AndroidNativeLibrary)。
适用场景:调用系统或第三方 C/C++ 库、跨平台桌面与移动应用、需要 AOT 兼容的互操作。
限制:AOT 专属 P/Invoke 见 dotnet-native-aot;COM 与 CsWin32 见 dotnet-winui;WASM JavaScript 互操作见 dotnet-aot-wasm。资料未提供收费、价格或效果信息。