如何为自定义用户控件库安装设计时支持

一、正确部署设计时DLL（Design DLL） #

设计时DLL是给Visual Studio设计器提供专属支持的文件，必须让VS能正确找到它，两种可行方法：

• 同目录部署（最简单）
  把Library.Schedule.dll和Library.Schedule.Design.dll放在同一个文件夹下，然后从这个文件夹里将主DLL添加到工具箱。VS会自动扫描同目录的设计时DLL并加载。
  注意：如果之前加过旧版本，先从工具箱移除旧控件，清理设计器缓存（见下文）后再重新添加。

• 注册到GAC（适合多项目共用）
  如果你的控件库是强签名的（有.snk密钥文件），可以把两个DLL都注册到全局程序集缓存：

  1. 以管理员身份打开开发者命令提示符
  2. 执行：gacutil /i "你的DLL路径\Library.Schedule.dll"
  3. 再执行：gacutil /i "你的DLL路径\Library.Schedule.Design.dll"
     注册后VS会自动从GAC读取设计时支持，无需指定路径。

二、修复控件被放到托盘的问题 #

控件被拖到设计器底部托盘，通常是因为设计器没识别到它是可视化控件，或者设计时支持未正常加载：

• 检查控件基类
  打开控件源代码，确认你的控件类继承自System.Windows.Forms.UserControl，而不是Component这类非可视化基类。正确的类定义应该类似：

  public class ScheduleControl : UserControl
  {
      // 控件逻辑代码
  }
  

• 清理VS设计器缓存
  旧缓存可能导致配置残留，按以下步骤清理：

  1. 关闭所有VS实例
  2. 删除这两个目录的文件：
     • %LOCALAPPDATA%\Microsoft\VisualStudio\<你的VS版本号>\Designer\ShadowCache
     • %USERPROFILE%\AppData\Local\Temp\VSDesigner
  3. 重启VS后重新添加控件到工具箱。

• 验证设计时DLL的内容
  设计时DLL里必须有对应控件的设计器类，一般继承自ControlDesigner。检查Design DLL的源代码，确认有类似结构：

  [Designer(typeof(ScheduleControlDesigner))]
  public class ScheduleControl : UserControl { }
  
  public class ScheduleControlDesigner : ControlDesigner
  {
      // 设计时相关逻辑，比如属性面板定制、布局约束等
  }
  

  如果设计器类缺失或代码有问题，设计器会把控件当成普通组件丢到托盘。

三、调试设计时加载（可选） #

如果以上步骤都没解决，可以调试确认设计DLL是否正常加载：

1. 打开控件库的解决方案
2. 点击调试 -> 附加到进程，找到并附加到devenv.exe（VS主进程）
3. 在设计器类或控件构造函数里加断点
4. 新建一个WinForms项目，尝试拖放控件，触发断点后检查是否有异常或加载失败的情况。

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