Cómo añadir un ámbito con nombre
Un rango con nombre es un rango específico de celdas identificadas por un nombre único. En lugar de referirse a un rango por sus direcciones de celda (como A1:B10)puede asignar un nombre a un rango, facilitando su referencia y comprensión en fórmulas y funciones. Por ejemplo, si denomina a un intervalo "DatosVenta", puede referirse a él en una fórmula como SUMA(SalesData) en lugar de especificar directamente el rango de celdas.
Cómo añadir un ámbito con nombre
Instalar con NuGet
Install-Package IronXL.Excel
Ejemplo de adición de un ámbito con nombre
Para añadir un rango con nombre, utilice el método AddNamedRange
pasando el nombre del rango con nombre como texto y el objeto rango.
: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;
// Seleccionar gama
var selectedRange = workSheet["A1:A5"];
// Añadir rango con nombre
workSheet.AddNamedRange("range1", selectedRange);
workBook.SaveAs("addNamedRange.xlsx");
Imports IronXL
Private workBook As WorkBook = WorkBook.Create()
Private workSheet As WorkSheet = workBook.DefaultWorkSheet
' Seleccionar gama
Private selectedRange = workSheet("A1:A5")
' Añadir rango con nombre
workSheet.AddNamedRange("range1", selectedRange)
workBook.SaveAs("addNamedRange.xlsx")
![Gama Nominal](/static-assets/excel/how-to/named-range/named-range.webp)
Ejemplo de recuperación de un ámbito con nombre
Recuperar todos los rangos nombrados
El método GetNamedRanges
devolverá todos los rangos con nombre de la hoja de cálculo como una lista de cadenas.
: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;
// Obtener todos los rangos con nombre
var namedRangeList = workSheet.GetNamedRanges();
Imports IronXL
Private workBook As WorkBook = WorkBook.Load("addNamedRange.xlsx")
Private workSheet As WorkSheet = workBook.DefaultWorkSheet
' Obtener todos los rangos con nombre
Private namedRangeList = workSheet.GetNamedRanges()
Recuperar un ámbito específico
Utilice el método FindNamedRange
para recuperar la referencia absoluta del rango nombrado, como Hoja1!$A$1:$A$5. La fórmula de dirección se puede utilizar entonces para hacer referencia al rango con nombre o seleccionar el rango correspondiente al rango con nombre. Al seleccionar el rango, debe prestar atención al nombre de la hoja de cálculo.
: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;
// Obtener dirección de rango con nombre
string namedRangeAddress = workSheet.FindNamedRange("range1");
// Seleccionar gama
var range = workSheet[$"{namedRangeAddress}"];
Imports IronXL
Private workBook As WorkBook = WorkBook.Load("addNamedRange.xlsx")
Private workSheet As WorkSheet = workBook.DefaultWorkSheet
' Obtener dirección de rango con nombre
Private namedRangeAddress As String = workSheet.FindNamedRange("range1")
' Seleccionar gama
Private range = workSheet($"{namedRangeAddress}")
Ejemplo de eliminación de un ámbito con nombre
Para eliminar el rango nombrado, utilice el método RemoveNamedRange
pasando el nombre del rango nombrado como texto.
: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;
// Eliminar el ámbito con nombre
workSheet.RemoveNamedRange("range1");
Imports IronXL
Private workBook As WorkBook = WorkBook.Load("addNamedRange.xlsx")
Private workSheet As WorkSheet = workBook.DefaultWorkSheet
' Eliminar el ámbito con nombre
workSheet.RemoveNamedRange("range1")