18. 文件级密码¶
本章介绍文件级安全(打开密码 / 修改密码)的管理。
Warning
打开 / 修改密码仅支持 xlsx / xlsm / xlsb。csv / xls 不支持文件级密码。
18.1 打开加密文件¶
打开密码(Agile 加密)在 ExcelReadOptions.OpenPassword 提供;未提供时若文件已加密,抛出明确异常:
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) |
输出:
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
输出:
文件设置了修改密码但未提供(或提供错误)时,工作簿以只读方式打开,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 会报错(格式不支持宏)。