ReoGrid 中的范围由起始位置和大小定义。一个范围包含一个或多个单元格。范围可以相互交叉，范围与合并单元格不同（尽管范围可以被合并）。

ReoGrid 通过两种主要类型表示范围：

• RangePosition — 一个轻量级结构体，保存位置和大小信息。不绑定到任何工作表。
• ReferenceRange — 一个绑定到特定工作表的类，提供对数据、样式和操作的直接访问。

RangePosition

RangePosition 结构体存储用于标识范围的数值信息：起始行、起始列、行数和列数。所有索引从零开始。

// 从地址字符串创建
var range = new RangePosition("C5:H14");

// 从行、列、行数、列数创建
var range = new RangePosition(4, 2, 10, 6);

// 从起始和结束位置创建
var range = new RangePosition(new CellPosition("C5"), new CellPosition("H14"));

// 从两个地址字符串创建
var range = new RangePosition("C5", "H14");

// 单个单元格
var range = new RangePosition(new CellPosition("A1"));

属性

方法

静态成员

获取安全范围

当范围可能超出工作表边界时，使用 FixRange：

var safeRange = sheet.FixRange(range);

ReferenceRange

ReferenceRange 绑定到特定工作表，提供对该范围的数据、样式、边框、格式和操作的直接访问。

获取 ReferenceRange

使用工作表上的 Ranges 集合：

var range = sheet.Ranges["B2:D3"];
var range = sheet.Ranges[1, 1, 2, 3];         // 行、列、行数、列数
var range = sheet.Ranges[new RangePosition(1, 1, 2, 3)];
var range = sheet.Ranges[new CellPosition("B2"), new CellPosition("D3")];

属性

位置

数据和内容

// 设置范围数据
range.Data = new object[] { "Product", "Price", "Quantity" };

样式

range.Style.BackColor = Color.LightBlue;
range.Style.Bold = true;

边框快捷方式

range.BorderOutside = RangeBorderStyle.BlackSolid;
range.Border.Outside = RangeBorderStyle.BlackSolid;  // 等效写法

数据格式

保护

验证

方法

遍历单元格

var range = sheet.Ranges["A1:C3"];

range.IterateCells((row, col, cell) =>
{
    Console.WriteLine($"Cell [{row},{col}]: {cell?.Data}");
    return true;  // 继续遍历
});

类型之间的转换

// RangePosition → ReferenceRange
var refRange = sheet.Ranges[rangePosition];

// ReferenceRange → RangePosition
RangePosition pos = refRange.Position;

// 隐式转换（ReferenceRange 转 RangePosition）
RangePosition pos = refRange;

// 两者都可用于赋值
sheet.SelectionRange = rangePosition;
sheet.SelectionRange = refRange;

清除范围内容

使用 ClearRangeContent 有选择地清除范围中的元素：

// 仅清除数据
sheet.ClearRangeContent("A1:B5", CellElementFlag.Data);

// 仅清除公式
sheet.ClearRangeContent("A1:B5", CellElementFlag.Formula);

// 清除所有内容
sheet.ClearRangeContent("A1:B5", CellElementFlag.All);

CellElementFlag 枚举（标志）

已使用范围

获取包含数据的范围：

RangePosition usedRange = sheet.UsedRange;

命名范围

命名范围是带有名称的特殊 ReferenceRange 实例。参见命名范围。

相关主题

• 命名范围 — 定义和使用命名范围
• 合并单元格 — 合并和取消合并范围
• 单元格样式 — 单元格和范围的样式设置
• 边框 — 边框样式
• 数据格式 — 数据格式化