Comment renommer une feuille de calcul Excel en C#

Introduction

Renommer des fichiers Excel par programme est une tâche courante dans diverses applications. Qu'il s'agisse d'organiser des fichiers, d'automatiser des tâches ou de gérer des données, la possibilité de renommer des fichiers Excel à l'aide d'un code peut s'avérer très utile. 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 les feuilles Excel.

2. Installez la bibliothèque IronXL depuis Iron Software.

3. Renommez les feuilles Excel à l'aide de IronXL.

Bibliothèque IronXL de Iron Software

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

Principales caractéristiques d'IronXL

1. Lire, Modifier et Créer des Fichiers Excel : IronXL vous permet de lire, générer et 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 gérer les complexités de l'interopérabilité Office. IronXL offre une expérience sans tracas.

3. Support Multi-Plateforme : IronXL est conçu pour .NET 8, 7, 6, Core, Framework et Azure. Que vous construisiez des applications de 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, le travail avec des 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 to excel workbook object
            WorkBook workBook = WorkBook.Load("sample.xlsx"); // sample excel file
            // Select specified worksheet
            WorkSheet workSheet = workBook.WorkSheets [0];
            // Read a cell value from same workbook
            int cellValue = workSheet ["A2"].IntValue;
            // Iterate through a range of cells
            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);
            workBook.SaveAs("sampleResult.xlsx"); // save as new workbook
        }
    }

using IronXL;
    namespace RenameExcelSheets;
    public class Program
    {
        public static void Main()
        {
            Console.WriteLine("Rename Excel Sheets Using IronXL");
            // Load an existing Excel file to excel workbook object
            WorkBook workBook = WorkBook.Load("sample.xlsx"); // sample excel file
            // Select specified worksheet
            WorkSheet workSheet = workBook.WorkSheets [0];
            // Read a cell value from same workbook
            int cellValue = workSheet ["A2"].IntValue;
            // Iterate through a range of cells
            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);
            workBook.SaveAs("sampleResult.xlsx"); // save as new workbook
        }
    }

IRON VB CONVERTER ERROR developers@ironsoftware.com

5. Fonctionnalité Excel sans tracas : IronXL vous permet de créer, charger, enregistrer et manipuler des feuilles de calcul sans effort. Qu'il s'agisse de métadonnées, d'autorisations, de formules ou de style, IronXL simplifie le processus.

   N'oubliez pas que des millions d'ingénieurs du monde entier font confiance à IronXL pour sa précision, 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 !

Mise en place de l'environnement

Avant de vous lancer dans le codage, assurez-vous d'avoir installé les outils nécessaires :

1. Visual Studio : Installez Visual Studio ou tout autre IDE C# de votre choix.

2. Microsoft Excel : Assurez-vous que Microsoft Excel est installé sur votre système.

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

Étape 1 : Créer un projet Visual Studio pour renommer les feuilles Excel.

Ouvrez Visual Studio et créez un nouveau projet pour la démo. Sélectionnez l'application Console dans le modèle ci-dessous.

Indiquez les noms du projet et le chemin d'accès pour stocker les fichiers.

Sélectionnez la version .NET requise.

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

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

Il peut également être installé à partir du gestionnaire de paquets NuGet avec la commande.

dotnet add package IronXL.Excel --version 2024.4.4

dotnet add package IronXL.Excel --version 2024.4.4

'INSTANT VB TODO TASK: The following line uses invalid syntax:
'dotnet add package IronXL.Excel --version 2024.4.4

Une fois installé, le projet est prêt à être codé pour renommer les feuilles de calcul Excel.

Étape 3 : Renommer les feuilles Excel en utilisant IronXL

Voici le programme permettant de renommer tous les fichiers et feuilles de calcul d'un répertoire pour les applications professionnelles.

Entrée :

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");
        var folderPath = Console.ReadLine();
        if (string.IsNullOrEmpty(folderPath)) // check for empty string
        {
            throw new AggregateException("Path is empty");
        }
        if (Directory.Exists(folderPath) == false)
        {
            throw new AggregateException("Path is Wrong");
        }
        var files = Directory.GetFiles(folderPath);
        var outputPath = Path.Combine(folderPath, "output");
        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
            workBook.SaveAs(Path.Join(outputPath, $"FinancialReport2024_{index++}.xlsx"));
        }
    }
}

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");
        var folderPath = Console.ReadLine();
        if (string.IsNullOrEmpty(folderPath)) // check for empty string
        {
            throw new AggregateException("Path is empty");
        }
        if (Directory.Exists(folderPath) == false)
        {
            throw new AggregateException("Path is Wrong");
        }
        var files = Directory.GetFiles(folderPath);
        var outputPath = Path.Combine(folderPath, "output");
        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
            workBook.SaveAs(Path.Join(outputPath, $"FinancialReport2024_{index++}.xlsx"));
        }
    }
}

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")
			Dim folderPath = Console.ReadLine()
			If String.IsNullOrEmpty(folderPath) Then ' check for empty string
				Throw New AggregateException("Path is empty")
			End If
			If Directory.Exists(folderPath) = False Then
				Throw New AggregateException("Path is Wrong")
			End If
			Dim files = Directory.GetFiles(folderPath)
			Dim outputPath = Path.Combine(folderPath, "output")
			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
'INSTANT VB WARNING: An assignment within expression was extracted from the following statement:
'ORIGINAL LINE: workBook.SaveAs(Path.Join(outputPath, string.Format("FinancialReport2024_{0}.xlsx", index++)));
				workBook.SaveAs(Path.Join(outputPath, $"FinancialReport2024_{index}.xlsx"))
				index += 1
			Next file
		End Sub
	End Class
End Namespace

Explication du code

1. Prendre le chemin du dossier pour renommer tous les fichiers et leurs feuilles de calcul

2. Vérifier si le chemin du dossier est une chaîne vide

3. Vérifier si le chemin d'accès au dossier est valide

4. Récupérer tous les fichiers du dossier avec l'extension xlsx

5. Itérer à travers les fichiers et charger l'objet WorkBook d'IronXL pour renommer la propriété du nom de la feuille de travail.

6. Enregistrer le fichier dans le dossier Output

   Sortie

   Dans la sortie ci-dessous, vous pouvez voir que les 3 fichiers ont été renommés et que la feuille Excel qu'ils contiennent a également été renommée en Rapport financier2024.

   

Les avantages du renommage programmatique des feuilles Excel sont les suivants

• Efficacité : L'automatisation réduit les efforts manuels et les erreurs humaines associées au renommage manuel, économisant ainsi du temps et des ressources.
• Consistance : Le renommage automatisé garantit l'uniformité et le respect des conventions de dénomination sur toutes les feuilles, améliorant ainsi l'organisation et la lisibilité des données.
• Extensibilité : Le renommage programmatique des feuilles permet un renommage en masse et une extensibilité, 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 avec les 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é de personnaliser la logique de renommage en fonction de critères ou de besoins d'affaires 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"
}

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

If True Then
  "IronXL.License.LicenseKey" : "IRONXL-MYLICENSE-KEY-1EF01"
End If

Conclusion

Renommer des fichiers Excel à l'aide de 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, qu'il s'agisse de lecture, d'écriture ou de gestion.

Maintenant que vous avez appris à renommer des fichiers Excel par programmation, vous pouvez intégrer cette fonctionnalité dans vos projets C# afin de rationaliser les tâches de gestion de fichiers et d'améliorer les capacités d'automatisation.