PAYATHON 2026

C# Winforms TreeView 重命名后如何重新排序并避免崩溃?

数据阿明

在 AfterLabelEdit 中校验名称,并通过 BeginInvoke 延后调用 TreeView1.Sort()。事件处理程序返回后,控件会完成新标签的提交,再按更新后的 Text 排序。

右键菜单事件只需调用 BeginEdit()。名称有效时,安排好排序后即可返回,无须再次调用 e.Node.EndEdit(false)。

为什么直接调用 Sort 会出问题?

BeginEdit() 会启动标签编辑。如果紧接着调用 Sort(),用户还没有完成输入,排序会干扰正在进行的编辑。这与问题中编辑被中断的现象一致。

AfterLabelEdit 在用户结束输入后触发,但事件处理程序执行时,新文本还没有提交。Winforms 的 TreeView 源码先调用 OnAfterLabelEdit(e),再根据 e.CancelEdit 更新节点文本。因此,应使用 e.Label 校验新名称;此时立即排序,可能仍会读到旧的 e.Node.Text。TreeView 源码

在处理编辑通知期间同步排序,也可能干扰控件完成编辑。原问题没有提供异常类型和调用栈,无法仅凭这些代码断定崩溃是由无限递归或某一种异常引起的。

如何调整事件处理代码?

保留初始化时的 Sorted = true,在标签通过校验后排队执行排序。BeginInvoke 会异步安排委托在控件所属的 UI 线程上执行。这里用它将排序延后到当前事件处理返回之后。Control.BeginInvoke 文档

将以下代码放入现有 Form 类,替换对应方法。确保 Load、菜单 Click 和 AfterLabelEdit 已绑定到这些处理程序,并避免重复绑定。

private void Form1_Load(object sender, EventArgs e)
{
    TreeView1.LabelEdit = true;
    TreeView1.Sorted = true;
}

private void renameToolStripMenuItem_Click(object sender, EventArgs e)
{
    if (TreeView1.SelectedNode != null)
    {
        TreeView1.SelectedNode.BeginEdit();
    }
}

private void treeView1_AfterLabelEdit(
    object sender, NodeLabelEditEventArgs e)
{
    if (e.Label == null || e.CancelEdit)
    {
        return;
    }

    string errorMessage = null;

    if (e.Label.Length == 0)
    {
        errorMessage =
            "Invalid tree node label.\nThe label cannot be blank";
    }
    else if (e.Label.IndexOfAny(new char[] { '@', '.', ',', '!' }) >= 0)
    {
        errorMessage =
            "Invalid tree node label.\n" +
            "The invalid characters are: '@','.', ',', '!'";
    }

    if (errorMessage != null)
    {
        e.CancelEdit = true;
        MessageBox.Show(errorMessage, "Node Label Edit");

        TreeNode node = e.Node;
        TreeView1.BeginInvoke(new MethodInvoker(delegate
        {
            if (!TreeView1.IsDisposed &&
                !TreeView1.Disposing &&
                node.TreeView == TreeView1)
            {
                node.BeginEdit();
            }
        }));

        return;
    }

    TreeView1.BeginInvoke(new MethodInvoker(delegate
    {
        if (!TreeView1.IsDisposed && !TreeView1.Disposing)
        {
            TreeView1.Sort();
        }
    }));
}

示例需要 System.Windows.Forms 命名空间,并保留了原有校验规则:拒绝空字符串,以及包含 @、.、,、! 的名称。输入无效时,代码会取消本次修改,并延后重新进入编辑;输入有效时,控件正常提交标签,随后执行排序。

使用时需要注意什么?

  • e.Label == null 时直接返回,不安排排序。用户取消编辑时,该属性为 null。NodeLabelEditEventArgs.Label 文档
  • Sorted = true 用于启用自动排序。现有节点文本改变后,应显式调用 Sort();反复设置 Sorted = true 不能作为强制重新排序的方法。TreeView.Sorted 文档
  • 示例统一使用 TreeView1。如果原描述中的 TreeViewDecks 指向另一个控件,需要确认实际排序的是被重命名节点所属的 TreeView。
  • BeginUpdate() 和 EndUpdate() 用于减少批量更新时的重绘,不能替代这里对排序时机的调整。

如果替换后仍然崩溃,应查看实际异常和调用栈,确认错误发生在标签编辑、延后的 Sort(),还是其他事件处理程序中。仅凭“应用崩溃”无法进一步确定原因。

备注:内容仅供参考。