C#中MarshalAs类型封送_C#互操作类型封送教程【精通】

夏丽酱_1798

夏丽酱_1798

2026-05-22

704人浏览

原创

类不能直接封送为结构体指针,因它是引用类型,默认不支持按值封送;必须显式标记[StructLayout]且用ref传参,MarshalAs仅对字段或参数有效,对类本身无效。

c#中marshalas类型封送_c#互操作类型封送教程【精通】

类在 P/Invoke 中不能直接封送为结构体指针,MarshalAs 对类本身无效——它只对字段、参数、返回值起作用,且类必须显式标记为可封送(如 [StructLayout(LayoutKind.Sequential)]),否则运行时会抛出 System.ArgumentException: Cannot marshal 'parameter #1': Invalid managed/unmanaged type combination.。

为什么类不能像结构体一样用 MarshalAs 封送

类是引用类型,默认不支持按值封送;P/Invoke 调用约定要求参数内存布局稳定、可预测,而托管类的实例地址、GC 移动、虚表等都会破坏这一前提。即使加了 [StructLayout],若未声明 unsafe 或未禁用 GC 移动(如未固定),传入非托管函数后指针可能失效。

  • 类实例传给 C++ 函数时,CLR 默认尝试封送为 COM 接口(需 [ComVisible(true)]),不是原始内存块
  • MarshalAs 属性只能修饰字段或参数,不能“让一个类整体变成某种 unmanaged 类型”
  • 错误写法:[MarshalAs(UnmanagedType.LPStruct)] public class MyData { ... } —— 编译通过但运行时报错

MarshalAs 有效作用对象:结构体字段与参数

真正能用 MarshalAs 控制封送行为的,是结构体(struct)里的字段,或 P/Invoke 方法的参数。比如 C++ 原生函数期望接收一个含固定长度字符数组的结构体:

struct MYPERSON {
    char firstname[100];
    char lastname[100];
};

对应 C# 结构体应这样写:

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Ansi)]
public struct MYPERSON
{
    [MarshalAs(UnmanagedType.ByValTStr, SizeConst = 100)]
    public string firstname;
<pre class="brush:php;toolbar:false;">[MarshalAs(UnmanagedType.ByValTStr, SizeConst = 100)]
public string lastname;

}

C#
C#

"避开 C# 常见错误——空陷阱、异步陷阱、LINQ 陷阱及资源泄漏。"

下载
  • SizeConst = 100 必须和 C++ 中数组长度一致,否则越界写入或截断
  • CharSet = CharSet.Ansi 匹配 char[],若 C++ 用 wchar_t[] 则改用 CharSet.Unicode 和 UnmanagedType.ByValArray + SizeConst + ArraySubType = UnmanagedType.U2
  • 字段类型必须是 string(非 StringBuilder),且结构体不能含引用类型字段(如 object、class 实例)

传入结构体指针时,ref 和数组写法的区别

原生函数签名为 long func(MYPERSON* p),C# 中两种常见调用方式:

  • 用 ref MYPERSON:适用于单个结构体,且 C++ 函数会修改其内容(如填入字符串)。调用前必须初始化结构体实例,否则字段为 null,封送器不会分配缓冲区
  • 用 MYPERSON[](长度为 1 的数组):等效于传指针,但需注意——数组本身是托管对象,封送器默认按 In 方向封送(即只传入,不回写)。要读取 C++ 写入的内容,必须加 [In, Out] 属性

正确写法:

[DllImport("mycpp.dll", CallingConvention = CallingConvention.Cdecl)]
public static extern long func([In, Out] ref MYPERSON p);
<p>// 调用:
MYPERSON p = new MYPERSON(); // 不能留空
func(ref p); // 此时 p.firstname 已被 C++ 填充</p>

容易忽略的三个细节

实际调试中最常卡住的地方不是语法,而是这几个隐性约束:

  • C++ DLL 导出函数必须用 extern "C" 和 __declspec(dllexport),否则 C# 找不到符号(EntryPointNotFoundException)
  • 调用约定必须匹配:C++ 默认是 __cdecl,C# [DllImport] 必须显式写 CallingConvention = CallingConvention.Cdecl;Windows API 函数才默认 StdCall
  • 结构体中若含指针(如 char*),不能用 string 字段,得用 IntPtr + 手动 Marshal.PtrToStringAnsi,否则封送器不知道该分配多大内存

