Passer au contenu du pied de page
UTILISATION D'IRONXL

Comment renommer une feuille Excel en C#

Renommer des fichiers Excel par programmation est une tâche courante dans diverses applications. Que vous organisiez des fichiers, automatisiez des tâches ou gériez des données, avoir la capacité de renommer des fichiers Excel par code peut être très bénéfique. Dans cet article, nous allons explorer comment renommer des fichiers Excel en utilisant la bibliothèque IronXL de Iron Software.

Comment renommer une feuille de calcul Excel en C#

  1. Créez un projet Visual Studio pour renommer des feuilles Excel.
  2. Installez la bibliothèque IronXL de Iron Software.
  3. Renommez des feuilles Excel en utilisant IronXL.

Bibliothèque IronXL de Iron Software

IronXL est une puissante bibliothèque Excel C# développée par Iron Software. Elle vous permet de travailler avec des documents Excel dans vos projets .NET sans avoir besoin de Microsoft Office ou d'Excel Interop.

Caractéristiques principales d'IronXL

  1. Lire, modifier et créer des fichiers Excel : IronXL vous permet de lire, de générer et de modifier des fichiers de tableur Excel (y compris les formats XLSX, XLS, XLSM, XLTX, CSV et TSV) directement depuis votre code C# ou VB.NET.
  2. Aucune interopérabilité Office requise : vous n'aurez pas besoin d'installer Microsoft Office ni de vous soucier des complexités de l'interopérabilité Office. IronXL vous offre une expérience utilisateur simple et sans tracas.
  3. Prise en charge multiplateforme : IronXL est conçu pour .NET 8, 7, 6, Core, Framework et Azure. Que vous développiez des applications console, des applications web ou des logiciels de bureau, IronXL vous couvre.
  4. API conviviale : L'API intuitive vous permet d'effectuer des tâches telles que la lecture des valeurs des cellules, le calcul des valeurs agrégées, l'utilisation de formules, la création de graphiques, et bien plus encore. Examinons brièvement un exemple :

    using IronXL;
    
    namespace RenameExcelSheets
    {
        public class Program
        {
            public static void Main()
            {
                Console.WriteLine("Rename Excel Sheets Using IronXL");
    
                // Load an existing Excel file into a WorkBook object
                WorkBook workBook = WorkBook.Load("sample.xlsx"); // sample excel file
    
                // Select the specified worksheet (first sheet)
                WorkSheet workSheet = workBook.WorkSheets[0];
    
                // Read a cell value from the workbook
                int cellValue = workSheet["A2"].IntValue;
    
                // Iterate through a range of cells and print their values
                foreach (var cell in workSheet["A2:A10"])
                {
                    Console.WriteLine($"Cell {cell.AddressString} has value '{cell.Text}'");
                }
    
                // Calculate aggregate values
                decimal sum = workSheet["A2:A10"].Sum();
                decimal max = workSheet["A2:A10"].Max(c => c.DecimalValue);
    
                // Save as a new workbook
                workBook.SaveAs("sampleResult.xlsx");
            }
        }
    }
    using IronXL;
    
    namespace RenameExcelSheets
    {
        public class Program
        {
            public static void Main()
            {
                Console.WriteLine("Rename Excel Sheets Using IronXL");
    
                // Load an existing Excel file into a WorkBook object
                WorkBook workBook = WorkBook.Load("sample.xlsx"); // sample excel file
    
                // Select the specified worksheet (first sheet)
                WorkSheet workSheet = workBook.WorkSheets[0];
    
                // Read a cell value from the workbook
                int cellValue = workSheet["A2"].IntValue;
    
                // Iterate through a range of cells and print their values
                foreach (var cell in workSheet["A2:A10"])
                {
                    Console.WriteLine($"Cell {cell.AddressString} has value '{cell.Text}'");
                }
    
                // Calculate aggregate values
                decimal sum = workSheet["A2:A10"].Sum();
                decimal max = workSheet["A2:A10"].Max(c => c.DecimalValue);
    
                // Save as a new workbook
                workBook.SaveAs("sampleResult.xlsx");
            }
        }
    }
    $vbLabelText   $csharpLabel
  5. Fonctionnalités Excel sans tracas : IronXL vous permet de créer, charger, enregistrer et manipuler des feuilles de calcul sans effort. Que vous gériez des métadonnées, des permissions, des formules ou le style, IronXL simplifie le processus.

