Autodesk.Revit.UI.IExternalCommand

Autodesk.Revit.UI.IExternalCommand 接口提供了一种创建Revit外部命令的方式。该接口包含一个Execute()方法，外部命令需要实现这个方法以定义其行为。

方法

Execute(Document document, ref string message, ElementSet elements) : Result

• document：当前的Revit文档。
• message：执行命令时出现的错误消息。
• elements：包含要由命令处理的元素的集合。
• Result：外部命令执行后的状态。

示例

public class MyExternalCommand : IExternalCommand
{
    public Result Execute(Document document, ref string message, ElementSet elements)
    {
        try
        {
            // 处理逻辑
            return Result.Succeeded;
        } 
        catch (Exception ex)
        {
            message = ex.Message;
            return Result.Failed;
        }
    }
}

注意事项

• Execute 方法应该是线程安全的，并可重入
• 使用 try-catch 块来处理执行期间出现的异常
• 当出现错误时，请将相应的错误信息存储在 message 参数中并返回 Result.Failed
• 函数应该尽可能地快速执行并返回结果，避免长时间挂起Revit界面

参考

https://www.autodesk.com/developer-network/platform-technologies/revit