Autodesk.Revit.DB.IFailuresPreprocessor

Autodesk.Revit.DB.IFailuresPreprocessor 是 Revit API 提供的接口类，用于处理在执行操作时产生的失败信息。该接口允许开发者自定义失败信息的处理方式，例如跳过失败元素或更改失败信息的级别等。

方法

IFailuresPreprocessor 接口中定义了一个方法，名为 ProcessFailures，该方法接收一个 FailuresAccessor 类型的参数，表示一个包含失败信息的访问器对象，开发者可以通过该对象获取失败信息并进行处理。

void ProcessFailures(FailuresAccessor failuresAccessor);

实现

开发者需要实现 IFailuresPreprocessor 接口中的方法来处理失败信息。在实现该接口时，需要注意以下几点：

• ProcessFailures 方法是必须实现的。
• 开发者需要对传入的 failuresAccessor 对象进行判断，判断其中是否存在失败信息。
• 开发者需要对每个失败信息进行处理，可以选择性地忽略某些失败信息，或改变其级别等。

以下示例代码展示了一个简单的 IFailuresPreprocessor 接口的实现：

public class CustomFailuresPreprocessor : IFailuresPreprocessor
{
    public void ProcessFailures(FailuresAccessor failuresAccessor)
    {
        IList<FailureMessageAccessor> failures = failuresAccessor.GetFailureMessages();
        foreach (FailureMessageAccessor failure in failures)
        {
            failure.SetSeverity(FailureSeverity.Warning);
            if (failure.HasId)
            {
                // 处理特定元素的失败信息
            }
        }
    }
}

上述代码中，实现了 IFailuresPreprocessor 接口的一个名为 CustomFailuresPreprocessor 的类，该类覆盖了 IFailuresPreprocessor 接口的 ProcessFailures 方法。在 ProcessFailures 方法中，首先获取所有失败信息并进行遍历，然后将其级别更改为 Warning。最后，对具有 ID 的失败信息进行特殊的处理。

使用

在使用 IFailuresPreprocessor 接口时，需要创建一个 IFailuresPreprocessor 类的实例，并通过 FailureHandlingOptions 类的 SetFailuresPreprocessor 方法将其传递给上传输操作的选项对象中。以下是一个示例：

CustomFailuresPreprocessor failuresPreprocessor = new CustomFailuresPreprocessor();
FailureHandlingOptions options = new FailureHandlingOptions();
options.SetFailuresPreprocessor(failuresPreprocessor);
doc.LoadFamily(path, options);

在上述示例中，首先创建了 CustomFailuresPreprocessor 对象实例，然后创建了一个 FailureHandlingOptions 对象，并通过 SetFailuresPreprocessor 方法将 CustomFailuresPreprocessor 对象传递给它，最后通过该对象中的 LoadFamily 方法加载族文件时，将选项对象作为参数传递给该方法，从而使得上传输操作应用了自定义的失败信息处理方式。