Rappelez-vous, IronXL est utilisé par des millions d'ingénieurs dans le monde pour son exactitude, sa facilité d'utilisation et sa rapidité. Si vous travaillez avec des fichiers Excel en C# ou VB.NET, IronXL est votre bibliothèque de référence !

Configuration de l'environnement

Avant de plonger dans la partie codage, assurez-vous d'avoir les outils nécessaires installés :

  1. Visual Studio : Installez Visual Studio ou tout autre EDI C# de votre choix.
  2. Microsoft Excel : Assurez-vous que Microsoft Excel est installé sur votre système.

Pour démontrer un exemple concret de renommage d'un fichier Excel, écrivons un programme pour prendre un dossier contenant tous les fichiers à renommer et utiliser IronXL pour renommer tous les fichiers, puis les stocker dans le dossier de sortie.

Étape 1 : Créez un projet Visual Studio pour renommer des feuilles Excel.

Ouvrez Visual Studio et créez un nouveau projet pour la démonstration. Sélectionnez l'application console à partir du modèle ci-dessous.

Comment renommer une feuille de calcul Excel en C# : Figure 1 - Créer une application console

Attribuez des noms au projet et au chemin où stocker les fichiers.

Comment renommer une feuille de calcul Excel en C# : Figure 2 - Nommer le projet

Sélectionnez la version .NET requise.

Comment renommer une feuille de calcul Excel en C# : Figure 3 - Sélectionnez la version .NET requise

Étape 2 : Installez la bibliothèque IronXL de Iron Software.

La bibliothèque IronXL peut être installée depuis le gestionnaire de paquets de Visual Studio comme suit.

Comment renommer une feuille de calcul Excel en C# : Figure 4 - Recherche de IronXL avec le gestionnaire de paquets NuGet

Ou peut être installée à partir du gestionnaire de paquets NuGet avec une commande.

dotnet add package IronXL.Excel --version 2024.4.4

Comment renommer une feuille de calcul Excel en C# : Figure 5 - Page d'accueil de IronXL

Une fois installée, le projet est prêt à démarrer le codage pour renommer des feuilles de calcul Excel.

Étape 3 : Renommez des feuilles Excel en utilisant IronXL

Ci-dessous se trouve le programme pour renommer tous les fichiers et feuilles de calcul dans un répertoire pour des applications commerciales.

Saisir:

Comment renommer une feuille de calcul Excel en C# : Figure 6 - Exemple d'entrée de feuille de calcul Excel pour le renommage

using System;
using System.IO;
using IronXL;

namespace RenameExcelSheets
{
    public class Program
    {
        public static void Main()
        {
            Console.WriteLine("Demo Rename Excel Sheets Using IronXL");
            Console.WriteLine("Enter Folder where Excel Files are present to rename to FinancialReport2024");

            // Getting input folder path from user
            var folderPath = Console.ReadLine();

            // Check if the provided path is not empty
            if (string.IsNullOrEmpty(folderPath))
            {
                throw new ArgumentException("Path is empty");
            }

            // Check if the given folder path exists
            if (!Directory.Exists(folderPath))
            {
                throw new ArgumentException("Path is Wrong");
            }

            // Get all files in the directory
            var files = Directory.GetFiles(folderPath);

            // Define output directory for renamed files
            var outputPath = Path.Combine(folderPath, "output");
            Directory.CreateDirectory(outputPath); // Ensures the output directory exists

            var index = 0;
            foreach (var file in files)
            {
                // Load an existing Excel file
                WorkBook workBook = WorkBook.Load(file);

                // Select the first worksheet (index 0)
                WorkSheet workSheet = workBook.WorkSheets[0];

                // Rename the worksheet
                workSheet.Name = "FinancialReport2024"; // change the name property

                // Save the modified workbook with a new name in the output folder
                workBook.SaveAs(Path.Combine(outputPath, $"FinancialReport2024_{index++}.xlsx"));
            }
        }
    }
}
using System;
using System.IO;
using IronXL;

