使用C# OpenXML 2.5 SDK实现Excel打开时弹出欢迎提示框

嘿，我完全理解你想要用OpenXML 2.5 SDK创建Excel文件时，让文件一打开就弹出欢迎提示框的需求，而且还希望用类似你之前实现工作表保护那样的直接操作OpenXML元素的方式来完成——毕竟你已经钻研两天了，肯定想找个简洁、贴合你现有代码风格的方案。

首先得说清楚：纯OpenXML的结构化元素（比如你用的SheetProtection）没法直接实现弹出提示框，因为这类交互提示属于Excel的客户端行为，需要借助VBA宏来触发。不过别担心，我们可以用OpenXML SDK把VBA代码嵌入到Excel文件里，实现打开时自动执行提示，而且操作方式和你之前的SheetProtection类似，都是直接操作文件的OpenXML结构。

具体实现步骤 #

1. 核心思路：嵌入VBA的Workbook_Open事件 #

Excel打开文件时会自动触发Workbook_Open事件，我们只需要把提示框的代码放在这个事件里，再用OpenXML SDK把这段VBA代码嵌入到Excel文件中即可。

2. 完整C#代码示例 #

你可以把这段代码和你现有的SheetProtection代码结合起来，直接复用你的SpreadsheetDocument操作逻辑：

using DocumentFormat.OpenXml.Packaging;
using DocumentFormat.OpenXml.Spreadsheet;
using DocumentFormat.OpenXml.Vba;

// 假设你已经有一个打开的SpreadsheetDocument对象（或者按你的逻辑创建/打开文件）
using (SpreadsheetDocument spreadsheetDocument = SpreadsheetDocument.Open("你的文件路径.xlsm", true))
{
    // --- 你原有的工作表保护代码 ---
    WorksheetPart worksheetPart1 = spreadsheetDocument.WorkbookPart.WorksheetParts.First();
    SheetProtection sheetProt = new SheetProtection() 
    { 
        Sheet = true, 
        Objects = true, 
        Scenarios = true, 
        Password = "Password" 
    };
    worksheetPart1.Worksheet.InsertAfter(sheetProt, worksheetPart1.Worksheet.Descendants<SheetData>().LastOrDefault());
    worksheetPart1.Worksheet.Save();

    // --- 添加VBA宏实现打开提示 ---
    // 1. 创建VBA项目部件
    VbaProjectPart vbaProjectPart = spreadsheetDocument.WorkbookPart.AddNewPart<VbaProjectPart>();
    
    // 2. 配置VBA项目基础属性
    VbaProject vbaProject = new VbaProject
    {
        Name = "VBAProject",
        Compatibility = new Compatibility { Version = 14 },
        Version = 100,
        HelpContextId = 0,
        VbeVersion = 660
    };
    
    // 3. 添加ThisWorkbook模块，写入Workbook_Open事件代码
    VbaModule vbaModule = new VbaModule
    {
        Name = "ThisWorkbook",
        Type = VbaModuleType.Document,
        SourceCode = @"Private Sub Workbook_Open()" + Environment.NewLine +
                       @"    MsgBox ""欢迎使用这个Excel文件！"", vbInformation, ""欢迎提示""" + Environment.NewLine +
                       @"End Sub"
    };
    
    vbaProject.Append(vbaModule);
    vbaProjectPart.VbaProject = vbaProject;
    vbaProjectPart.Save();

    // 4. 标记工作簿启用宏，关联代码模块
    WorkbookPr workbookPr = spreadsheetDocument.WorkbookPart.Workbook.Descendants<WorkbookPr>().FirstOrDefault();
    if (workbookPr == null)
    {
        workbookPr = new WorkbookPr();
        spreadsheetDocument.WorkbookPart.Workbook.InsertAt(workbookPr, 0);
    }
    workbookPr.CodeName = "ThisWorkbook";
    spreadsheetDocument.WorkbookPart.Workbook.Save();
}

3. 关键注意事项 #

• 文件后缀必须用.xlsm：因为嵌入了宏，.xlsx格式会自动禁用宏，导致提示框无法弹出。
• 宏安全提示：用户打开文件时，Excel会弹出“启用宏”的安全提示，只有用户选择启用宏后，欢迎提示才会显示——这是Excel的默认安全机制，无法绕过。
• 定制提示内容：你可以修改VBA代码里的MsgBox参数，调整提示文本、图标、标题等样式。

为什么SheetProtection方案不行？ #

你之前尝试的SheetProtection是用于保护工作表的结构和内容，它的生效逻辑是Excel加载工作表时自动应用保护规则，和弹出提示框的交互行为完全是两个不同的功能模块，所以没法用它来实现欢迎提示。

内容的提问来源于stack exchange，提问作者Rajan Mishra