dotNet.ReoGrid 扩展库 - 命名区域

通过编程定义命名区域

要定义命名区域，可以使用 DefineNamedRange 方法：

// 获取当前工作表
var sheet1 = grid.CurrentWorksheet;
// 定义从 C3 开始到 F3 结束的命名区域，包含 4 列
sheet1.DefineNamedRange("header", "C3:F3");

通过指定名称向工作表中设置数据：

// 在名为 'header' 的区域设置表头文本
sheet1["header"] = { "姓名", "年龄", "生日", "邮箱" };

4列中显示的文本如下所示：

也可以通过命名区域实例来设置数据。

// 定义一个命名区域
var namedRange = sheet1.DefineNamedRange("items", "B2:E2"); 
// 向命名区域设置值
namedRange.Data = { 1, 3, 5, 7 };

在公式中使用名称

要在公式中通过名称引用区域，可以直接使用名称：

var range = sheet1.DefineNamedRange("r1", "A1:C2");
range.Data = { 
  {1, 2, 3},  
  {4, 5, 6}
};
sheet1["E2"] = "=SUM(r1)";

有关公式的更多信息，请参阅公式。

移除命名区域定义

要从电子表格中移除命名区域定义，可以使用 UndefineNamedRange 方法。

sheet1.UndefineNamedRange("myname");

自定义名称解析提供程序

即使未在电子表格中定义，也可以在公式中使用自定义名称：

sheet1["F1"] = "=myName1 + myName2";

myName1 和 myName2 并未定义为命名区域，要通过编程提供它们的值，可以使用自定义名称解析提供程序，请参阅自定义函数。

插入/删除行列后区域的变化

插入/删除行列会影响命名区域：

• 如果在命名区域前插入行或列，命名区域会自动移动。
• 如果在命名区域内插入行或列，命名区域中的行或列会自动增加。
• 如果在命名区域内删除行或列，命名区域中的行或列也会自动移除。如果命名区域中的所有行或列都被删除，该区域也会自动移除。

目前无法更改上述行为。

事件

要在定义任何命名区域时获取事件，使用 NamedRangeDefined 事件；要在移除任何命名区域定义时获取事件，使用 NamedRangeUndefined 事件。

在 ReoGridEditor 中定义命名区域

要在 ReoGridEditor 中定义命名区域，选择目标区域，然后选择菜单 公式->定义命名区域。

点击"确定"后，名称会显示在地址栏的下拉列表中：

选择名称"header"，对应的区域会被选中。

Markdown 格式