SharpShell + .NET8 环境下为ToolStripMenuItem设置Image时触发Method not found异常

我之前也碰到过一模一样的问题，在SharpShell结合.NET8开发右键菜单扩展时，只要给ToolStripMenuItem的Image属性赋值就会抛出异常，去掉这行代码菜单又能正常工作。这个问题的核心原因其实是System.Drawing组件在.NET8中的兼容性适配问题——毕竟.NET8里System.Drawing.Common已经变成Windows专属组件，而且SharpShell的内部调用逻辑和新版.NET的API签名存在不匹配的情况。

下面是亲测有效的解决步骤：

1. 核对依赖包与项目配置 #

• 先去NuGet更新Microsoft.Windows.Compatibility和SharpShell包，确保两者都是适配.NET8的版本（优先选正式稳定版，没有的话可以尝试最新预发布版，SharpShell已经针对.NET8做了适配更新）。
• 修改项目的.csproj文件，明确指定Windows目标框架并启用System.Drawing支持：

  <PropertyGroup>
    <TargetFramework>net8.0-windows</TargetFramework>
    <UseWindowsForms>true</UseWindowsForms>
    <RuntimeIdentifiers>win-x64;win-x86</RuntimeIdentifiers>
  </PropertyGroup>
  
  <PropertyGroup Condition="'$(TargetFramework)' == 'net8.0-windows'">
    <UseSystemDrawing>true</UseSystemDrawing>
  </PropertyGroup>
  

2. 换一种图标赋值方式 #

直接给ToolStripMenuItem.Image赋值的方式容易触发API兼容问题，建议改用ImageList来统一管理图标：

// 初始化ImageList并添加你的图标对象
var menuImageList = new ImageList();
menuImageList.Images.Add(你的图标对象);

// 将ImageList绑定到上下文菜单
var contextMenu = new ContextMenuStrip();
contextMenu.ImageList = menuImageList;

// 通过ImageIndex关联图标到目标MenuItem
mainItem.ImageIndex = 0;

3. 部署时的关键细节 #

• 发布项目时选择自包含部署，并指定对应的Runtime Identifier（比如win-x64），把所有依赖的.NET组件打包进去，避免目标机器缺少必要的API。
• 注册Shell扩展时，一定要用管理员权限运行注册工具，并且注意和你的DLL位数匹配（x64 DLL对应64位系统注册，x86对应32位）。

附上你提供的日志内容，方便后续排查参考：

2024-08-31 10:03:49.113Z - explorer - SharpShell Diagnostics Initialised. Process explorer.
2024-08-31 10:03:49.132Z - explorer - SimpleContextMenu: Initializing shell extension...
2024-08-31 10:03:49.137Z - explorer - SimpleContextMenu: Shell extension initialised.
Parent folder: 
Items:
D:\Textdokument (neu) - Kopie -...

备注：内容来源于stack exchange，提问作者Johann Zajzev