17370845950

C++/CLI是微软提供的C++语法扩展，用于桥接原生C++与.NET（如C#），通过/ref class、gcroot等托管类型实现跨语言互操作，支持调用原生代码、暴露.NET接口及安全内存传递。

在 Windows 平台上，C++ 与 C# 交互最常用、最直接的方式是通过 C++/CLI（Common Language Infrastructure），它是微软为桥接原生 C++ 和 .NET（如 C#）设计的语言扩展。它不是“C++ 和 C# 混编”，而是让 C++ 代码能直接创建、调用、持有 .NET 对象，同时保留调用原生 C++ 函数的能力。

什么是 C++/CLI？它解决什么问题？

C++/CLI 是一种语法扩展（非标准 C++，需 /clr 编译开关），允许你在同一项目中：

• 声明和使用托管类型（如 ref class、gcroot）——可被 C# 直接引用
• 调用 .NET Framework 或你自己写的 C# 类库（.dll）
• 封装原有 C++ 代码（如算法、图像处理模块），暴露为简洁的 .NET 接口供 C# 调用
• 在托管与非托管内存间安全传递数据（例如把 array^ 转为 unsigned char*）

第一步：启用 C++/CLI 支持

在 Visual Studio 中新建一个 CLR 类库（.NET Framework） 项目（不是“控制台应用”或“动态链接库”）。关键设置：

• 项目属性 → 常规 → “公共语言运行时支持” → 选择 “公共语言运行时支持 (/clr)”
• 目标框架建议选 .NET Framework 4.7.2 或更高（兼容性好，避免 .NET Core/.NET 5+ 的限制）
• 不要勾选“纯 MSIL 输出”，除非你完全不调用原生代码

写一个可被 C# 调用的 C++/CLI 包装器

假设你有一个原生 C++ 函数：
// NativeMath.h
int Add(int a, int b);

你想把它暴露给 C#。在 C++/CLI 项目中写：

// ManagedWrapper.h
#using
using namespace System;
public ref class MathWrapper
{
public:
    static int Add(int a, int b)
    {
        return ::Add(a, b); // 调用原生函数
    }
};

编译后生成 ManagedWrapper.dll，C# 项目右键“添加引用”→ 浏览到该 DLL 即可使用：
int r = MathWrapper::Add(3, 5); // 在 C# 中可直接调用（注意命名空间）

常见注意事项和避坑点

• 不能跨 ABI 直接传 STL 容器：C# 看不到 std::vector，要用 array^ 或 List^
• 字符串转换要显式：C# 的 String^ → C++ std::string 需用 marshal_as（头文件 ）
• 避免在托管类中直接存裸指针：用 gcroot 持有托管对象；原生资源用 RAII + 析构函数 + !ClassName()（终结器）管理
• /clr 不支持 C++17 及以上全部特性：比如 structured bindings、constexpr if 在 /clr 下不可用；建议保持语法在 C++14 兼容范围内