如何在 C# 中管理 Excel 命名范围

如何使用 IronXL 在 C# 中添加命名范围

This article was translated from English: Does it need improvement?
Translated
View the article in English

命名区域是指由唯一名称标识的指定单元格区域。 你可以给一个区域指定一个名称,而不是通过单元格地址(例如 A1:B10)来引用它,这样在公式和函数中更容易引用和理解它。 例如,如果您将一个区域命名为"SalesData",则可以在公式中引用它,例如 SUM(SalesData),而不是直接指定单元格区域。

在使用 C# 中的 Excel 公式时,命名范围尤其有用,因为它们可以使您的代码更具可读性和可维护性。 当与 IronXl.Excel 强大的范围选择功能相结合时,命名范围将成为高效管理电子表格的重要工具。

快速入门:使用IronXL一行代码添加命名范围

使用 IronXL,只需调用一个方法即可定义一个命名范围。 选择您的范围并应用 SaveAsNamedRange 方法。

  1. 使用 NuGet 包管理器安装 https://www.nuget.org/packages/IronXl.Excel

    PM > Install-Package IronXl.Excel
  2. 复制并运行这段代码。

    new IronXl.WorkBook()
        .DefaultWorkSheet["A1:B2"].SaveAsNamedRange("MyRange", true);
  3. 部署到您的生产环境中进行测试

    通过免费试用立即在您的项目中开始使用IronXL

    arrow pointer


如何在工作表中添加命名范围?

要添加命名范围,请使用 AddNamedRange 方法,将命名范围的名称作为文本传递,并将范围对象传递。 本方法是 IronXl.Excel 综合工作表管理功能的一部分。

:path=/static-assets/excel/content-code-examples/how-to/named-range-add-named-range.cs
using IronXL;

WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Select range
var selectedRange = workSheet["A1:A5"];

// Add named range
workSheet.AddNamedRange("range1", selectedRange);

workBook.SaveAs("addNamedRange.xlsx");
$vbLabelText   $csharpLabel

在创建命名范围时,必须遵循 Excel 的命名约定:

  • 名称必须以字母或下划线开头
  • 名称不能包含空格(使用下划线代替)
  • 名称不能与单元格引用(如 "A1 "或 "R1C1")冲突
  • 名称不区分大小写,但保持大小写一致可提高可读性
Excel 名称框显示选中并高亮显示单元格 A1:A5 的

还可以为非连续选区或整行/列创建命名范围。 有关更复杂的范围操作,请查看合并多个 Excel 范围指南。


如何从我的工作簿中检索已命名的范围?

什么方法可以一次性获取所有已命名的范围?

GetNamedRanges 方法将工作表中所有已命名的区域作为字符串列表返回。 当您需要审核或记录工作簿中的所有命名范围时,这一点尤其有用,类似于加载现有电子表格以分析其结构。

:path=/static-assets/excel/content-code-examples/how-to/named-range-retrieve-all-named-range.cs
using IronXL;

WorkBook workBook = WorkBook.Load("addNamedRange.xlsx");
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Get all named range
var namedRangeList = workSheet.GetNamedRanges();
$vbLabelText   $csharpLabel

如何通过名称查找特定的命名范围?

使用 FindNamedRange 方法检索命名范围的绝对引用,例如 Sheet1!$A$1:$A$5。 然后可以使用地址公式来引用命名范围,或者选择与命名范围对应的范围。 选择区域时,请注意工作表名称。

:path=/static-assets/excel/content-code-examples/how-to/named-range-retrieve-specific-named-range.cs
using IronXL;

WorkBook workBook = WorkBook.Load("addNamedRange.xlsx");
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Get named range address
string namedRangeAddress = workSheet.FindNamedRange("range1");

// Select range
var range = workSheet[$"{namedRangeAddress}"];
$vbLabelText   $csharpLabel

在多个工作表中使用命名范围

命名范围可以是工作簿级别,也可以是工作表级别。 工作簿级别的名称可以从任何工作表中访问,而工作表级别的名称只能在其特定的工作表中访问。 在管理 Excel 文件中的多个工作表时,这种区分非常重要。

