用Teigha修改并保存CAD文件

使用Teigha（ODA）库在C#/.NET环境中打开、修改并保存CAD文件，核心流程包括初始化、打开数据库、事务处理、实体操作和保存文件。以下是详细步骤和代码示例。

1. 核心流程概览

操作CAD文件的典型工作流如下表所示：

步骤	主要操作	关键类/方法	说明
1. 初始化	加载Teigha库	OdDbDatabase	确保DLL引用正确
2. 打开文件	读取DWG/DXF	OdDbDatabase.readDwgFile()	指定文件路径和打开模式
3. 开始事务	创建事务管理器	Database.TransactionManager	确保操作的原子性和数据一致性
4. 修改实体	遍历/编辑图形对象	Entity类及其属性	修改图层、颜色、文本等
5. 提交事务	保存修改到数据库	Transaction.Commit()	将修改持久化
6. 保存文件	写入磁盘	OdDbDatabase.writeDwgFile()	可另存为新文件或覆盖原文件
7. 清理资源	关闭数据库	Database.Dispose()	释放内存和文件句柄

2. 详细代码实现

2.1 初始化与打开文件

首先需要引用Teigha的DLL（如Teigha.Core.dll, Teigha.DatabaseServices.dll），然后打开目标CAD文件。

using Teigha.Core;
using Teigha.DatabaseServices;

public void OpenAndModifyCadFile(string filePath)
{
    // 初始化Teigha运行时（通常只需调用一次）
    OdDbDatabase db = null;
    try
    {
        // 打开CAD文件，第二个参数为true表示以读写方式打开
        db = OdDbDatabase.readDwgFile(filePath, FileShare.ReadWrite, true, null);
        Console.WriteLine("文件打开成功");
        
        // 后续修改操作...
    }
    catch (Exception ex)
    {
        Console.WriteLine($"打开文件失败: {ex.Message}");
        throw;
    }
}

2.2 事务管理与实体修改

在Teigha中，所有对数据库的修改都应在事务内进行，以保证数据完整性。以下示例展示如何修改所有圆实体的半径。

public void ModifyEntities(OdDbDatabase db)
{
    // 获取事务管理器
    using (Transaction tr = db.TransactionManager.StartTransaction())
    {
        try
        {
            // 获取块表（BlockTable），这是所有实体的容器
            BlockTable bt = (BlockTable)tr.GetObject(db.BlockTableId, OpenMode.ForRead);
            
            // 获取模型空间块表记录（ModelSpace）
            BlockTableRecord btr = (BlockTableRecord)tr.GetObject(
                bt[BlockTableRecord.ModelSpace], OpenMode.ForWrite);
            
            // 遍历模型空间中的所有实体
            foreach (ObjectId entityId in btr)
            {
                // 打开实体以进行修改
                Entity entity = tr.GetObject(entityId, OpenMode.ForWrite) as Entity;
                
                if (entity != null)
                {
                    // 示例：修改所有圆的半径为原来的2倍
                    if (entity is Circle circle)
                    {
                        circle.Radius *= 2.0;  // 修改半径
                        Console.WriteLine($"修改圆半径: {circle.Radius}");
                    }
                    
                    // 示例：修改文本内容（如果是DBText或MText）
                    if (entity is DBText text)
                    {
                        text.TextString = "修改后的文本";
                    }
                    
                    // 示例：修改实体颜色为红色
                    entity.Color = Color.FromColorIndex(ColorMethod.ByAci, 1); // 1代表红色
                    
                    // 示例：添加或修改扩展数据（XData）
                    AddXDataToEntity(entity, "自定义数据", "值123");
                }
            }
            
            // 提交事务，保存所有修改
            tr.Commit();
            Console.WriteLine("实体修改完成并已提交事务");
        }
        catch (Exception ex)
        {
            // 回滚事务以保持数据一致性
            tr.Abort();
            Console.WriteLine($"修改过程中出错，已回滚: {ex.Message}");
            throw;
        }
    }
}

// 为实体添加扩展数据（XData）的方法
private void AddXDataToEntity(Entity entity, string appName, string value)
{
    // 创建扩展数据容器
    ResultBuffer rb = new ResultBuffer();
    rb.Add(new TypedValue(1001, appName));  // 应用程序名
    rb.Add(new TypedValue(1000, value));     // 字符串值
    
    // 将XData附加到实体
    entity.XData = rb;
}

2.3 保存文件

修改完成后，可以选择覆盖原文件或另存为新文件。

public void SaveCadFile(OdDbDatabase db, string originalPath, string newPath = null)
{
    try
    {
        string savePath = newPath ?? originalPath;
        
        // 保存DWG文件
        // 第三个参数为保存版本，如OdDb::kDwgCurrent 表示当前版本
        db.writeDwgFile(savePath, DwgVersion.Current, null);
        
        Console.WriteLine($"文件已保存到: {savePath}");
        
        // 如果要保存为DXF格式，可以使用：
        // db.writeDxfFile(savePath, DwgVersion.Current, DxfFormat.Ascii, null);
    }
    catch (Exception ex)
    {
        Console.WriteLine($"保存文件失败: {ex.Message}");
        throw;
    }
    finally
    {
        // 清理资源
        if (db != null)
        {
            db.Dispose();
        }
    }
}

3. 完整示例：修改并保存CAD文件

以下是将上述步骤整合的完整示例。

using System;
using Teigha.Core;
using Teigha.DatabaseServices;
using Teigha.Runtime;