复杂嵌套结构或含回调函数时,MarshalAs 只是起点,真正关键的是内存所有权归属和生命周期控制——谁分配、谁释放、是否跨线程,这些比属性写法更决定成败。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

c#

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
c#是什么意思
c#是什么意思

C#是一种通用的面向对象编程语言,它在.NET框架上运行,可用于开发各种类型的应用程序。本专题为大家提供c#相关的各种文章、以及下载和课程。

2023.08.08

952

5

什么是c#
什么是c#

C#(读作C Sharp)是一种现代的、通用的、面向对象的编程语言。它由微软公司开发,于2000年首次发布,主要用于开发Windows桌面应用程序、Web应用程序、移动应用程序以及游戏开发等领域。C#是一种类型安全和托管的编程语言,它结合了C++的强大性能和C语言的简单易学特点,并引入了许多新的特性和概念,如委托、属性、泛型和异步编程等,以提高开发效率和代码可维护性。

2023.08.31

2631

3

C#中base关键字的用法
C#中base关键字的用法

在C#中,base关键字用于访问当前类的基类成员,这包括基类的字段、属性、方法、构造函数、索引器以及事件。想了解更多C#的相关内容,可以阅读本专题下面的文章。

2024.03.13

845

8

C#Task用法
C#Task用法

Task在C#中是用于表示异步操作的对象,它位于System.Threading.Tasks命名空间中。想了解更多C#中各种用法的相关内容,可以阅读本专题下面的文章。

2024.03.14

2595

11

C# 并发与异步编程
C# 并发与异步编程

本专题系统讲解 C# 异步编程与并发控制,重点介绍 async 和 await 关键字、Task 类、线程池管理、并发数据结构、死锁与线程安全问题。通过多个实战项目,帮助学习者掌握 如何在 C# 中编写高效的异步代码,提升应用的并发性能与响应速度。

2026.02.03

292

18

C# 多线程与异步编程
C# 多线程与异步编程

本专题深入讲解 C# 中多线程与异步编程的核心概念与实战技巧,包括线程池管理、Task 类的使用、async/await 异步编程模式、并发控制与线程同步、死锁与竞态条件的解决方案。通过实际项目,帮助开发者掌握 如何在 C# 中构建高并发、低延迟的异步系统,提升应用性能和响应速度。

2026.02.06

369

20

C# ASP.NET Core微服务架构与API网关实践
C# ASP.NET Core微服务架构与API网关实践

本专题围绕 C# 在现代后端架构中的微服务实践展开,系统讲解基于 ASP.NET Core 构建可扩展服务体系的核心方法。内容涵盖服务拆分策略、RESTful API 设计、服务间通信、API 网关统一入口管理以及服务治理机制。通过真实项目案例,帮助开发者掌握构建高可用微服务系统的关键技术,提高系统的可扩展性与维护效率。

2026.03.11

611

24

C# Unity游戏开发与ECS架构实践
C# Unity游戏开发与ECS架构实践

本专题聚焦 C# 在 Unity 游戏开发中的应用,系统讲解 ECS(Entity-Component-System)架构设计、游戏对象管理、性能优化与内存控制策略。通过实际游戏案例,帮助开发者构建高性能、结构清晰的游戏系统,提高游戏开发效率与运行性能。

2026.04.13

309

20

C++类型转换方式
C++类型转换方式

本专题整合了C++类型转换相关内容,想了解更多相关内容,请阅读专题下面的文章。

2025.07.15

2162

23

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Conan 2 Essentials 免费课程
Conan 2 Essentials 免费课程

共0课时 | 0人学习

CMake 与 Conan 集成实践
CMake 与 Conan 集成实践

共0课时 | 0人学习

Conan 2 高级依赖模型介绍
Conan 2 高级依赖模型介绍

共0课时 | 0人学习