// Example: Accessing named ranges from different worksheets
WorkBook workBook = WorkBook.Load("multisheet.xlsx");
WorkSheet sheet1 = workBook.GetWorkSheet("Sheet1");
WorkSheet sheet2 = workBook.GetWorkSheet("Sheet2");

// Both can access a workbook-level named range
var range1 = sheet1["GlobalData"];
var range2 = sheet2["GlobalData"];  // Same named range
// Example: Accessing named ranges from different worksheets
WorkBook workBook = WorkBook.Load("multisheet.xlsx");
WorkSheet sheet1 = workBook.GetWorkSheet("Sheet1");
WorkSheet sheet2 = workBook.GetWorkSheet("Sheet2");

// Both can access a workbook-level named range
var range1 = sheet1["GlobalData"];
var range2 = sheet2["GlobalData"];  // Same named range
$vbLabelText   $csharpLabel

如何从工作表中删除命名范围?

要删除命名范围,请使用 RemoveNamedRange 方法,并将命名范围名称作为文本传递。 这对于维护整洁、有序的工作簿以及在更新电子表格结构时防止命名冲突至关重要。

:path=/static-assets/excel/content-code-examples/how-to/named-range-remove-named-range.cs
using IronXL;

WorkBook workBook = WorkBook.Load("addNamedRange.xlsx");
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Remove named range
workSheet.RemoveNamedRange("range1");
$vbLabelText   $csharpLabel

高级命名范围场景

使用公式命名范围

当与 Excel 公式一起使用时,命名范围才能真正发挥作用。 它们使公式更易读、更易维护。 有关全面的公式管理,请参阅C#中的Excel公式指南。

// Create named ranges for formula use
WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Create sample data
workSheet["A1:A5"].Value = new int[] { 10, 20, 30, 40, 50 };
workSheet["B1:B5"].Value = new int[] { 5, 10, 15, 20, 25 };

// Add named ranges
workSheet.AddNamedRange("FirstColumn", workSheet["A1:A5"]);
workSheet.AddNamedRange("SecondColumn", workSheet["B1:B5"]);

// Use named ranges in formulas
workSheet["D1"].Formula = "=SUM(FirstColumn)";
workSheet["D2"].Formula = "=AVERAGE(SecondColumn)";
workSheet["D3"].Formula = "=SUM(FirstColumn) + SUM(SecondColumn)";

// Evaluate formulas
workSheet.EvaluateAll();
// Create named ranges for formula use
WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Create sample data
workSheet["A1:A5"].Value = new int[] { 10, 20, 30, 40, 50 };
workSheet["B1:B5"].Value = new int[] { 5, 10, 15, 20, 25 };

// Add named ranges
workSheet.AddNamedRange("FirstColumn", workSheet["A1:A5"]);
workSheet.AddNamedRange("SecondColumn", workSheet["B1:B5"]);

// Use named ranges in formulas
workSheet["D1"].Formula = "=SUM(FirstColumn)";
workSheet["D2"].Formula = "=AVERAGE(SecondColumn)";
workSheet["D3"].Formula = "=SUM(FirstColumn) + SUM(SecondColumn)";

// Evaluate formulas
workSheet.EvaluateAll();
$vbLabelText   $csharpLabel

动态命名范围

虽然 IronXl.Excel 并不直接支持 Excel 的动态命名范围(使用 OFFSET 或 INDEX 函数),但您可以根据数据变化以编程方式更新命名范围:

// Update named range based on data size
WorkBook workBook = WorkBook.Load("dynamicData.xlsx");
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Find last row with data
int lastRow = 1;
while (!workSheet[$"A{lastRow}"].IsEmpty)
{
    lastRow++;
}
lastRow--; // Adjust to actual last row

