如何在Visual Studio中自动注册.NET 5类库以支持COM互操作

报错原因说明 #

RegisterForComInterop是.NET Framework专属的项目配置属性，.NET 5+的COM互操作机制进行了重构，不再兼容旧的注册逻辑，保留该属性会触发.NET Framework时代的注册工具，找不到.NET 5运行时程序集，因此抛出MSB3217错误。

实现自动注册的配置方法 #

你只需要调整csproj配置，添加必要属性+后期生成事件即可实现和.NET Framework一致的编译后自动注册效果：

完整csproj配置示例 #

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <TargetFramework>net5.0</TargetFramework>
    <!-- 启用COM主机，生成.comhost.dll文件 -->
    <EnableComHosting>true</EnableComHosting>
    <!-- 禁用旧版COM注册逻辑，避免报错 -->
    <RegisterForComInterop>false</RegisterForComInterop>
    <!-- 可选：启用免注册COM支持，不需要的可以去掉 -->
    <EnableRegFreeCom>true</EnableRegFreeCom>
  </PropertyGroup>

  <!-- 添加后期生成事件，编译完成后自动注册COM组件 -->
  <Target Name="AutoRegisterComAfterBuild" AfterTargets="Build">
    <Exec Command="regsvr32 /s &quot;$(TargetDir)$(ProjectName).comhost.dll&quot;" />
  </Target>

  <!-- 可选：添加清理事件，清理项目时自动卸载COM组件 -->
  <Target Name="AutoUnregisterComOnClean" AfterTargets="Clean">
    <Exec Command="regsvr32 /s /u &quot;$(TargetDir)$(ProjectName).comhost.dll&quot;" />
  </Target>
</Project>

注意事项 #

• 必须以管理员身份运行Visual Studio，COM注册需要写入系统注册表，普通权限会执行失败
• 你的现有类代码可以正常运行，建议额外补充[ClassInterface(ClassInterfaceType.AutoDual)]特性到HelloWorld类上，避免COM调用时出现方法识别异常
• 编译成功后COM组件会自动完成注册，使用体验和.NET Framework完全一致

内容的提问来源于stack exchange，提问作者Denis Znanec