Autodesk.Revit.DB.BuiltInFailures.HostObjFailures

简介

Autodesk.Revit.DB.BuiltInFailures.HostObjFailures 是 Revit 中的一个枚举类型，用于表示可能发生的与 Revit 中主机对象相关的失败操作。

枚举值

可以被修复的失败

• InconsistentConstraints ：主机元素的约束限制不一致。
• InvalidConstraints ：主机元素的约束无效。
• InvalidInsertionPoint ：特定于主机族的属性无效。
• InvalidStructure ：主机元素的结构无效。
• NotAttached ：主机元素未提供必需的托臂或吊杆支撑。
• UnsupportedCategory ：被放置的实例的类别不受支持。

不能被修复的失败

• AmbiguousHost ：过程中，存在模棱两可的情况。
• InvalidParam ：无效的参数。
• LockedConstraints ：指定的约束已被锁定，导致操作无法执行。
• MismatchElementType ：主机元素的类型与要求的类型不匹配。
• NoInsertsAllowed ：不允许插入元素。
• NoRoomCalculation ：从计算表面中删除房间。
• NotIntersecting ：要求元素无法与参考平面相交。
• NotParallel ：要求元素无法与参考平面平行。
• OutOfDate ：比对操作无法更新。
• SharedNotOwned ：被操作的元素未在该文档中。
• WrongHost ：要求元素未与正确的主机元素配对。

使用示例

try
{
    // 执行 Revit 操作
}
catch (Autodesk.Revit.Exceptions.InvalidOperationException ex)
{
    var failure = ex.GetBuiltInFailure();
    if (failure == Autodesk.Revit.DB.BuiltInFailures.HostObjFailures.InconsistentConstraints)
    {
        // 当主机元素的约束限制不一致时，执行的代码块
    }
    else if (failure == Autodesk.Revit.DB.BuiltInFailures.HostObjFailures.UnsupportedCategory)
    {
        // 当被放置的实例的类别不受支持时，执行的代码块
    }
    else
    {
        // 其他情况下的处理代码
    }
}

相关函数

Autodesk.Revit.Exceptions.InvalidOperationException.GetBuiltInFailure()

返回操作失败所对应的 Autodesk.Revit.DB.BuiltInFailures 枚举类型的值，如果不是内置的操作失败，则返回 null。

参考资料

• Autodesk.Revit.DB.BuiltInFailures