Inventor 二次开发从入门到精通（12）高级应用

Inventor 二次开发的高级应用包括与外部系统的数据交互、事件响应、插件打包与发布等，这些内容是实现工业级插件的关键。本章将讲解这些高级技术，帮助开发者打造完整、稳定的插件。

9.1 与外部系统的数据交互

Inventor 常需与 Excel、数据库、PLM/ERP 系统等外部系统进行数据交互，实现数据的导入导出和共享。

9.1.1 与 Excel 的数据交互

Excel 是机械设计中常用的数据管理工具，可通过Microsoft.Office.Interop.Excel程序集实现与 Excel 的交互。

（1）导出数据到 Excel

cs 复制代码

// 导出零件参数到Excel
public void ExportToExcel(PartDocument partDoc, string excelPath)
{
    try
    {
        // 创建Excel应用程序对象
        Microsoft.Office.Interop.Excel.Application excelApp = new Microsoft.Office.Interop.Excel.Application();
        excelApp.Visible = true;

        // 创建工作簿
        Microsoft.Office.Interop.Excel.Workbook workbook = excelApp.Workbooks.Add();
        Microsoft.Office.Interop.Excel.Worksheet worksheet = workbook.Worksheets[1];

        // 设置表头
        worksheet.Cells[1, 1] = "参数名称";
        worksheet.Cells[1, 2] = "参数值";
        worksheet.Cells[1, 3] = "单位";

        // 填充参数数据
        int row = 2;
        foreach (Parameter param in partDoc.ComponentDefinition.Parameters)
        {
            if (param.Type == ParameterTypeEnum.kModelParameter)
            {
                worksheet.Cells[row, 1] = param.Name;
                worksheet.Cells[row, 2] = param.Value;
                worksheet.Cells[row, 3] = param.Unit;
                row++;
            }
        }

        // 保存Excel文件
        workbook.SaveAs(excelPath);

        // 释放资源
        System.Runtime.InteropServices.Marshal.ReleaseComObject(worksheet);
        System.Runtime.InteropServices.Marshal.ReleaseComObject(workbook);
        System.Runtime.InteropServices.Marshal.ReleaseComObject(excelApp);
    }
    catch (Exception ex)
    {
        _inventorApp.UserInterfaceManager.MessageBox.Show("导出Excel失败：" + ex.Message);
    }
}

（2）从 Excel 导入数据

cs 复制代码

// 从Excel导入参数到零件
public void ImportFromExcel(PartDocument partDoc, string excelPath)
{
    try
    {
        // 创建Excel应用程序对象
        Microsoft.Office.Interop.Excel.Application excelApp = new Microsoft.Office.Interop.Excel.Application();
        excelApp.Visible = false;

        // 打开工作簿
        Microsoft.Office.Interop.Excel.Workbook workbook = excelApp.Workbooks.Open(excelPath);
        Microsoft.Office.Interop.Excel.Worksheet worksheet = workbook.Worksheets[1];

        // 读取数据
        int row = 2;
        while (worksheet.Cells[row, 1].Value != null)
        {
            string paramName = worksheet.Cells[row, 1].Value.ToString();
            double paramValue = Convert.ToDouble(worksheet.Cells[row, 2].Value);

            // 修改零件参数
            Parameter param = partDoc.ComponentDefinition.Parameters[paramName];
            param.Value = paramValue;

            row++;
        }

        // 更新模型
        partDoc.Update();

        // 释放资源
        workbook.Close();
        System.Runtime.InteropServices.Marshal.ReleaseComObject(worksheet);
        System.Runtime.InteropServices.Marshal.ReleaseComObject(workbook);
        System.Runtime.InteropServices.Marshal.ReleaseComObject(excelApp);

        _inventorApp.UserInterfaceManager.MessageBox.Show("从Excel导入参数成功！");
    }
    catch (Exception ex)
    {
        _inventorApp.UserInterfaceManager.MessageBox.Show("从Excel导入参数失败：" + ex.Message);
    }
}

9.1.2 与数据库的交互

可通过ADO.net实现与 SQL Server、MySQL 等数据库的交互，存储和读取设计数据。

cs 复制代码

// 连接SQL Server数据库并保存零件信息
public void SaveToDatabase(PartDocument partDoc)
{
    try
    {
        // 数据库连接字符串
        string connStr = "Data Source=.;Initial Catalog=InventorDB;Integrated Security=True";

        // 创建连接
        using (System.Data.SqlClient.SqlConnection conn = new System.Data.SqlClient.SqlConnection(connStr))
        {
            conn.Open();

            // 编写SQL语句
            string sql = "INSERT INTO PartInfo (PartName, Length, Width, CreateTime) VALUES (@PartName, @Length, @Width, @CreateTime)";

            // 创建命令
            using (System.Data.SqlClient.SqlCommand cmd = new System.Data.SqlClient.SqlCommand(sql, conn))
            {
                // 添加参数
                cmd.Parameters.AddWithValue("@PartName", partDoc.DisplayName);
                cmd.Parameters.AddWithValue("@Length", partDoc.ComponentDefinition.Parameters["Length"].Value);
                cmd.Parameters.AddWithValue("@Width", partDoc.ComponentDefinition.Parameters["Width"].Value);
                cmd.Parameters.AddWithValue("@CreateTime", DateTime.Now);

                // 执行SQL
                cmd.ExecuteNonQuery();
            }

            conn.Close();
        }

        _inventorApp.UserInterfaceManager.MessageBox.Show("保存到数据库成功！");
    }
    catch (Exception ex)
    {
        _inventorApp.UserInterfaceManager.MessageBox.Show("保存到数据库失败：" + ex.Message);
    }
}

