Cómo gestionar rangos con nombre en Excel en C#

Cómo agregar un rango con nombre en C# con IronXL

This article was translated from English: Does it need improvement?
Translated
View the article in English

Un rango con nombre es un rango de celdas específico identificado 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, haciéndolo más fácil de referenciar y entender en fórmulas y funciones. Por ejemplo, si nombraste un rango "SalesData", podrías referirte a él en una fórmula como SUM(SalesData) en lugar de especificar directamente el rango de celdas.

como-título:2(Inicio rápido: Añadir un Rango con Nombre con IronXL en una línea)

Aquí te mostramos cómo definir instantáneamente un rango con nombre utilizando IronXL — súper simple, sin complicaciones. Solo elige tu rango y llama al método; estarás listo para comenzar en poco tiempo.

Nuget IconEmpieza a crear PDF con NuGet ahora:

  1. Instalar IronXL con el gestor de paquetes NuGet

    PM > Install-Package IronXL.Excel

  2. Copie y ejecute este fragmento de código.

    new IronXL.WorkBook()
        .DefaultWorkSheet["A1:B2"].SaveAsNamedRange("MyRange", true);
  3. Despliegue para probar en su entorno real

    Empieza a utilizar IronXL en tu proyecto hoy mismo con una prueba gratuita
    arrow pointer


Ejemplo de agregar rango con nombre

Para añadir un rango con nombre, utiliza 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.cs
using 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")
$vbLabelText   $csharpLabel
Rango con nombre

Ejemplo de recuperación de rango con nombre

Recuperar todos los rangos con nombre

El método GetNamedRanges devolverá todos los rangos con nombre 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.cs
using 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()
$vbLabelText   $csharpLabel

Recuperar un rango específico con nombre

Usa el método FindNamedRange para recuperar la referencia absoluta del rango con nombre, como Sheet1!$A$1:$A$5. La fórmula de dirección puede luego ser utilizada para referenciar el rango con nombre o seleccionar el rango correspondiente al rango con nombre. Al seleccionar el rango, debes 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;

// 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}")
$vbLabelText   $csharpLabel

Ejemplo de eliminación de rango con nombre

Para eliminar el rango con nombre, usa el método RemoveNamedRange pasando el nombre del rango con nombre 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;

// 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")
$vbLabelText   $csharpLabel

Preguntas Frecuentes

¿Cómo puedo crear un rango con nombre en Excel usando C#?

Puede crear un rango con nombre en Excel usando C# con IronXL utilizando el método AddNamedRange. Primero, descargue la biblioteca IronXL desde NuGet. Luego, seleccione el rango de celdas objetivo usando workSheet["A1:A5"] y páselo junto con el nombre al método AddNamedRange.

¿Cuál es el propósito de usar rangos con nombre en Excel?

Los rangos con nombre en Excel le permiten asignar un nombre único a un rango de celdas, facilitando su referencia en fórmulas y funciones. Esto mejora la legibilidad y reduce los errores al permitirle usar nombres como 'SalesData' en lugar de referencias de celdas como 'A1:B10'.

¿Cómo recupero todos los rangos con nombre de una hoja de cálculo en C#?

Puede recuperar todos los rangos con nombre de una hoja de cálculo en C# usando el método GetNamedRanges de IronXL, que devuelve una lista de todos los rangos con nombre en la hoja de cálculo como cadenas.

¿Puedo recuperar un rango con nombre específico de una hoja de cálculo de Excel?

Sí, para recuperar un rango con nombre específico de una hoja de cálculo de Excel usando IronXL, use el método FindNamedRange. Este método le proporciona la referencia absoluta del rango con nombre, tal como Sheet1!$A$1:$A$5.

¿Qué método debo usar para eliminar un rango con nombre en C#?

Para eliminar un rango con nombre en C#, use el método RemoveNamedRange de IronXL. Pase el nombre del rango con nombre como parámetro a este método para eliminarlo.

¿Cómo pueden los desarrolladores beneficiarse de usar IronXL para gestionar rangos con nombre?

Los desarrolladores se benefician de usar IronXL para gestionar rangos con nombre ya que simplifica tareas como crear, recuperar y eliminar rangos con nombre de manera programática. Esto mejora la claridad y el mantenimiento de los archivos de Excel, facilitando la gestión de referencias de celdas en aplicaciones C#.

¿Cómo puedo empezar a usar IronXL para la manipulación de Excel en C#?

Para comenzar a usar IronXL para la manipulación de Excel en C#, descargue la biblioteca IronXL desde el administrador de paquetes NuGet. Luego, use los métodos proporcionados como AddNamedRange, GetNamedRanges y RemoveNamedRange para gestionar rangos con nombre de manera efectiva dentro de sus aplicaciones C#.

Chaknith Bin
Ingeniero de Software
Chaknith trabaja en IronXL e IronBarcode. Tiene un profundo conocimiento en C# y .NET, ayudando a mejorar el software y apoyar a los clientes. Sus conocimientos derivados de las interacciones con los usuarios contribuyen a mejores productos, documentación y experiencia en general.
¿Listo para empezar?
Nuget Descargas 1,738,553 | Version: 2025.11 recién lanzado