namespace RenameExcelSheets
{
    public class Program
    {
        public static void Main()
        {
            Console.WriteLine("Demo Rename Excel Sheets Using IronXL");
            Console.WriteLine("Enter Folder where Excel Files are present to rename to FinancialReport2024");

            // Getting input folder path from user
            var folderPath = Console.ReadLine();

            // Check if the provided path is not empty
            if (string.IsNullOrEmpty(folderPath))
            {
                throw new ArgumentException("Path is empty");
            }

            // Check if the given folder path exists
            if (!Directory.Exists(folderPath))
            {
                throw new ArgumentException("Path is Wrong");
            }

            // Get all files in the directory
            var files = Directory.GetFiles(folderPath);

            // Define output directory for renamed files
            var outputPath = Path.Combine(folderPath, "output");
            Directory.CreateDirectory(outputPath); // Ensures the output directory exists

            var index = 0;
            foreach (var file in files)
            {
                // Load an existing Excel file
                WorkBook workBook = WorkBook.Load(file);

                // Select the first worksheet (index 0)
                WorkSheet workSheet = workBook.WorkSheets[0];

                // Rename the worksheet
                workSheet.Name = "FinancialReport2024"; // change the name property

                // Save the modified workbook with a new name in the output folder
                workBook.SaveAs(Path.Combine(outputPath, $"FinancialReport2024_{index++}.xlsx"));
            }
        }
    }
}
$vbLabelText   $csharpLabel

Explication du code

  1. Le programme invite l'utilisateur à entrer un chemin de dossier où se trouvent les fichiers Excel.
  2. Il vérifie si le chemin du dossier est une chaîne vide et si le dossier existe réellement.
  3. Il récupère tous les fichiers du dossier spécifié.
  4. Il parcourt ces fichiers, chargeant chacun dans un objet WorkBook de la bibliothèque IronXL.
  5. Pour chaque classeur, il renomme la première feuille de calcul.
  6. Il enregistre chaque classeur modifié dans un dossier de "sortie" à l'intérieur du dossier d'origine.

Sortie

Dans la sortie ci-dessous, vous pouvez voir que les 3 fichiers sont renommés et que la feuille Excel à l'intérieur d'eux est également renommée en FinancialReport2024.

Comment renommer une feuille de calcul Excel en C# : Figure 7 - Exemple de sortie montrant tous les classeurs Excel renommés à l'aide de IronXL

Les avantages de renommer des feuilles Excel par programmation incluent

  • Efficacité : L'automatisation réduit les efforts manuels et les erreurs humaines liées au renommage manuel, ce qui permet d'économiser du temps et des ressources.
  • Cohérence : Le renommage automatisé garantit l'uniformité et le respect des conventions d'appellation entre les feuilles, améliorant ainsi l'organisation et la lisibilité des données.
  • Évolutivité : Le renommage programmatique des feuilles permet un renommage en masse et une grande évolutivité, ce qui le rend adapté à la gestion de grands ensembles de données ou de tâches répétitives.
  • Intégration : L'intégration aux flux de travail ou applications existants permet un traitement des données fluide et améliore la productivité globale.
  • Personnalisation : L'automatisation offre la flexibilité nécessaire pour personnaliser la logique de renommage en fonction des exigences ou des critères spécifiques de l'entreprise.

Licences

IronXL est une bibliothèque d'entreprise qui fonctionne avec un accord de licence. Plus d'informations sur la licence peuvent être trouvées ici. La clé de licence doit être placée dans le fichier appsettings.json ici.

