git:20260909.72be554 to git:20260911.ad2889a

---

name: ifoxcad

description: "Use when developing AutoCAD plugins with .NET/C# — entity creation, layer management, block references, transaction handling. iFoxCAD: AutoCAD .NET secondary development framework with simplified API wrappers."

tags:

- autocad

- dotnet

- csharp

- cad

- dxf

- dwg

- plugin

---

> **项目地址：** <https://gitee.com/inspirefunction/ifoxcad>

>

> **GitHub 镜像：** <https://github.com/inspirefunction/ifoxcad>

>

> **NuGet：** `IFoxCAD.Cad`

>

> **许可证：** LGPL-2.1

## 概述

IFoxCAD 通过统一的事务封装和大量扩展方法，让 AutoCAD .NET API 的开发体验大幅提升：

- **统一事务**：`using var tr = new DBTrans();`

- **链式扩展**：`db.AddEntityToModelSpace(line, circle, ...)`

- **多 CAD 兼容**：源码版宏控制 AutoCAD/ZWCAD/GstarCAD

- **常用工具**：选择集、用户交互、图层、块、文字、标注、坐标变换、几何

- **依赖注入**：内置 IoC 容器

- **菜单与命令**：声明式命令注册

---

## 安装

### NuGet（推荐）

```bash

dotnet add package IFoxCAD.Cad

```

项目需引用对应 CAD 的 `acdbmgd`、`acmgd`、`accoremgd`，并设置 `Copy Local = false`。

### 项目模板

---

## 项目骨架

```csharp

using IFoxCAD.Cad;

using Autodesk.AutoCAD.DatabaseServices;

using Autodesk.AutoCAD.Geometry;

using Autodesk.AutoCAD.Runtime;

[assembly: ExtensionApplication(typeof(MyApp))]

[assembly: CommandClass(typeof(MyCommands))]

public class MyApp : IExtensionApplication

{

public void Initialize() { /* 加载时执行 */ }

public void Terminate() { /* 卸载时执行 */ }

}

```

---

## 事务封装：DBTrans

```csharp

[CommandMethod("DRAWLINE")]

public void DrawLine()

{

using var tr = new DBTrans(); // 自动管理 Database/Transaction

var line = new Line(Point3d.Origin, new Point3d(100, 100, 0));

tr.CurrentSpace.AddEntity(line); // 加入当前空间

tr.Commit();

}

```

`DBTrans` 自动持有：

- `Database` / `Transaction`

- `BlockTable` / `BlockTableRecord` / `LayerTable` / `TextStyleTable` / `LinetypeTable` ...

- `CurrentSpace` / `ModelSpace` / `PaperSpace`

---

## 用户交互（Editor 扩展）

```csharp

var ed = Env.Editor;

// 取一个点

if (ed.GetPoint("\n请选择起点：").GetPointResult(out var p)) {

// p 是 Point3d

}

// 取角度、整数、关键字

ed.GetDouble("\n请输入半径：").GetDoubleResult(out var r);

ed.GetKeyword("\n请选择 [圆(C)/矩形(R)]：", "C", "R").GetStringResult(out var k);

// 选择集

var sel = ed.SelectAll(new SelectionFilter(new[] {

new TypedValue((int)DxfCode.Start, "LINE")

}));

```

---

## 实体创建与样式

```csharp

using var tr = new DBTrans();

var line = new Line(Point3d.Origin, new Point3d(10, 0, 0)) {

LayerId = tr.LayerTable.GetOrCreate("墙体", l => l.Color = ColorIndex.Red),

ColorIndex = 1

};

var circle = new Circle(new Point3d(5, 0, 0), Vector3d.ZAxis, 2);

var text = new DBText { Position = new Point3d(0, -5, 0),

TextString = "Hello", Height = 2 };

tr.CurrentSpace.AddEntity(line, circle, text);

tr.Commit();

```

---

## 块（Block）

```csharp

using var tr = new DBTrans();

// 1. 创建块定义

ObjectId btrId = tr.BlockTable.Add("MyBlock", btr => {

btr.Origin = Point3d.Origin;

btr.AppendEntity(new Circle(Point3d.Origin, Vector3d.ZAxis, 1));

btr.AppendEntity(new Line(new Point3d(-1,0,0), new Point3d(1,0,0)));

});

// 2. 插入块参照

var br = new BlockReference(new Point3d(10, 10, 0), btrId);

tr.CurrentSpace.AddEntity(br);

// 3. 块属性

br.AddAttributes(("TAG1", "VALUE1"), ("TAG2", "VALUE2"));

tr.Commit();

```

---

## 图层

```csharp

using var tr = new DBTrans();

var layerId = tr.LayerTable.GetOrCreate("钢筋", l => {

l.Color = ColorIndex.Yellow;

l.LineWeight = LineWeight.LineWeight030;

});

```

---

## 几何运算

IFoxCAD 提供大量基于 AutoCAD `Geometry` 的扩展：

```csharp

var line = new Line(p1, p2);

double angle = line.Angle();

double len = line.Length;

var poly = new Polyline();

poly.AddVertexAt(0, new Point2d(0, 0), 0, 0, 0);

poly.AddVertexAt(1, new Point2d(10, 0), 0, 0, 0);

poly.AddVertexAt(2, new Point2d(10, 10), 0, 0, 0);

poly.Closed = true;

double area = poly.Area;

```