// Remove old range and add new one
workSheet.RemoveNamedRange("DataRange");
workSheet.AddNamedRange("DataRange", workSheet[$"A1:A{lastRow}"]);
// Update named range based on data size
WorkBook workBook = WorkBook.Load("dynamicData.xlsx");
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Find last row with data
int lastRow = 1;
while (!workSheet[$"A{lastRow}"].IsEmpty)
{
    lastRow++;
}
lastRow--; // Adjust to actual last row

// Remove old range and add new one
workSheet.RemoveNamedRange("DataRange");
workSheet.AddNamedRange("DataRange", workSheet[$"A1:A{lastRow}"]);
$vbLabelText   $csharpLabel

用于数据验证的命名范围

命名范围是创建数据验证列表和约束的绝佳工具。 当与Excel 的数据验证功能相结合时,它们提供了一种确保数据完整性的强大方法:

// Create a named range for validation list
workSheet["F1:F5"].Value = new string[] { "Option1", "Option2", "Option3", "Option4", "Option5" };
workSheet.AddNamedRange("ValidationList", workSheet["F1:F5"]);

// Apply to data validation (conceptual example)
// The actual validation would reference "ValidationList"
// Create a named range for validation list
workSheet["F1:F5"].Value = new string[] { "Option1", "Option2", "Option3", "Option4", "Option5" };
workSheet.AddNamedRange("ValidationList", workSheet["F1:F5"]);

// Apply to data validation (conceptual example)
// The actual validation would reference "ValidationList"
$vbLabelText   $csharpLabel

最佳实践和性能提示

1.命名约定:使用描述性、一致的名称,以表明数据的用途(例如,Sales_Q1_2024 而不是"Data1")。 2.范围管理:有意识地确定工作簿与工作表的范围,以避免冲突 3.文档:维护命名范围及其用途的列表,尤其是在复杂的工作簿中 4.性能:命名范围对性能的影响最小,但要避免创建数千个微小的命名范围 5.更新:当数据结构发生变化时,更新或删除相应的命名范围以保持准确性

有关更多高级 Excel 操作和性能优化,请浏览 完整的 IronXL 文档,或查看特定功能,如 对 Excel 范围进行排序 处理 Excel 表格

常见问题解答

如何使用 C# 在 Excel 中创建命名范围?

要在 Excel 中使用 C# 和 IronXL 创建命名范围,请使用工作表索引器选择目标范围(例如,workSheet["A1:B2"]),然后调用 SaveAsNamedRange 方法,并输入所需的名称。您也可以使用 AddNamedRange 方法,将名称作为文本和范围对象传入。

Excel 命名范围的命名规则是什么?

使用 IronXL 创建命名范围时,请遵循这些 Excel 命名约定:名称必须以字母或下划线开头,不能包含空格(使用下划线代替),不能与单元格引用(如 "A1")冲突,并且不区分大小写。创建命名范围时,IronXL 会自动执行这些规则。

能否以编程方式检索 Excel 工作簿中的所有命名范围?

是的,IronXL 提供了 GetNamedRanges 方法,该方法以字符串列表的形式返回工作表中的所有命名范围。该功能在审核或记录已加载 IronXL 的现有工作簿中的命名范围时特别有用。

命名范围如何改进我的 C# Excel 公式?

在使用 IronXl.Excel 时,命名范围使 Excel 公式更具可读性和可维护性。您可以在公式中使用 "SalesData "这样的描述性名称,而不是使用 "A1:B10 "这样的单元格引用,从而使您的 C# 代码更加清晰易懂。

是否可以为非连续单元格创建命名范围?

是的,IronXL 支持为非连续选区和整行或整列创建命名范围。该库的综合工作表管理功能允许您定义复杂的命名范围,而不是简单的矩形选择。

在一行代码中添加命名范围的最快方法是什么?

使用 IronXL,您可以在一行中创建一个命名范围,方法是:new IronXl.WorkBook().DefaultWorkSheet["A1:B2"].SaveAsNamedRange("MyRange", true)。这演示了 IronXl.Excel 简化的 Excel 操作 API。

如何删除 Excel 工作表中的命名范围?

