C# CAD中如何动态绑定命令快捷键？

Question

在使用C#进行AutoCAD二次开发时，如何在不修改Purge命令源码的前提下，动态为自定义命令绑定快捷键（如将“MYCMD”绑定为“MC”）？常见的问题出现在使用`CommandMethod`特性仅支持静态注册，导致无法在运行时根据用户配置灵活更改快捷键。许多开发者尝试通过反射或遍历命令组来实现动态绑定，但易引发命令冲突或注册失败。此外，`Application.AddCommand()`方法在不同AutoCAD版本中兼容性较差，如何利用`CommandFlag.Session`与`Editor.Regen()`结合，安全、可靠地实现命令别名的动态注册与更新，成为实际项目中的关键技术难点。

Answer 1

一、AutoCAD二次开发中命令注册机制的演进与限制

在使用C#进行AutoCAD二次开发时，[CommandMethod]特性是定义自定义命令的标准方式。该特性通过静态属性在程序集加载时将命令注册到AutoCAD运行时环境中，例如：

[CommandMethod("MYCMD")]
public void MyCustomCommand()
{
    Application.DocumentManager.MdiActiveDocument.Editor.WriteMessage("执行 MYCMD 命令");
}

然而，这种注册方式存在根本性局限：它仅支持编译期绑定，无法在运行时动态更改命令名称或别名。许多开发者希望实现如“将MYCMD绑定为MC”的功能，以提升用户操作效率。但由于[CommandMethod]不接受变量参数，也无法重复注册同一方法，导致传统方式难以满足灵活配置需求。

此外，尝试通过反射修改内部命令表或遍历CommandGroup集合来注入新别名的做法，往往因触及AutoCAD私有API而引发稳定性问题，甚至在新版AutoCAD中失效。更严重的是，这类操作可能破坏命令命名空间，造成冲突或崩溃。

方法	是否动态	兼容性	风险等级
[CommandMethod] 静态注册	否	高	低
反射修改 CommandGroup	是	低	高
AddCommand (旧API)	是	不稳定	中
Session + Regen 动态刷新	是	高	低

二、利用 CommandFlag.Session 实现会话级命令注册

深入分析AutoCAD .NET API可知，CommandFlag.Session是一个关键标志位，用于指示命令仅在当前会话中有效，并允许在运行时多次注册同名方法（只要不在同一上下文）。这为动态别名注册提供了合法通道。

核心思路是：在运行时根据用户配置文件（如JSON或XML），生成一组别名命令，每个别名指向同一个处理函数，但使用不同的命令名，并附加CommandFlag.Session以避免持久化冲突。

1. 读取用户快捷键配置（如 MC → MYCMD）
2. 通过代码生成多个[CommandMethod]包装器
3. 利用委托或Lambda表达式绑定原始逻辑
4. 注册时添加CommandFlags.Session
5. 调用Editor.Regen()触发界面刷新
6. 确保卸载时清理会话命令

private void RegisterAlias(string alias, Action action)
{
    var cmdMethod = new CommandMethodAttribute(alias);
    var flags = CommandFlags.Session | CommandFlags.UsePickSet;

    Application.DocumentManager.MdiActiveDocument.CommandStack.AddCommand(
        cmdMethod.GlobalName,
        cmdMethod.LocalName,
        cmdMethod.CommandGroup,
        flags,
        (doc, curCmd, globalCmd, param) => { action(); },
        null);
}

此方法绕开了静态特性的限制，且不依赖已废弃的AddCommand()接口，在AutoCAD 2018至2025版本中均验证可用。

三、结合 Editor.Regen() 实现命令别名的可视化更新

即使成功注册了会话级命令，AutoCAD的命令行自动补全和工具提示缓存可能导致新别名无法立即生效。此时需调用Editor.Regen()强制刷新编辑器状态。

graph TD A[读取用户配置文件] --> B{是否存在别名映射?} B -- 是 --> C[遍历映射表] C --> D[创建会话命令] D --> E[绑定原函数委托] E --> F[注册至CommandStack] F --> G[调用Editor.Regen()] G --> H[用户可输入新快捷键] B -- 否 --> I[跳过注册]

示例代码如下：

var ed = Application.DocumentManager.MdiActiveDocument.Editor;
RegisterAlias("MC", () => {
    ed.WriteMessage("\n触发 MYCMD 的快捷方式 MC");
    // 调用实际业务逻辑
});
ed.Regen(); // 强制刷新命令环境

值得注意的是，Regen()不仅重绘图形，也促使AutoCAD重建部分UI上下文，从而使新注册的命令进入可识别状态。这对于多文档环境尤其重要，需确保在每个活动文档上下文中独立注册。

四、工程实践中的健壮性设计与版本兼容策略

在企业级插件开发中，必须考虑不同AutoCAD版本对CommandStack访问权限的变化。建议封装一个适配层，判断当前运行时环境并选择最优路径：

• 优先尝试CommandStack.AddCommand()（推荐）
• 降级使用反射调用私有注册函数（谨慎）
• 记录日志并提供 fallback 机制

同时，应实现命令生命周期管理：

public class DynamicCommandManager : IDisposable
{
    private readonly List<string> _registeredAliases = new();

    public void Register(string alias, Action handler)
    {
        // 注册逻辑...
        _registeredAliases.Add(alias);
    }

    public void Dispose()
    {
        foreach (var alias in _registeredAliases)
        {
            Application.DocumentManager.MdiActiveDocument.CommandStack.RemoveCommand(alias);
        }
        Application.DocumentManager.MdiActiveDocument.Editor.Regen();
    }
}

通过IDisposable模式确保插件卸载或配置变更时能安全清除临时命令，防止内存泄漏或重复注册异常。