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, éditer et créer des fichiers Excel : IronXL vous permet de lire, générer et modifier des fichiers de feuilles de calcul Excel (y compris les formats XLSX, XLS, XLSM, XLTX, CSV et TSV) directement à partir de votre code C# ou VB.NET.
  2. Aucun besoin d'Office Interop : Vous n'aurez pas besoin d'installer Microsoft Office ou de gérer les complexités d'Office Interop. IronXL offre une expérience sans tracas.
  3. Support 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 de valeurs de cellules, le calcul de valeurs agrégées, le travail avec des formules, la création de graphiques, et 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");
            }
        }
    }
    Imports IronXL
    
    Namespace RenameExcelSheets
    	Public Class Program
    		Public Shared Sub Main()
    			Console.WriteLine("Rename Excel Sheets Using IronXL")
    
    			' Load an existing Excel file into a WorkBook object
    			Dim workBook As WorkBook = WorkBook.Load("sample.xlsx") ' sample excel file
    
    			' Select the specified worksheet (first sheet)
    			Dim workSheet As WorkSheet = workBook.WorkSheets(0)
    
    			' Read a cell value from the workbook
    			Dim cellValue As Integer = workSheet("A2").IntValue
    
    			' Iterate through a range of cells and print their values
    			For Each cell In workSheet("A2:A10")
    				Console.WriteLine($"Cell {cell.AddressString} has value '{cell.Text}'")
    			Next cell
    
    			' Calculate aggregate values
    			Dim sum As Decimal = workSheet("A2:A10").Sum()
    			Dim max As Decimal = workSheet("A2:A10").Max(Function(c) c.DecimalValue)
    
    			' Save as a new workbook
    			workBook.SaveAs("sampleResult.xlsx")
    		End Sub
    	End Class
    End Namespace
    $vbLabelText   $csharpLabel
  5. Fonctionnalité 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 IDE C# préféré.
  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.

Input:

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"));
            }
        }
    }
}
Imports System
Imports System.IO
Imports IronXL

Namespace RenameExcelSheets
	Public Class Program
		Public Shared Sub 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
			Dim folderPath = Console.ReadLine()

			' Check if the provided path is not empty
			If String.IsNullOrEmpty(folderPath) Then
				Throw New ArgumentException("Path is empty")
			End If

			' Check if the given folder path exists
			If Not Directory.Exists(folderPath) Then
				Throw New ArgumentException("Path is Wrong")
			End If

			' Get all files in the directory
			Dim files = Directory.GetFiles(folderPath)

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

			Dim index = 0
			For Each file In files
				' Load an existing Excel file
				Dim workBook As WorkBook = WorkBook.Load(file)

				' Select the first worksheet (index 0)
				Dim workSheet As 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
'INSTANT VB WARNING: An assignment within expression was extracted from the following statement:
'ORIGINAL LINE: workBook.SaveAs(Path.Combine(outputPath, string.Format("FinancialReport2024_{0}.xlsx", index++)));
				workBook.SaveAs(Path.Combine(outputPath, $"FinancialReport2024_{index}.xlsx"))
				index += 1
			Next file
		End Sub
	End Class
End Namespace
$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.

Output

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 l'effort manuel et les erreurs humaines associées au renommage manuel, économisant du temps et des ressources.
  • Cohérence : Un renommage automatisé garantit l'uniformité et l'adhésion aux conventions de nommage à travers les feuilles, améliorant l'organisation et la lisibilité des données.
  • Scalabilité : Renommer des feuilles par programmation permet un renommage en masse et une scalabilité, le rendant adapté à la gestion de grands jeux de données ou de tâches répétitives.
  • Intégration : L'intégration avec les flux de travail existants ou les applications permet un traitement de données transparent et améliore la productivité globale.
  • Personnalisation : L'automatisation offre la flexibilité de personnaliser la logique de renommage basée sur des besoins ou des critères métier spécifiques.

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