VS2022添加自定义控件至Toolbox报错：DLL无可放置组件

可能的报错原因 #

• 控件类未继承WinForms/WPF的标准控件基类（比如System.Windows.Forms.Control、System.Windows.Controls.UserControl），或未标记工具箱可识别特性——工具箱仅兼容符合规范的控件类
• DLL的.NET框架版本与当前VS项目不匹配，比如DLL基于.NET Framework 4.8编译，而项目使用.NET Core 3.1，版本错位会直接导致识别失败
• 控件类虽声明为public，但未添加[ToolboxItem(true)]特性，工具箱会自动忽略这类未标记的控件
• DLL编译不完整或存在错误，比如编译过程有未处理的警告/错误，生成的DLL本身失效；或是项目类型为普通类库，而非控件库项目
• VS工具箱缓存文件损坏，导致无法识别新的控件组件

针对性解决方法 #

• 检查控件类代码规范
  打开生成xxx.dll的项目，确保自定义控件类：
  1. 继承正确基类：WinForms控件需继承System.Windows.Forms.Control或UserControl，WPF控件需继承System.Windows.Controls.UserControl
  2. 添加[ToolboxItem(true)]特性（需引用System.ComponentModel命名空间），示例代码：

     using System.ComponentModel;
     using System.Windows.Forms;
     
     [ToolboxItem(true)]
     public class CustomControl : Control
     {
         // 你的控件逻辑代码
     }
     

• 核对.NET版本兼容性
  右键DLL项目→属性→应用程序，查看目标框架版本；再检查当前VS项目的目标框架，确保DLL版本不高于项目版本（比如项目用4.7.2，DLL用4.6.1是兼容的，反之则不行）
• 重新编译DLL
  清理DLL项目的bin和obj文件夹，重新生成解决方案，确保编译过程无错误；生成后确认bin目录内的DLL为最新版本，且未被其他进程占用
• 重置VS工具箱缓存
  1. 关闭Visual Studio
  2. 找到VS工具箱缓存文件（比如VS2022的路径为C:\Users\[你的用户名]\AppData\Local\Microsoft\VisualStudio\17.0_xxxx\Toolbox.tbd，xxxx为随机字符），删除该文件
  3. 重新打开VS，再次尝试添加DLL
• WinForms控件可尝试手动注册
  以管理员身份打开命令提示符，运行以下命令（替换为你的DLL实际路径）：

  regasm.exe "C:\你的文件路径\xxx.dll" /codebase
  

  注册完成后回到VS的「选择项」窗口，重新查找该控件

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