{
  "IronXL.License.LicenseKey" : "IRONXL-MYLICENSE-KEY-1EF01"
}

Conclusion

Renommer des fichiers Excel avec C# est un processus simple. En tirant parti de la bibliothèque IronXL de Iron Software, vous pouvez facilement renommer des fichiers Excel dans vos applications C#. Cette bibliothèque est un outil pratique pour les développeurs pour toutes les opérations sur les feuilles Excel, que ce soit la lecture, l'écriture ou la gestion.

Maintenant que vous savez comment renommer des fichiers Excel par programmation, vous pouvez incorporer cette fonctionnalité dans vos projets C# pour rationaliser les tâches de gestion de fichiers et améliorer les capacités d'automatisation.

Questions Fréquemment Posées

Comment puis-je renommer une feuille de calcul Excel en C# sans utiliser Interop ?

Vous pouvez renommer une feuille de calcul Excel en C# sans utiliser Interop en utilisant la bibliothèque IronXL. Chargez votre fichier Excel dans un objet WorkBook, sélectionnez la feuille de calcul que vous souhaitez renommer, et définissez son nouveau nom via la propriété Name.

Quels sont les avantages d'utiliser IronXL pour la manipulation de fichiers Excel ?

IronXL offre des capacités puissantes pour la manipulation des fichiers Excel, telles que la lecture, l'édition et la création de fichiers Excel sans besoin de Microsoft Excel ou d'Interop. Il prend en charge divers formats comme XLSX et CSV, offre une API conviviale et permet l'automatisation et l'intégration dans les projets .NET.

Est-il possible d'automatiser les tâches Excel en C# ?

Oui, en utilisant la bibliothèque IronXL, vous pouvez automatiser diverses tâches Excel en C#, telles que renommer des feuilles de calcul, lire des valeurs de cellule, calculer des agrégats et plus encore, le tout sans besoin de Microsoft Excel.

Quelles sont les étapes pour configurer IronXL pour un projet C# ?

Pour configurer IronXL dans un projet C#, créez d'abord un projet Visual Studio, puis installez la bibliothèque IronXL en utilisant le gestionnaire de packages NuGet avec la commande : dotnet add package IronXL.Excel --version 2024.4.4. Vous pouvez ensuite commencer à utiliser ses fonctionnalités pour manipuler des fichiers Excel.

IronXL peut-il gérer plusieurs formats Excel ?

Oui, IronXL prend en charge plusieurs formats Excel, dont XLSX, XLS, XLSM, XLTX, CSV et TSV, ce qui permet des capacités de manipulation de fichiers diversifiées dans les applications .NET.

Ai-je besoin d'une licence pour utiliser IronXL dans mon projet ?

Oui, une licence est requise pour utiliser IronXL dans votre projet. Une fois que vous avez une clé de licence, elle doit être placée dans le fichier appsettings.json de votre projet pour activer la pleine fonctionnalité.

Comment puis-je résoudre les problèmes courants lors de l'utilisation d'IronXL ?

Les problèmes courants lors de l'utilisation d'IronXL peuvent souvent être résolus en vérifiant que la bibliothèque est correctement installée et configurée, en vérifiant les mises à jour, et en consultant la documentation officielle pour obtenir des conseils sur les fonctionnalités spécifiques.

Quels avantages offre le renommage programmatique des feuilles de calcul Excel ?

Le renommage programmatique des feuilles de calcul Excel améliore l'efficacité et la scalabilité, offre de la cohérence, s'intègre parfaitement aux flux de travail existants, et permet la personnalisation en fonction des besoins spécifiques de l'entreprise.

Jordi Bardia
Ingénieur logiciel
Jordi est le plus compétent en Python, C# et C++, et lorsqu'il ne met pas à profit ses compétences chez Iron Software, il programme des jeux. Partageant les responsabilités des tests de produit, du développement de produit et de la recherche, Jordi apporte une immense valeur à l'amé...
Lire la suite