1. IronXL
  2. Guides pratiques
  3. Plage Nommée
Comment gérer les plages nommées dans Excel en C#

How to Add Named Range

Chaknith Bin
Chaknith Bin
Mis à jour:
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

Questions Fréquemment Posées

Comment puis-je créer une plage nommée dans Excel en utilisant C# ?

Vous pouvez créer une plage nommée dans Excel en utilisant C# avec IronXL en utilisant la méthode AddNamedRange. Tout d'abord, téléchargez la bibliothèque IronXL à partir de NuGet. Ensuite, sélectionnez la plage de cellules cible en utilisant workSheet["A1:A5"] et transmettez-la avec le nom à la méthode AddNamedRange.

Quel est le but d'utiliser des plages nommées dans Excel ?

Les plages nommées dans Excel vous permettent d'assigner un nom unique à une plage de cellules, facilitant ainsi leur référence dans les formules et fonctions. Cela améliore la lisibilité et réduit les erreurs en vous permettant d'utiliser des noms comme 'SalesData' au lieu de références de cellules comme 'A1:B10'.

Comment puis-je récupérer toutes les plages nommées d'une feuille de calcul en C# ?

Vous pouvez récupérer toutes les plages nommées d'une feuille de calcul en C# en utilisant la méthode GetNamedRanges de IronXL, qui renvoie une liste de toutes les plages nommées de la feuille de calcul sous forme de chaînes.

Puis-je récupérer une plage nommée spécifique d'une feuille de calcul Excel ?

Oui, pour récupérer une plage nommée spécifique d'une feuille de calcul Excel en utilisant IronXL, utilisez la méthode FindNamedRange. Cette méthode vous donne la référence absolue de la plage nommée, telle que Sheet1!$A$1:$A$5.

Quelle méthode dois-je utiliser pour supprimer une plage nommée en C# ?

Pour supprimer une plage nommée en C#, utilisez la méthode RemoveNamedRange de IronXL. Passez le nom de la plage nommée en paramètre à cette méthode pour la supprimer.

Comment les développeurs peuvent-ils bénéficier de l'utilisation d'IronXL pour gérer les plages nommées ?

Les développeurs bénéficient de l'utilisation d'IronXL pour gérer les plages nommées car cela simplifie les tâches telles que la création, la récupération et la suppression de plages nommées par programmation. Cela améliore la clarté et la maintenabilité des fichiers Excel, facilitant la gestion des références de cellules dans les applications C#.

Comment puis-je commencer à utiliser IronXL pour la manipulation d'Excel en C# ?

Pour commencer à utiliser IronXL pour la manipulation d'Excel en C#, téléchargez la bibliothèque IronXL depuis le gestionnaire de packages NuGet. Ensuite, utilisez les méthodes fournies telles que AddNamedRange, GetNamedRanges, et RemoveNamedRange pour gérer efficacement les plages nommées dans vos applications C#.

Chaknith Bin
Chaknith Bin
  Discutez maintenant avec l'équipe d'ingénierie
Ingénieur logiciel
Chaknith travaille sur IronXL et IronBarcode. Il a une expertise approfondie en C# et .NET, aidant à améliorer le logiciel et à soutenir les clients. Ses idées issues des interactions avec les utilisateurs contribuent à de meilleurs produits, documentation et expérience globale.
Prêt à commencer?
Nuget Téléchargements 1,686,155 | Version : 2025.11 vient de sortir