Autodesk.Revit.DB.FailureDefinitionRegistry

Autodesk.Revit.DB.FailureDefinitionRegistry是Revit API中的一个类，用于管理Revit失败操作的定义。

构造函数

Autodesk.Revit.DB.FailureDefinitionRegistry类有一个无参的构造函数，用于创建一个空的失败操作定义注册表。

方法

AddFailureDefinition

public void AddFailureDefinition(FailureDefinition failureDefinition)

向注册表中添加一个失败操作的定义。

参数：

• failureDefinition：要添加的失败操作的定义。

GetFailureDefinitionIds

public IList<FailureDefinitionId> GetFailureDefinitionIds()

获取注册表中所有失败操作的定义的Id。

返回值：

• IList<FailureDefinitionId>：所有失败操作的定义的Id列表。

GetFailureDefinition

public FailureDefinition GetFailureDefinition(FailureDefinitionId failureDefinitionId)

根据Id获取注册表中一个失败操作的定义。

参数：

• failureDefinitionId：要获取的失败操作的定义的Id。

返回值：

• FailureDefinition：失败操作的定义。

TryAddCriteria

public bool TryAddCriteria(FailureDefinitionId failureDefinitionId, BuiltInFailures preDefinedFailure, BuiltInParameter builtInParameter, params string[] additionalElements)

向失败操作的定义中添加一个元素标准。

参数：

• failureDefinitionId：要添加标准的失败操作的定义的Id。
• preDefinedFailure：预定义的失败类型。
• builtInParameter：内置参数。
• additionalElements：附加的元素。

返回值：

• bool：添加成功返回true，添加失败返回false。

示例

var failureRegistry = new FailureDefinitionRegistry();

var myFailure = FailureDefinition.Create("My Failure", FailureSeverity.Warning);

failureRegistry.AddFailureDefinition(myFailure);

var result = failureRegistry.GetFailureDefinitionIds();

foreach(var id in result)
{
    var definition = failureRegistry.GetFailureDefinition(id);
    if(definition != null)
    {
        failureRegistry.TryAddCriteria(id, BuiltInFailures.RoomFailures.FailsToMeetAdjacencyRule, BuiltInParameter.ROOM_AREA, "Additional Element 1", "Additional Element 2");
    }
}

以上代码创建一个空的失败操作定义注册表，向其中添加一个名为“My Failure”的失败操作定义，并获取所有定义的Id。之后为所有添加的定义添加元素标准。

参考资料

• Autodesk.Revit.DB.FailureDefinitionRegistry class - Autodesk documentation：https://www.revitapidocs.com/2021/a5549517-8cc3-3a7a-c452-12c503ecd17d.htm