跳转至

18. 文件级密码

本章介绍文件级安全(打开密码 / 修改密码)的管理。

Warning

打开 / 修改密码仅支持 xlsx / xlsm / xlsb。csv / xls 不支持文件级密码。


18.1 打开加密文件

打开密码(Agile 加密)在 ExcelReadOptions.OpenPassword 提供;未提供时若文件已加密,抛出明确异常:

var wb = Excel.Open("secured.xlsx", new ExcelReadOptions { OpenPassword = "secret" });

18.2 读取安全状态

Workbook.Security(WorkbookSecurity)暴露只读安全状态属性,配合打开选项读取:

var wb = Excel.Open("secured.xlsx", new ExcelReadOptions
{
    OpenPassword = "secret",
    ModifyPassword = "write",
});

var sec = wb.Security;
Console.WriteLine(sec.HasOpenPassword);      // true
Console.WriteLine(sec.HasModifyPassword);    // true
Console.WriteLine(sec.HasModifyAccess);      // true(提供了修改密码)
Console.WriteLine(sec.IsReadOnly);           // false
Console.WriteLine(sec.CanSave);              // true
属性 类型 说明
HasOpenPassword bool 文件是否有打开密码(文件加密)
HasModifyPassword bool 文件是否有修改密码(写保护)
HasModifyAccess bool 是否已获得修改权限(提供了正确修改密码)
IsReadOnly bool 有修改密码但未获修改权限时为只读
CanSave bool 是否允许保存(!IsReadOnly)

输出:

True
True
True
False
True

18.3 设置密码

Workbook.Security 提供设置打开 / 修改密码的方法,随后保存即生效:

var wb = Excel.Create();
wb.Security.SetOpenPassword("secret");       // 打开密码(文件加密)
wb.Security.SetModifyPassword("write");      // 修改密码(写保护),默认建议只读
wb.Security.SetModifyPassword("write", readOnlyRecommended: false);  // 不提示只读
wb.SaveAs("secured.xlsx");
方法 参数 说明
SetOpenPassword password 设置打开密码(文件加密),覆盖旧值;空 / 空白视为移除
SetModifyPassword password 设置修改密码(写保护),覆盖旧值;空 / 空白视为移除
SetModifyPassword readOnlyRecommended 是否建议以只读方式打开(默认 true)
RemoveOpenPassword — 移除打开密码(下次保存为无打开密码文件)
RemoveModifyPassword — 移除修改密码(要求已获修改权限)
ClearAll — 清空全部文件级密码(要求已获修改权限)

输出:已写入 secured.xlsx

⚠️ 密码本体仅存储于 WorkbookSecurity 对象内部,不对外暴露明文;错误消息与日志不含密码。

18.4 移除密码

打开含密码文件(提供正确密码获得授权)后,调用移除方法再保存即可去密码:

var wb = Excel.Open("secured.xlsx", new ExcelReadOptions { OpenPassword = "secret", ModifyPassword = "write" });
wb.Security.RemoveOpenPassword();            // 下次保存为无打开密码
wb.Security.RemoveModifyPassword();          // 下次保存为无修改保护
wb.Security.ClearAll();                      // 清空全部文件级密码
wb.SaveAs("plain.xlsx");

输出:已写入 plain.xlsx

⚠️ RemoveModifyPassword / ClearAll 要求已获得修改权限(否则抛 LiteExcelException),防止未授权剥离 / 替换写保护。

18.5 修改密码权限与只读

文件设置了修改密码但未提供时以只读方式打开,可通过安全状态属性确认:

var wb = Excel.Open("readonly.xlsx");        // 该文件设置了修改密码但未提供
Console.WriteLine(wb.Security.IsReadOnly);   // true
Console.WriteLine(wb.Security.CanSave);      // false

输出:

True
False

文件设置了修改密码但未提供(或提供错误)时,工作簿以只读方式打开,IsReadOnly = true、CanSave = false,保存会抛 LiteExcelException。提供正确的 ModifyPassword 即获得编辑授权(HasModifyAccess = true)。

18.6 保真回写

打开加密文件后 SaveAs 默认继承密码,无需重新设置:

var wb = Excel.Open("secured.xlsx", new ExcelReadOptions
{
    OpenPassword = "secret",
    ModifyPassword = "write",
});
wb.SaveAs("secured_copy.xlsx");   // 默认继承打开密码

输出:已写入 secured_copy.xlsx

⚠️ ModifyPasswordTouched(用户显式改动过修改密码)时不透传原 fileSharing,按新设置的修改密码重新生成。含 VBA 宏的工作簿保存为 xlsx / xls 会报错(格式不支持宏)。