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, lo que facilita su referencia y comprensión en fórmulas y funciones. Por ejemplo, si nombró un rango como "SalesData", podría referirse a él en una fórmula como SUM(SalesData) en lugar de especificar directamente el rango de celdas.
Cómo añadir un ámbito con nombre
Comienza con IronXL
Comience a usar IronXL en su proyecto hoy con una prueba gratuita.
Ejemplo de adición de un ámbito con nombre
Para agregar un rango con nombre, use el método AddNamedRange pasando el nombre del rango con nombre como texto y el objeto de rango.
:path=/static-assets/excel/content-code-examples/how-to/named-range-add-named-range.csusing 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");
Ejemplo de recuperación de un ámbito con nombre
Recuperar todos los rangos nombrados
El método GetNamedRanges devolverá todos los rangos nombrados en 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.csusing IronXL;
WorkBook workBook = WorkBook.Load("addNamedRange.xlsx");
WorkSheet workSheet = workBook.DefaultWorkSheet;
// Get all named range
var 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 puede entonces usarse para referenciar el rango nombrado o para seleccionar el rango correspondiente al rango nombrado. 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.csusing 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}"];Ejemplo de eliminación de un ámbito con nombre
Para eliminar el rango nombrado, utiliza 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.csusing IronXL;
WorkBook workBook = WorkBook.Load("addNamedRange.xlsx");
WorkSheet workSheet = workBook.DefaultWorkSheet;
// Remove named range
workSheet.RemoveNamedRange("range1");
