Python.NET事件与委托详解：让Python函数接管C回调与事件订阅

Python.NET事件与委托详解让Python函数接管C#回调与事件订阅【免费下载链接】pythonnetPython for .NET is a package that gives Python programmers nearly seamless integration with the .NET Common Language Runtime (CLR) and provides a powerful application scripting tool for .NET developers.项目地址: https://gitcode.com/gh_mirrors/py/pythonnetPython.NET是连接 Python 与 .NET 运行时的桥梁。本指南聚焦它最实用的两大特性委托Delegate与事件Event——让普通的 Python 函数直接接管 C# 的回调与事件订阅用一行就能把事件处理逻辑交给 Python几乎零样板代码。一、委托与事件30 秒理解核心概念如果你熟悉 Python 的函数式风格会很快理解这两个概念概念C# 中的角色对应到 Python委托 Delegate一个函数指针类型保存可调用对象≈ 一个可调用对象函数/方法事件 Event基于委托的安全广播机制支持/-订阅与退订≈ 订阅者列表Python.NET 的关键能力在于双向打通✅ 用 Python 函数实现 C# 委托类型得到真正的托管委托不是包装器可直接传给任何接受该委托类型的 C# API✅ 用 Python 可调用对象订阅 C# 事件完整支持 C# 风格的/-语法✅ 事件触发时自动处理 GIL 加锁线程安全地调用回 Python 代码。二、用 Python 函数实现 C# 委托假设 C# 侧定义了如下委托类型参考测试工程 src/testing/delegatetest.cs 中的StringDelegatepublic delegate string StringDelegate();Python.NET 允许你把任意可调用对象包装成该类型的委托实例。常见写法有三种import clr clr.AddReference(Python.Test) from Python.Test import DelegateTest, StringDelegate def hello(): return hello d StringDelegate(hello) # ① 普通函数 d StringDelegate(inst.hello) # ② 实例方法 d StringDelegate(inst) # ③ 实现了 __call__ 的可调用对象 ob DelegateTest() print(ob.CallStringDelegate(d)) # C# 代码调用它 → 执行 Python 的 hello() → 输出 hello要点速记任何可调用对象都行函数、静态方法、类方法、实例方法、带__call__的对象均可返回类型强校验若 C# 委托要求返回boolPython 函数却返回1调用时会抛TypeError见 tests/test_delegate.py 中的test_bool_delegate支持out/ref参数Python 侧通过返回值填充输出参数——单个 out 参数直接返回值多个时返回元组依次为(返回值, out1, out2, ...)格式不符会抛出清晰的类型错误。三、订阅 C# 事件Python 版的语法Python.NET 把 C# 事件当作一等对象并还原了 C# 惯用的语法糖。以测试类EventTestsrc/testing/eventtest.cs为例ob EventTest() def on_event(sender, args): print(事件触发数据 , args.value) ob.PublicEvent on_event # 订阅语法与 C# 完全一致 ob.OnPublicEvent(EventArgsTest(10)) # C# 触发事件 → 执行上面的 Python 函数 ob.PublicEvent - on_event # 退订几个值得注意的行为均已在 tests/test_event.py 中验证多播事件multicast多个 Python 处理函数可以依次事件触发时按注册顺序全部执行重复添加会重复触发同一函数加两次触发时执行两次需要-两次才能完全退订退订未知处理函数会抛ValueError避免静默失败的坑实例方法可作处理函数但必须是绑定的方法inst.handler可以Class.handler不行静态事件同样支持EventTest.PublicStaticEvent handler。四、幕后机制它到底做了什么这部分帮助你在排查问题时知其所以然源码位于src/runtime/目录动态生成 C# 调度器DelegateManager.cs 在首次遇到某委托类型时用反射发射Reflection.Emit即时生成一个与该委托签名完全匹配的托管类其Invoke方法打包参数后转发给基类Dispatcher.DispatchGIL 保护下调用 PythonDispatch先获取 GIL把 C# 参数转换回 Python 对象调用你的 Python 函数再把结果转换回 .NET 类型返回事件绑定与注册表访问事件属性时返回绑定事件对象EventObject.cs 描述符 EventBinding.cs/-由EventBinding的__iadd__/__isub__实现所有已注册的处理函数记录在 EventHandlerCollection.cs 的哈希表中保证-能精确移除、委托对象能被 GC 及时回收 Python 引用。一句话总结Python 函数 → 生成真·托管委托 → 注册到 C# 事件 → 触发时自动持 GIL 回调 Python。五、常见坑点清单 ⚠️坑点现象解决传入不可调用对象创建委托时TypeError确保传入函数/方法/__call__对象未绑定方法作处理函数事件触发时TypeError用inst.handler而非Class.handler参数个数不匹配触发事件时TypeError处理函数签名需与委托签名一致参数可少不可多返回值类型不符TypeError严格匹配委托声明的返回类型-未注册过的处理函数ValueError: unknown event handler退订前确认确实过六、想深入关键源码地图文件路径职责src/runtime/DelegateManager.cs动态生成委托调度器核心回调入口src/runtime/Types/EventObject.csCLR 事件的 Python 描述符src/runtime/Types/EventBinding.cs实现/-语法糖src/runtime/Util/EventHandlerCollection.cs处理函数注册表支持按实例隔离tests/test_delegate.py / tests/test_event.py委托与事件的完整测试用例doc/source/python.rst官方文档中的 Delegates and Events 章节七、总结Python.NET 让Python 函数接管 C# 回调变得极其简单委托把可调用对象传给 C# 委托类型即可得到真·托管委托支持out/ref与多播组合事件直接使用/-订阅与退订多播、静态事件、函数/方法/可调用对象全部支持机制可靠动态代码生成 GIL 自动加锁 引用精确回收线程安全且内存干净。掌握了这两大特性你就能在 .NET 应用里用 Python 编写灵活的事件驱动逻辑享受两种生态的最佳组合 【免费下载链接】pythonnetPython for .NET is a package that gives Python programmers nearly seamless integration with the .NET Common Language Runtime (CLR) and provides a powerful application scripting tool for .NET developers.项目地址: https://gitcode.com/gh_mirrors/py/pythonnet创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考