1. IronXL
  2. Guías
  3. Rango con nombre
Cómo gestionar rangos con nombre en Excel en C#

How to Add Named Range

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

A named range is a specified range of cells identified by a unique name. Instead of referring to a range by its cell addresses (like A1:B10), you can assign a name to a range, making it easier to reference and understand in formulas and functions. For example, if you named a range "SalesData," you could refer to it in a formula like SUM(SalesData) instead of specifying the cell range directly.

Quickstart: Add a Named Range with IronXL in One Line

Here’s how you can instantly define a named range using IronXL — super simple, zero hassle. Just pick your range and call the method; you'll be up and running in no time.

Nuget IconGet started making PDFs with NuGet now:

  1. Install IronXL with NuGet Package Manager

    PM > Install-Package IronXL.Excel

  2. Copy and run this code snippet.

    new IronXL.WorkBook()
    .DefaultWorkSheet["A1:B2"].SaveAsNamedRange("MyRange", true);

  3. Deploy to test on your live environment

    Start using IronXL in your project today with a free trial
    arrow pointer

Minimal Workflow (5 steps)

  1. Download the C# library to add named ranges
  2. Select the target range with workSheet["A1:A5"]
  3. Utilize the AddNamedRange method to add named ranges
  4. Retrieve named range in various ways
  5. Remove the named range with ease using the RemoveNamedRange method


Add Named Range Example

To add a named range, use the AddNamedRange method by passing the name of the named range as text and the range object.

: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
Named Range

Retrieve Named Range Example

Retrieve All Named Ranges

The GetNamedRanges method will return all named ranges in the worksheet as a list of strings.

: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

Retrieve Specific Named Range

Use the FindNamedRange method to retrieve the absolute reference of the named range, such as Sheet1!$A$1:$A$5. The address formula can then be used to reference the named range or select the corresponding range to the named range. When selecting the range, you should pay attention to the worksheet name.

: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

Remove Named Range Example

To remove the named range, use the RemoveNamedRange method by passing the named range name as text.

: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
Chaknith Bin
  Chatea con el equipo de ingeniería ahora
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,686,155 | Versión: 2025.11 recién lanzado