public class CadFileEditor
{
    public void EditAndSaveCadFile(string inputPath, string outputPath = null)
    {
        OdDbDatabase db = null;
        
        try
        {
            // 1. 打开CAD文件
            db = OdDbDatabase.readDwgFile(inputPath, FileShare.ReadWrite, true, null);
            Console.WriteLine($"成功打开文件: {inputPath}");
            
            // 2. 修改实体
            ModifyAllTextEntities(db);
            
            // 3. 保存文件（如果outputPath为null则覆盖原文件）
            string savePath = outputPath ?? inputPath;
            db.writeDwgFile(savePath, DwgVersion.Current, null);
            Console.WriteLine($"文件已保存到: {savePath}");
        }
        catch (OdError ex)
        {
            Console.WriteLine($"Teigha错误: {ex.Message}");
        }
        catch (Exception ex)
        {
            Console.WriteLine($"常规错误: {ex.Message}");
        }
        finally
        {
            db?.Dispose();
        }
    }
    
    private void ModifyAllTextEntities(OdDbDatabase db)
    {
        using (Transaction tr = db.TransactionManager.StartTransaction())
        {
            try
            {
                BlockTable bt = (BlockTable)tr.GetObject(db.BlockTableId, OpenMode.ForRead);
                BlockTableRecord btr = (BlockTableRecord)tr.GetObject(
                    bt[BlockTableRecord.ModelSpace], OpenMode.ForWrite);
                
                int modifiedCount = 0;
                
                foreach (ObjectId entityId in btr)
                {
                    Entity entity = tr.GetObject(entityId, OpenMode.ForWrite) as Entity;
                    
                    if (entity is DBText text)
                    {
                        // 修改文本内容和样式
                        text.TextString = "[已修改] " + text.TextString;
                        text.Height *= 1.2;  // 增大文字高度20%
                        text.Color = Color.FromColorIndex(ColorMethod.ByAci, 3); // 绿色
                        modifiedCount++;
                    }
                    else if (entity is MText mtext)
                    {
                        mtext.Contents = "[已修改] " + mtext.Contents;
                        mtext.TextHeight *= 1.2;
                        modifiedCount++;
                    }
                }
                
                tr.Commit();
                Console.WriteLine($"已修改 {modifiedCount} 个文本实体");
            }
            catch
            {
                tr.Abort();
                throw;
            }
        }
    }
}

// 使用示例
class Program
{
    static void Main()
    {
        CadFileEditor editor = new CadFileEditor();
        
        // 修改并覆盖原文件
        editor.EditAndSaveCadFile(@"C:\input.dwg");
        
        // 修改并另存为新文件
        editor.EditAndSaveCadFile(@"C:\input.dwg", @"C:\output_modified.dwg");
    }
}

4. 关键注意事项

1. 事务管理 ：所有数据库修改操作必须在事务内进行，使用try-catch确保异常时能正确回滚。
2. 打开模式 ：打开实体时需指定正确的OpenMode（ForRead、ForWrite或ForNotify），只有ForWrite模式才能修改实体。
3. 文件锁定 ：使用FileShare.ReadWrite参数避免文件被其他进程独占，这在多线程或网络环境中尤为重要。
4. 版本兼容性 ：writeDwgFile方法的第二个参数控制保存的DWG版本，需考虑目标CAD软件的兼容性。
5. 性能优化：对于大型CAD文件，避免在事务中加载所有实体，可采用按需加载或分批处理策略。
6. 错误处理 ：Teigha可能抛出特定的OdError异常，应与常规Exception区别处理。

5. 高级应用场景

5.1 批量处理多个文件

public void BatchProcessCadFiles(string[] filePaths)
{
    foreach (string filePath in filePaths)
    {
        try
        {
            using (OdDbDatabase db = OdDbDatabase.readDwgFile(filePath, FileShare.ReadWrite, true, null))
            {
                // 执行修改操作
                ChangeAllLayerColors(db);
                
                // 添加后缀保存
                string newPath = Path.Combine(
                    Path.GetDirectoryName(filePath),
                    Path.GetFileNameWithoutExtension(filePath) + "_processed.dwg");
                
                db.writeDwgFile(newPath, DwgVersion.Current, null);
            }
        }
        catch (Exception ex)
        {
            Console.WriteLine($"处理文件 {filePath} 时出错: {ex.Message}");
        }
    }
}

5.2 修改实体扩展数据（XData）

public void UpdateEntityXData(Entity entity, string appName, Dictionary<string, string> data)
{
    using (ResultBuffer rb = new ResultBuffer())
    {
        rb.Add(new TypedValue(1001, appName));  // 应用程序名
        
        foreach (var item in data)
        {
            rb.Add(new TypedValue(1000, item.Key));   // 键
            rb.Add(new TypedValue(1000, item.Value)); // 值
        }
        
        entity.XData = rb;
    }
}

通过上述方法，可以在无AutoCAD环境下实现对CAD文件的完整读写和修改操作，适用于CAD数据提取、批量修改、格式转换等自动化场景。

---

参考来源

• 三、使用Teigha.net打开CAD(.dwg/.dxf)文件，并显示到panel界面绑定事件
• 关于Teigha的使用记录
• 一、专栏内容简介-免费试读-修改链接使用Teigha.net完成.net winfrom界面修改读取dwg/dxf文件，类似CAD看图王软件无AutoCAD环境下操作显示CAD文件的功能
• 【亲测免费】 Teigha.net 4.0：轻松上手CAD文件生成
• 五、完成Teigha.net对CAD文件中的Entity实体进行编辑修改功能，包括字体,样式，颜色，备注XData等属性
• Teigha应用------解析CAD文件（DWG格式）Teigha在CAD C#二次开发中的基本应用