跳转至

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 即对象模型属性,直接赋值即可:

ws.FreezeRows = 1;
ws.FreezeColumns = 1;

12.2 FreezeHeader 兼容

FreezeHeader = true 等价于 FreezeRows = 1:

ws.FreezeHeader = true;   // 冻结首行

12.3 读回冻结

打开文件后读取 FreezeRows / FreezeColumns:

var opened = Excel.Open("frozen.xlsx");
var ws = opened.Worksheets[0];
Console.WriteLine($"{ws.FreezeRows} rows, {ws.FreezeColumns} cols");

输出:

2 rows, 3 cols

冻结窗格效果

上图由本章示例代码写出,在 Excel 中打开的效果:冻结首两行与首列,滚动时表头与编号列保持可见。