12. 冻结窗格¶
本章介绍冻结行与列的设置、FreezeHeader 兼容写法,以及读回冻结。
Warning
冻结窗格支持 xlsx / xlsm / xlsb / xls 四格式任意行列。写到 csv 时冻结信息被丢弃,经 OnDegradation 上报(见第 22 章)。
12.1 设置冻结行与列¶
Worksheet.FreezeRows / FreezeColumns 为 1-based 冻结行 / 列数(0 = 不冻结):
var ws = Excel.Create().Worksheets["Sheet1"];
ws.FreezeRows = 2; // 冻结前 2 行
ws.FreezeColumns = 3; // 冻结前 3 列
| 参数 | 类型 | 说明 |
|---|---|---|
FreezeRows |
int |
1-based 冻结行数,0 = 不冻结 |
FreezeColumns |
int |
1-based 冻结列数,0 = 不冻结 |
对象模型:属性直接设置:FreezeRows / FreezeColumns 即对象模型属性,直接赋值即可:
12.2 FreezeHeader 兼容¶
FreezeHeader = true 等价于 FreezeRows = 1:
12.3 读回冻结¶
打开文件后读取 FreezeRows / FreezeColumns:
var opened = Excel.Open("frozen.xlsx");
var ws = opened.Worksheets[0];
Console.WriteLine($"{ws.FreezeRows} rows, {ws.FreezeColumns} cols");
输出:
