.NET 8 WinForms自定义控件DropZone设计器代码丢失问题求助

API 探路者

2026-6-23

.NET 8 WinForms设计器自定义控件DropZone拖放问题

我们将WinForms项目升级至.NET 8，转换过程的少量问题已修复，但发现疑似.NET 8 WinForms设计器的Bug：

我们有一个自定义控件gttDXGridDashboard，其中包含标记为“DropZone”的PanelControl（DevExpress容器控件），在设计器中可向该区域拖放控件，此功能在.NET Framework下正常，但升级到.NET 8后出现问题。

自定义控件代码片段

[Designer(typeof(UserControlDesigner))]
[Serializable]
public partial class gttDXGridDashboard : UserControl
{ 
  // 定义名为"DropZone"的属性
  [Category("Appearance")]
  [DesignerSerializationVisibility(DesignerSerializationVisibility.Content)]
  public PanelControl DropZone
  {
      get { return panelControlCustom; }
  }

  // ...
}

public class UserControlDesigner : ParentControlDesigner
{
    public override void Initialize(IComponent component)
    {
        base.Initialize(component);

        if (Control is gttDXGridDashboard dashboard)
        {
            bool result = EnableDesignMode(dashboard.DropZone, "DropZone");
            // 该输出从未显示，可能因为控件来自工具箱？
            Console.WriteLine($"EnableDesignMode(dashboard.DropZone, \"DropZone\") = {result}");
        }
    }
}

问题现象

在包含gttDXGridDashboard的窗体中，DropZone内有按钮时，designer.cs中原本存在以下代码：

// gttDXGridDashboardList.DropZone
// 
this.gttDXGridDashboardList.DropZone.Controls.Add(this.gttDXSimpleButtonAddMultipleChassis);

但升级到.NET 8后，当向DropZone拖放新控件或移动现有按钮时，上述代码会被移除，按钮仍存在于窗体但无父容器，导致不可见且无法使用。我们尝试更新包、重建项目、重启VS均无效。

后续测试发现

自定义按钮的OnParentChanged事件仅在父容器设为DropZone时触发，移动按钮时未触发；
测试窗体中拖放按钮后，designer.cs代码变为将控件添加到gttDXGridDashboard而非DropZone，推测.NET 8中ParentControlDesigner失效，EnableDesignMode未执行，且OnDragOver重写也不再生效。

我们需要的帮助

DropZone的定义是否有误？
这是否是已知Bug，有无修复/临时解决方案？
若无法解决，如何查找无父容器的控件？

问题解答

1. DropZone的定义是否有误？

DropZone的属性定义本身无语法错误，但结合.NET 8设计器行为，可做两点优化：

确保panelControlCustom在控件构造函数中已完成初始化，且未被意外修改父容器；

添加[ReadOnly(true)]属性，防止设计器意外修改DropZone实例：

[Category("Appearance")]
[DesignerSerializationVisibility(DesignerSerializationVisibility.Content)]
[ReadOnly(true)]
public PanelControl DropZone
{
    get { return panelControlCustom; }
}

2. 是否为已知Bug及临时解决方案？

这是.NET 8 WinForms设计器中关于ParentControlDesigner.EnableDesignMode的已知兼容性问题，.NET 7到.NET 8过渡中设计器组件初始化逻辑调整，导致部分自定义设计器代码未正确执行。

临时解决方案：

方案一：重写设计器拖放方法
手动处理拖放逻辑，确保控件被添加到DropZone：

public class UserControlDesigner : ParentControlDesigner
{
    private gttDXGridDashboard _dashboard;

    public override void Initialize(IComponent component)
    {
        base.Initialize(component);
        _dashboard = component as gttDXGridDashboard;
        if (_dashboard != null)
        {
            EnableDesignMode(_dashboard.DropZone, "DropZone");
        }
    }

    protected override void OnDragOver(DragEventArgs de)
    {
        if (_dashboard != null && _dashboard.DropZone.ClientRectangle.Contains(_dashboard.DropZone.PointToClient(new Point(de.X, de.Y))))
        {
            de.Effect = DragDropEffects.Copy;
        }
        else
        {
            base.OnDragOver(de);
        }
    }

    protected override void OnDragDrop(DragEventArgs de)
    {
        if (_dashboard != null && _dashboard.DropZone.ClientRectangle.Contains(_dashboard.DropZone.PointToClient(new Point(de.X, de.Y))))
        {
            var components = de.Data.GetData(typeof(System.Windows.Forms.Control[])) as Control[];
            if (components != null)
            {
                foreach (Control c in components)
                {
                    _dashboard.DropZone.Controls.Add(c);
                    RaiseComponentChanged(TypeDescriptor.GetProperties(_dashboard.DropZone)["Controls"], null, _dashboard.DropZone.Controls);
                }
            }
        }
        else
        {
            base.OnDragDrop(de);
        }
    }
}

方案二：替换设计器类型
尝试使用ContainerControlDesigner替代ParentControlDesigner，部分场景下可恢复子控件设计模式：

[Designer(typeof(System.Windows.Forms.Design.ContainerControlDesigner))]
[Serializable]
public partial class gttDXGridDashboard : UserControl
{
    // ... 原有代码
}

方案三：手动维护designer.cs
若上述方案无效，可手动保留DropZone.Controls.Add(...)代码，注释掉自动生成的错误添加逻辑，注意每次修改控件后检查修正。

3. 如何查找无父容器的控件？

无父容器的控件会存在于窗体的Components集合中，可通过以下代码遍历查找：

// 遍历窗体Components集合，筛选无父控件的Control
var orphanedControls = this.Components.Cast<IComponent>()
    .OfType<Control>()
    .Where(c => c.Parent == null)
    .ToList();

foreach (var ctrl in orphanedControls)
{
    // 将控件重新添加到DropZone或其他容器
    gttDXGridDashboardList.DropZone.Controls.Add(ctrl);
}

也可在设计器的文档大纲窗口查看，无父容器的控件会直接显示在窗体节点下，而非DropZone节点内。

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

.NET 8 WinForms自定义控件DropZone设计器代码丢失问题求助

自定义控件代码片段 #

问题现象 #

后续测试发现 #

我们需要的帮助 #

问题解答 #