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

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

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

快速入门：使用 IronXL 一行添加命名范围

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

如何在工作表中添加命名范围？ 要添加命名范围，请使用`AddNamedRange`方法，并将命名范围的名称作为文本传递给该范围对象。 本方法是 IronXL.Excel 综合[工作表管理](https://ironsoftware.com/csharp/excel/how-to/manage-worksheet/)功能的一部分。 ```csharp :path=/static-assets/excel/content-code-examples/how-to/named-range-add-named-range.cs ``` 在创建命名范围时，必须遵循 Excel 的命名约定： - 名称必须以字母或下划线开头 - 名称不能包含空格（使用下划线代替） - 名称不能与单元格引用（如 "A1 "或 "R1C1"）冲突 - 名称不区分大小写，但保持大小写一致可提高可读性

还可以为非连续选区或整行/列创建命名范围。 有关更复杂的范围操作，请查看[合并多个 Excel 范围](https://ironsoftware.com/csharp/excel/examples/combine-excel-ranges/)指南。

---

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

什么方法可以一次性获取所有已命名的范围？ `GetNamedRanges` 方法以字符串列表的形式返回工作表中的所有命名范围。 当您需要审核或记录工作簿中的所有命名范围时，这一点尤其有用，类似于[加载现有电子表格](https://ironsoftware.com/csharp/excel/how-to/load-spreadsheet/)以分析其结构。 ```csharp :path=/static-assets/excel/content-code-examples/how-to/named-range-retrieve-all-named-range.cs ```

如何通过名称查找特定的命名范围？ 使用`FindNamedRange`方法检索命名区域的绝对引用，例如`Sheet1!$A$1:$A$5` 。 然后可以使用地址公式来引用命名范围，或者选择与命名范围对应的范围。 选择区域时，请注意工作表名称。 ```csharp :path=/static-assets/excel/content-code-examples/how-to/named-range-retrieve-specific-named-range.cs ``` ### 在多个工作表中使用命名范围 命名范围可以是工作簿级别，也可以是工作表级别。 工作簿级别的名称可以从任何工作表中访问，而工作表级别的名称只能在其特定的工作表中访问。 在[管理 Excel 文件中的多个工作表](https://ironsoftware.com/csharp/excel/how-to/manage-worksheet/)时，这种区分非常重要。 ```csharp // 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 ```

---

如何从工作表中删除命名范围？ 要删除命名范围，请使用`RemoveNamedRange`方法，并将命名范围名称作为文本传递。 这对于维护整洁、有序的工作簿以及在更新电子表格结构时防止命名冲突至关重要。 ```csharp :path=/static-assets/excel/content-code-examples/how-to/named-range-remove-named-range.cs ``` ## 高级命名范围场景 ### 使用公式命名范围 当与 Excel 公式一起使用时，命名范围才能真正发挥作用。 它们使公式更易读、更易维护。 有关全面的公式管理，请参阅[C#中的Excel公式](https://ironsoftware.com/csharp/excel/examples/excel-formulas-csharp/)指南。 ```csharp // 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(); ``` ### 动态命名范围 虽然 IronXL.Excel 并不直接支持 Excel 的动态命名范围（使用 OFFSET 或 INDEX 函数），但您可以根据数据变化以编程方式更新命名范围： ```csharp // 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}"]); ``` ### 用于数据验证的命名范围 命名范围是创建数据验证列表和约束的绝佳工具。 当与[Excel 的数据验证功能](https://ironsoftware.com/csharp/excel/how-to/set-cell-data-format/)相结合时，它们提供了一种确保数据完整性的强大方法： ```csharp // 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" ``` ## 最佳实践和性能提示 1.**命名约定**：使用描述性的、一致的名称来表明数据的用途（例如，`Sales_Q1_2024`，而不是 "Data1"）。 2.**范围管理**：有意识地确定工作簿与工作表的范围，以避免冲突 3.**文档**：维护命名范围及其用途的列表，尤其是在复杂的工作簿中 4.**性能**：命名范围对性能的影响最小，但要避免创建数千个微小的命名范围 5.**更新**：当数据结构发生变化时，更新或删除相应的命名范围以保持准确性 有关更多高级 Excel 操作和性能优化，请浏览 [ 完整的 IronXL 文档](https://ironsoftware.com/csharp/excel/docs/)，或查看特定功能，如 [ 对 Excel 范围进行排序](https://ironsoftware.com/csharp/excel/examples/sort-excel-range-csharp/)或 [ 处理 Excel 表格](https://ironsoftware.com/csharp/excel/how-to/named-table/)。