IronXL 提供了 RemoveNamedRange 方法,可轻松删除工作表中的命名范围。这是该库全命名范围管理功能的一部分,可让您以编程方式添加、检索和删除命名范围。

Curtis Chau
技术作家

Curtis Chau 拥有卡尔顿大学的计算机科学学士学位,专注于前端开发,精通 Node.js、TypeScript、JavaScript 和 React。他热衷于打造直观且美观的用户界面,喜欢使用现代框架并创建结构良好、视觉吸引力强的手册。

除了开发之外,Curtis 对物联网 (IoT) 有浓厚的兴趣,探索将硬件和软件集成的新方法。在空闲时间,他喜欢玩游戏和构建 Discord 机器人,将他对技术的热爱与创造力相结合。

A PHP Error was encountered

Severity: Notice

Message: Undefined index: IronXl.Excel

Filename: helpers/counter_helper.php

Line Number: 85

Backtrace:

File: /var/www/ironpdf.com/application/helpers/counter_helper.php
Line: 85
Function: _error_handler

File: /var/www/ironpdf.com/application/views/main/sections/ready_to_started_202509.php
Line: 12
Function: getTotalDonwloadNumber

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 489
Function: view

File: /var/www/ironpdf.com/application/controllers/Products/Howto.php
Line: 31
Function: render_products_view

File: /var/www/ironpdf.com/index.php
Line: 292
Function: require_once

A PHP Error was encountered

Severity: Notice

Message: Undefined index: IronXl.Excel

Filename: helpers/counter_helper.php

Line Number: 85

Backtrace:

File: /var/www/ironpdf.com/application/helpers/counter_helper.php
Line: 85
Function: _error_handler

File: /var/www/ironpdf.com/application/views/main/sections/ready_to_started_202509.php
Line: 19
Function: getTotalDonwloadNumber

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 489
Function: view

File: /var/www/ironpdf.com/application/controllers/Products/Howto.php
Line: 31
Function: render_products_view

File: /var/www/ironpdf.com/index.php
Line: 292
Function: require_once

准备开始了吗?
Nuget 下载 1,890,100 | 版本: 2026.3 刚刚发布

A PHP Error was encountered

Severity: Notice

Message: Undefined index: IronXl.Excel

Filename: helpers/counter_helper.php

Line Number: 85

Backtrace:

File: /var/www/ironpdf.com/application/helpers/counter_helper.php
Line: 85
Function: _error_handler

File: /var/www/ironpdf.com/application/views/main/sections/still_scrolling_202512.php
Line: 17
Function: getTotalDonwloadNumber

File: /var/www/ironpdf.com/application/views/products/sections/three_column_docs_page_structure.php
Line: 71
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 88
Function: view

File: /var/www/ironpdf.com/application/views/products/how-to/index.php
Line: 2
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 88
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 552
Function: view

File: /var/www/ironpdf.com/application/controllers/Products/Howto.php
Line: 31
Function: render_products_view

File: /var/www/ironpdf.com/index.php
Line: 292
Function: require_once

A PHP Error was encountered

Severity: Notice

Message: Undefined index: IronXl.Excel

Filename: helpers/counter_helper.php

Line Number: 85

Backtrace:

File: /var/www/ironpdf.com/application/helpers/counter_helper.php
Line: 85
Function: _error_handler

File: /var/www/ironpdf.com/application/views/main/sections/still_scrolling_202512.php
Line: 24
Function: getTotalDonwloadNumber

File: /var/www/ironpdf.com/application/views/products/sections/three_column_docs_page_structure.php
Line: 71
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 88
Function: view

File: /var/www/ironpdf.com/application/views/products/how-to/index.php
Line: 2
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 88
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 552
Function: view

File: /var/www/ironpdf.com/application/controllers/Products/Howto.php
Line: 31
Function: render_products_view

File: /var/www/ironpdf.com/index.php
Line: 292
Function: require_once

Still Scrolling Icon

还在滚动吗?

想快速获得证据? PM > Install-Package IronXl.Excel
运行示例 观看您的数据变成电子表格。