9.2 事件响应与处理

Inventor 提供了丰富的事件，可通过事件响应实现对用户操作的实时监控和处理。

9.2.1 常用事件类型

文档事件：文档打开、关闭、保存、新建等；
模型事件：特征创建、修改、删除，参数变更等；
界面事件：命令执行、控件点击等；
交互事件：选择对象、鼠标移动等。

9.2.2 注册和处理事件

cs 复制代码

// 注册文档打开事件
public void RegisterEvents()
{
    try
    {
        // 注册文档打开事件
        _inventorApp.Documents.OnOpenDocument += new DocumentsEvents_OnOpenDocumentEventHandler(OnOpenDocument);

        // 注册参数变更事件
        PartDocument partDoc = (PartDocument)_inventorApp.ActiveDocument;
        partDoc.ComponentDefinition.Parameters.OnParameterChange += new ParametersEvents_OnParameterChangeEventHandler(OnParameterChange);
    }
    catch (Exception ex)
    {
        _inventorApp.UserInterfaceManager.MessageBox.Show("注册事件失败：" + ex.Message);
    }
}

// 文档打开事件处理
private void OnOpenDocument(Document document, EventTimingEnum BeforeOrAfter, NameValueMap Context, out HandlingCodeEnum HandlingCode)
{
    _inventorApp.UserInterfaceManager.MessageBox.Show("文档已打开：" + document.DisplayName);
    HandlingCode = HandlingCodeEnum.kEventHandled;
}

// 参数变更事件处理
private void OnParameterChange(Parameter Parameter, EventTimingEnum BeforeOrAfter, NameValueMap Context, out HandlingCodeEnum HandlingCode)
{
    _inventorApp.UserInterfaceManager.MessageBox.Show("参数" + Parameter.Name + "的值已变更为：" + Parameter.Value);
    HandlingCode = HandlingCodeEnum.kEventHandled;
}

9.3 插件的打包与发布

完成插件开发后，需将其打包为安装程序，方便用户安装和使用。

9.3.1 插件的编译与生成

在 Visual Studio 中，将项目编译为 DLL 文件，并确保引用的程序集正确。

9.3.2 使用 InstallShield 创建安装程序

InstallShield 是常用的安装程序制作工具，可用于创建 Inventor 插件的安装包：

创建新的 InstallShield 项目；
添加插件的 DLL 文件和相关资源（如图标、帮助文档）；
设置安装路径（如C:\Program Files\InventorPlugins\）；
添加注册表项（Inventor 通过注册表识别插件）；
生成安装程序（EXE 或 MSI 文件）。

9.3.3 插件的注册与卸载

Inventor 插件需通过注册表注册才能被识别，注册项通常位于：HKEY_CURRENT_USER\Software\Autodesk\Inventor\AddIns\[插件GUID]

注册插件的示例：

cs 复制代码

// 注册插件到注册表
public void RegisterPlugin(string pluginPath, string pluginGUID, string pluginName)
{
    try
    {
        Microsoft.Win32.RegistryKey key = Microsoft.Win32.Registry.CurrentUser.CreateSubKey(
            $"Software\\Autodesk\\Inventor\\AddIns\\{pluginGUID}"
        );

        key.SetValue("DisplayName", pluginName);
        key.SetValue("Assembly", pluginPath);
        key.SetValue("ClassId", pluginGUID);
        key.SetValue("LoadOnStartUp", 1);
        key.Close();

        _inventorApp.UserInterfaceManager.MessageBox.Show("插件注册成功！");
    }
    catch (Exception ex)
    {
        _inventorApp.UserInterfaceManager.MessageBox.Show("插件注册失败：" + ex.Message);
    }
}

9.4 插件的调试与排错

9.4.1 常用调试技巧

断点调试：在 Visual Studio 中设置断点，跟踪代码执行流程；
日志记录：将关键操作和错误信息记录到日志文件，便于排查问题；
异常处理：使用 try-catch 捕获异常，避免插件崩溃。

9.4.2 日志记录的实现

cs 复制代码

// 记录日志
public void Log(string message)
{
    string logPath = $@"C:\InventorPlugins\Logs\{DateTime.Now:yyyyMMdd}.log";
    System.IO.Directory.CreateDirectory(System.IO.Path.GetDirectoryName(logPath));
    System.IO.File.AppendAllText(logPath, $"{DateTime.Now:HH:mm:ss} - {message}\r\n");
}

9.5 性能优化

对于大型插件或批量处理任务，性能优化至关重要：

禁用屏幕更新 ：在批量操作时，设置_inventorApp.ScreenUpdating = false，减少界面刷新；
使用事务：将多个操作封装为事务，减少数据库提交次数；
延迟更新 ：批量修改参数后，一次性调用Document.Update()；
释放资源：及时释放 COM 对象，避免内存泄漏。