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");Imports IronXL Private workBook As WorkBook = WorkBook.Create() Private workSheet As WorkSheet = workBook.DefaultWorkSheet ' Select range Private 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();Imports IronXL Private workBook As WorkBook = WorkBook.Load("addNamedRange.xlsx") Private workSheet As WorkSheet = workBook.DefaultWorkSheet ' Get all named range 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 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}"];Imports IronXL Private workBook As WorkBook = WorkBook.Load("addNamedRange.xlsx") Private workSheet As WorkSheet = workBook.DefaultWorkSheet ' Get named range address Private namedRangeAddress As String = workSheet.FindNamedRange("range1") ' Select range Private 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");Imports IronXL Private workBook As WorkBook = WorkBook.Load("addNamedRange.xlsx") Private workSheet As WorkSheet = workBook.DefaultWorkSheet ' Remove named range workSheet.RemoveNamedRange("range1")
