你把一份完工的工作簿交给同事,让他们筛选,而不是重写。于是你保护工作表。诱人的捷径是每次都往文件里写死一个固定的元素 <sheetProtection sheet="1" objects="1" scenarios="1"/>。工作表锁上了,密码哈希也挂上了,然后用户什么都干不了,连你本来想开放的排序和筛选也被锁死。Excel 自己的“保护工作表”对话框为此准备了十五个复选框,HotXLS 的保护模型把每一个都表达了出来
HotXLS 是一个无需安装 Excel 就能读写 XLS 和 XLSX 的原生 VCL 电子表格组件,面向 Delphi 和 C++Builder。本文讨论工作表保护在 XLSX 一侧的内容:TXLSXSheetProtectionOption 枚举、切换每项权限的 AllowOption 属性,以及那条让所有手写 <sheetProtection> 元素的人都会绊倒的 OOXML 编码规则
工作表保护实际上防护了什么
先说边界,因为它决定了你该有多信任这套东西。OOXML 电子表格格式(ECMA-376)里的工作表保护是一种交互策略,不是加密。它告诉遵循规范的应用:工作表受保护时,应拒绝哪些编辑操作。单元格的值仍以明文躺在 xl/worksheets/sheetN.xml 里;把 .xlsx 解压开,它们就在那里。可选的密码存的是一个短的旧式哈希,不是能把任何东西打乱的密钥。任何人只要把文件改个名、打开这个部件、删掉 <sheetProtection> 那一行,就能读写一切
所以保护回答的是“别让同事不小心毁掉一个公式”,而不是“把数据对有心人保密”。这是两个不同的问题,用不同的工具解决。如果你要的是机密性,你需要的是受 AES 保护的 XLSX 输出里讲的工作簿级加密,那才会真正加密整个包。工作表保护和工作簿加密可以干净地组合,但只有后者才是真正的锁。把这条界线记清楚,这一页剩下的内容就只是管线布置了
15 种选项与 AllowOption 属性
每个工作表现在都带有一组 TXLSXSheetProtectionOption 值,描述工作表受保护期间用户仍可以做什么。这些成员与 OOXML 属性、Excel 对话框复选框一一对应:
xlsxSpoEditObjects、xlsxSpoEditScenarios— 编辑图形对象和 what-if 方案xlsxSpoFormatCells、xlsxSpoFormatColumns、xlsxSpoFormatRows— 重新设置单元格、列、行的格式xlsxSpoInsertColumns、xlsxSpoInsertRows、xlsxSpoInsertHyperlinks— 插入列、行、超链接xlsxSpoDeleteColumns、xlsxSpoDeleteRows— 删除列、行xlsxSpoSelectLockedCells、xlsxSpoSelectUnlockedCells— 把选区移到锁定或未锁定的单元格上xlsxSpoSort、xlsxSpoAutoFilter、xlsxSpoPivotTables— 排序区域、使用自动筛选下拉、操作数据透视表
通过 TXLSXWorksheet 上带索引的 AllowOption 属性读写单个权限位。AllowOption[Opt] = True 表示允许该动作;设为 False 则禁止。整个集合也可以通过 SheetProtectionOptions(一个纯 Pascal 的 set of 类型 TXLSXSheetProtectionOptions)一次性访问,可以保存、还原或整批替换
默认值很重要,而且是刻意的:新建的工作表一开始允许所有选项。构造函数用完整范围 [Low(TXLSXSheetProtectionOption)..High(TXLSXSheetProtectionOption)] 给 SheetProtectionOptions 设了种子。你从那里开始收缩,排除想禁止的动作,而不是从零开始攒一个权限集合。正是这个选择让下面要讲的写入器编码规则与 Excel 的行为对齐
保护工作表但开放排序和筛选
一个常见的端到端场景:保护一份完成的报表,版面不许重塑,但读者可以排序和筛选。注意 Protect 和选项是相互独立的。Protect 把工作表切到受保护状态并保存可选的密码哈希;它不动选项集合。你要单独调整 AllowOption,这些开关在工作表被保护并保存后生效
var
wb: TXLSXWorkbook;
sh: TXLSXWorksheet;
begin
wb := TXLSXWorkbook.Create;
try
sh := wb.Sheets.Add('Protected');
sh.Cells[1, 1].Value := 'Region'; sh.Cells[1, 2].Value := 'Units';
sh.Cells[2, 1].Value := 'North'; sh.Cells[2, 2].Value := 120;
sh.Cells[3, 1].Value := 'South'; sh.Cells[3, 2].Value := 98;
// 使用密码保护。这只是设置受保护状态和哈希;
// 选项集保持在全部允许的默认状态。
sh.Protect('HotXLS-2026');
// 收紧:保留排序和自动筛选,禁止调整结构与重新格式化。
sh.AllowOption[xlsxSpoSort] := True;
sh.AllowOption[xlsxSpoAutoFilter] := True;
sh.AllowOption[xlsxSpoFormatCells] := False;
sh.AllowOption[xlsxSpoFormatColumns] := False;
sh.AllowOption[xlsxSpoFormatRows] := False;
sh.AllowOption[xlsxSpoInsertRows] := False;
sh.AllowOption[xlsxSpoDeleteRows] := False;
if wb.SaveAs('protection.xlsx') <> 1 then
Writeln('SaveAs failed');
finally
wb.Free;
end;
end;
从那段代码能读出两件事。Sort 和 AutoFilter 两行虽然默认就是 True,还是被明确写出;这是写给下一个维护者的文档,不是功能需要。而且因为默认是宽容的,唯一会改变输出文件的行是把选项设为 False 的那几行。这不是这个 API 的巧合,而是 OOXML 传输格式的直接体现,这正是下一节的主题
编码规则:省略代表允许,attr=0 代表禁止
这是整个功能里唯一反直觉的事实,也正是手写 <sheetProtection> 通常出错的地方。OOXML 里每个针对具体动作的属性都是一个禁止标志,缺席才代表允许。属性缺席表示允许该动作;写成 "0" 表示工作表受保护期间禁止该动作。格式良好的文件里不存在 formatCells="1" 来表示“允许设置格式”——你只需省略该属性。(缺席属性的默认值是 OOXML 布尔默认值 true,而这些属性的命名方式使得“true”表示相应编辑动作被允许。)
HotXLS 写入器完全照此办理。它发出 sheet="1" 打开保护,然后遍历选项集合,只为设成 False 的选项写入 attr="0"。被允许的动作对输出毫无贡献。于是上一节的工作簿序列化出来差不多是这样,只带着被禁止的动作和密码哈希:
// 上面片段的示意输出(为简洁省略了属性):
// <sheetProtection sheet="1"
// formatCells="0" formatColumns="0" formatRows="0"
// insertRows="0" deleteRows="0"
// password="...4-hex..."/>
// 请注意这里没有的是什么:没有 sort、autoFilter、selectLockedCells。
// 正是这些属性的缺席告诉 Excel 那些动作仍然被允许。
如果你期待看到每个属性都被一一写出,这看起来太稀疏,几乎像错的。但它是对的。列出 sort="1" 和 autoFilter="1" 的文件,对遵循规范的读取器来说意思相同,但 Excel 自己写的就是最小化的只禁式形式,与它保持一致能让 diff 更小、往返更无趣。objects 和 scenarios 属性遵循同一条规则:默认允许,所以只有你禁止它们时才会以 "0" 出现,与写死的 objects="1" scenarios="1" 正好相反
读回保护设置:往返保真度
只能写不能读的权限模型是一扇单向门,常见的症状是“加载-编辑-保存”循环悄悄放宽权限。HotXLS 避开了这一点。当 ParseWorksheetXml 遇到 <sheetProtection> 元素时,它把工作表设为受保护、在密码哈希存在时将其捕获,然后按同一约定反向把每个动作属性解码回 AllowOption:属性存在且等于 "0" 禁止该动作;属性缺席则让选项保持在默认的允许状态
var
wb: TXLSXWorkbook;
sh: TXLSXWorksheet;
begin
wb := TXLSXWorkbook.Create;
try
wb.Open('protection.xlsx');
sh := wb.Sheets[1]; // XLSX 工作表从 1 开始编号
if sh.IsProtected then
begin
Writeln('Protected; password hash present: ',
sh.SheetProtectHash <> '');
Writeln('Sort allowed: ', sh.AllowOption[xlsxSpoSort]);
Writeln('AutoFilter allowed: ', sh.AllowOption[xlsxSpoAutoFilter]);
Writeln('FormatCells allowed:', sh.AllowOption[xlsxSpoFormatCells]);
end;
finally
wb.Free;
end;
end;
加载写入器产出的文件,你会看到 Sort 和 AutoFilter 回来还是 True,FormatCells 是 False——你保存的集合原封不动。这种对称性正是全部意义所在:在受保护、部分放行的工作表里编辑一个单元格再保存,你没动过的十四项权限会原样存活,而不是塌缩回一个全有或全无的默认值
实务注意事项与限制
在你将此功能接入报表管线之前,有几件事值得了解:
- 密码弱是设计使然。XLSX 工作表保护存的是一个 16 位的旧式哈希(Excel 用了几十年的那一个),留在这里是为了互通性。它能挡住意外的编辑;挡不住有心的攻击者。别把它当成保密手段。要真正的保护,请加密工作簿
- 保护前设置选项没问题。无论工作表当前是否受保护,
AllowOption都可以赋值;这些开关只是描述一旦Protect生效,保护将允许什么。UnProtect清除保护状态和哈希,但为下一次保留你的选项集合 - 锁定单元格(Locked)语义仍然适用。保护只挡对设置了
Locked属性(工作簿默认)的单元格的编辑。让输入区域保持可编辑是单元格样式的职责,不是保护选项;这两层在 Excel 里的组合方式与此相同 - 这是 XLSX 引擎。选项模型对应 XLS 引擎较旧的
Allow*属性,但这里的枚举和属性名(xlsxSpo*、AllowOption)属于lxHandleX中的TXLSXWorksheet。如果你还在同一批工作表上驱动打印版面,保护与页面设置演练讲了这些设置如何与打印区域和页眉共存,数据验证、自动筛选与表格则与在锁定报表上保持xlsxSpoAutoFilter开放天然搭配
细粒度的保护模型和 XLSX 读写引擎的其余部分都在面向 Delphi 与 C++Builder 的 HotXLS Delphi Component 里交付;产品页带有完整的工作表 API,包括完整的保护选项参考