---

## 选择集与过滤

```csharp

var ed = Env.Editor;

var res = ed.GetSelection(new SelectionFilter(new[] {

new TypedValue(0, "LINE,LWPOLYLINE"),

new TypedValue(8, "钢筋") // 限定图层

}));

if (res.Status == PromptStatus.OK)

{

using var tr = new DBTrans();

foreach (var id in res.Value.GetObjectIds())

{

var ent = tr.GetObject<Entity>(id);

ent.ColorIndex = 1;

}

tr.Commit();

}

```

---

## 命令注册

```csharp

public class MyCommands

{

[CommandMethod("MY_HELLO", CommandFlags.Modal)]

public void Hello() => Env.Editor.WriteMessage("\nHello IFoxCAD");

[CommandMethod("MY_PUR", CommandFlags.Session)]

public void Purge() { /* ... */ }

}

```

---

## 多 CAD 兼容

IFoxCAD 通过条件编译支持：

- `IFOX_CAD2025` / `IFOX_CAD2024` ...

- `ZWCAD` / `GCAD` 等

```csharp

#if ZWCAD

using ZwSoft.ZwCAD.DatabaseServices;

#else

using Autodesk.AutoCAD.DatabaseServices;

#endif

```

---

## 典型工作流

### 工作流一：新建 AutoCAD 插件项目

1. `dotnet new classlib` 创建 .NET 类库项目

2. 通过 NuGet 添加 `IFoxCAD.Cad` 包，添加 AutoCAD 依赖 DLL 引用（`Copy Local=false`）

3. 创建 `IExtensionApplication` 实现类，添加 `[assembly: ExtensionApplication]` 和 `[assembly: CommandClass]` 特性

4. 在 `[CommandMethod]` 方法中编写业务逻辑：`using var tr = new DBTrans()` → 创建/修改实体 → `tr.Commit()`

5. 编译后通过 NETLOAD 加载到 AutoCAD 中运行

### 工作流二：批量处理 DWG 文件

1. 使用 `new DBTrans()` 或 `HostMgd` 无界面打开 DWG 文件

2. 遍历 `tr.CurrentSpace` 中的实体，`tr.GetObject<T>(id)` 获取强类型对象

3. 根据实体类型（Line/Circle/Polyline/...）执行批量修改

4. `tr.Commit()` 保存，输出到新 DWG

---

## 性能优化

1. **批量操作必用事务**，不要在循环里频繁开关事务

2. **`db.UsingTrans()`** 在跨命令操作时使用

3. **`Editor.Regen()`** 仅必要时调用

4. **块的修改**用 `BlockTableRecord.UpdateAnonymousBlocks` 同步实例

5. **Span/Stream 替代 ArrayList**

---

## 常见问题

| 问题 | 解决 |

|------|------|

| `eNotInDatabase` | 实体未加入 BlockTableRecord 即访问 Id |

| 修改后界面不刷新 | `ent.RecordGraphicsModified(true)` 或 `Editor.Regen()` |

| 引用 `acdbmgd` 报错 | 设置 `Copy Local=false` |

| 脱离 CAD 单元测试 | 用 `HostMgd` Mock 或 IFoxCAD 提供的测试基类 |

---

## AI 使用建议

- **推荐工作流模式**：AI 助手应遵循「命令定义 → DBTrans 事务 → 实体创建/修改 → Commit」的标准模式。`using var tr = new DBTrans()` 是几乎所有操作的起点，自动管理 Database 和 Transaction。

- **关键注意事项**：① 实体必须先加入 BlockTableRecord 再访问 Id，否则报 `eNotInDatabase`；② 引用 AutoCAD 依赖 DLL 时必须设置 `Copy Local=false`；③ 条件编译宏（`IFOX_CAD2025`/`ZWCAD` 等）用于多 CAD 兼容；④ 插件入口需实现 `IExtensionApplication`，在 `Initialize()` 中执行初始化、`Terminate()` 中执行清理，命令通过 `[CommandMethod]` 特性声明式注册。

- **常用代码模式**：`using var tr = new DBTrans()` → `tr.CurrentSpace.AddEntity(...)` 或 `tr.LayerTable.GetOrCreate("name")` → `tr.Commit()`。选择集操作：`ed.SelectAll(new SelectionFilter(...))` → `tr.GetObject<T>(id)` → 修改 → `tr.Commit()`。

---

## 相关技能

- **qcad** — 2D CAD 软件，ECMAScript 扩展与 DWG/DXF 处理：[../qcad/SKILL.md](../qcad/SKILL.md)

- **librecad** — 开源 2D CAD，DXF 编辑：[../librecad/SKILL.md](../librecad/SKILL.md)

- **libredwg** — DWG/DXF 文件格式读写库：[../libredwg/SKILL.md](../libredwg/SKILL.md)

- **lightcad** — Web 2D CAD 框架（类似二次开发场景）：[../lightcad/SKILL.md](../lightcad/SKILL.md)

---

## 参考资源

- 仓库：<https://gitee.com/inspirefunction/ifoxcad>

- 文档与示例：<https://gitee.com/inspirefunction/ifoxcad/wikis>