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
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 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.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 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.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 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.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, 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.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")
