Autodesk.Revit.DB.BuiltInFailures.DebugTabBindingFailures

概述

Autodesk.Revit.DB.BuiltInFailures.DebugTabBindingFailures 是 Revit API 中的一个预定义失败类型，用于表示 Revit 界面中“调试选项卡数据绑定失败”的错误。

使用方法

此失败类型可以在涉及数据绑定的代码段中使用。当数据绑定失败时，可以创建并添加一个 DebugTabBindingFailures 对象到 FailuresAccessor 中，从而触发 Revit 显示相应的错误对话框。

try {
    // some code that may cause data binding failure
}
catch(Exception ex) {
    var failure = new Autodesk.Revit.DB.FailureMessage(Autodesk.Revit.DB.BuiltInFailures.DebugTabBindingFailures);
    failure.SetDescriptionText("Failed to bind data: " + ex.InnerException.Message);
    failure.SetAdditionalIdInfo("my_binding");
    failuresAccessor.Publish(failure);
}

可以通过调用 SetDescriptionText 方法来设置错误对话框的详细描述信息。SetAdditionalIdInfo 方法用于设置可以唯一标识此失败的附加信息，方便后续排查问题。

示例

以下示例演示了如何在 Revit 插件中捕获数据绑定失败并显示相应的错误信息。

public Result Execute(ExternalCommandData commandData, ref string message, ElementSet elements)
{
    var doc = commandData.Application.ActiveUIDocument.Document;
    var uiApp = commandData.Application;
    var uiDoc = uiApp.ActiveUIDocument;

    using (var t = new Transaction(doc, "Binding Failure Demo")) {
        t.Start();

        try {
            var bindingSource = new DataTable();
            bindingSource.Columns.Add("Name");
            bindingSource.Columns.Add("Age", typeof(int));
            bindingSource.Columns.Add("Gender");

            bindingSource.Rows.Add("Alice","23","Female");
            bindingSource.Rows.Add("Bob","28","Male");
            bindingSource.Rows.Add("Charlie","32","Unknown");

            var form = new Form1(bindingSource);
            form.Show();
        }
        catch(Exception ex) {
            var failuresAccessor = new FailuresAccessor();
            failuresAccessor = doc.PostFailure(Autodesk.Revit.DB.BuiltInFailures.DebugTabBindingFailures);
            var failure = new Autodesk.Revit.DB.FailureMessage(Autodesk.Revit.DB.BuiltInFailures.DebugTabBindingFailures);
            failure.SetDescriptionText("Failed to bind data: " + ex.InnerException.Message);
            failure.SetAdditionalIdInfo("my_binding");
            failuresAccessor.Publish(failure);
        }

        t.Commit();
    }

    return Result.Succeeded;
}

参考资料

• Autodesk.Revit.DB.BuiltInFailures.DebugTabBindingFailures Class