Revit 2022 API：删除的链接已从模型移除但UI仍可见

核心问题原因 #

1. 事务操作不规范：linkType.Unload(null)属于文档修改操作，必须放在事务启动后执行，你当前将其放在trans.Start()之前，会导致Revit文档状态异常。
2. 仅删除实例未清理链接类型：Revit UI的链接管理器显示的是RevitLinkType（链接类型定义），而非场景中的实例。你只删除了RevitLinkInstance，对应的类型仍留在项目中，所以UI里还能看到该链接。
3. 无效的Regenerate调用：事务内部调用doc.Regenerate()无意义，Revit会在事务提交后自动处理文档更新。

修正后的代码示例 #

public static void ProcessAndRemoveLinks(Document doc, UIDocument uiDoc)
{
    List<string> deletedLinkNames = new List<string>();

    // 收集所有链接实例
    FilteredElementCollector instanceCollector = new FilteredElementCollector(doc)
        .OfClass(typeof(RevitLinkInstance))
        .Cast<RevitLinkInstance>();

    // 筛选需要处理的链接类型ID，避免重复操作
    HashSet<ElementId> targetLinkTypeIds = new HashSet<ElementId>();
    foreach (RevitLinkInstance linkInstance in instanceCollector)
    {
        if (linkInstance.Name.Contains("_COM"))
        {
            targetLinkTypeIds.Add(linkInstance.GetTypeId());
            deletedLinkNames.Add(linkInstance.Name);
        }
    }

    if (targetLinkTypeIds.Count == 0)
        return;

    using (Transaction trans = new Transaction(doc, "移除_COM链接及类型"))
    {
        trans.Start();

        // 先删除所有目标链接实例
        foreach (RevitLinkInstance linkInstance in instanceCollector)
        {
            if (linkInstance.Name.Contains("_COM"))
            {
                doc.Delete(linkInstance.Id);
            }
        }

        // 删除无实例关联的链接类型
        foreach (ElementId typeId in targetLinkTypeIds)
        {
            RevitLinkType linkType = doc.GetElement(typeId) as RevitLinkType;
            if (linkType == null)
                continue;

            // 检查该类型是否还有剩余实例
            bool hasRemainingInstances = new FilteredElementCollector(doc)
                .OfClass(typeof(RevitLinkInstance))
                .Cast<RevitLinkInstance>()
                .Any(i => i.GetTypeId().Equals(typeId));

            if (!hasRemainingInstances)
            {
                linkType.Unload(null);
                doc.Delete(typeId);
            }
        }

        trans.Commit();
    }

    // 强制刷新UI与所有视图
    uiDoc.UpdateAllOpenViews();
    uiDoc.RefreshActiveView();
}

关键修正说明 #

• 事务包裹所有修改操作：卸载、删除实例、删除类型都放在事务内部，保证文档操作的原子性和状态一致性。
• 清理链接类型：只有当链接类型没有剩余实例时才删除，彻底从UI的链接管理器中移除目标链接。
• 正确的UI刷新：通过UpdateAllOpenViews()刷新所有打开的视图，配合RefreshActiveView()确保UI状态与文档同步。

额外注意事项 #

• 如果仅需删除场景实例、保留链接类型（方便后续重新链接），只需删除实例即可，此时UI链接管理器会显示该类型为"未载入"状态，属于Revit正常行为。
• 不要在事务内部调用doc.Regenerate()，该方法应在事务提交后、需要获取最新文档状态时使用。

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