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 verrons comment renommer des fichiers Excel à l'aide de la fonction IronXL bibliothèque 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. Installer IronXL bibliothèque de Iron Software.
3. Renommer des feuilles Excel à l'aide de IronXL.

bibliothèque IronXL de Iron Software

IronXL est une puissante bibliothèque Excel en C# 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, éditer et créer des fichiers Excel : IronXL vous permet de lire, de générer et d'éditer 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. Pas 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 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, l'utilisation de formules, la création de graphiques, etc. 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. La fonctionnalité Excel sans les 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 en VB.NET, IronXL est la bibliothèque qu'il vous faut!

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 : Installer 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 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 à partir de Iron Software.

IronXL peut être installée à partir du gestionnaire de paquets de Visual Studio, comme indiqué ci-dessous.

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 à l'aide de 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, ce qui permet de gagner du temps et d'économiser des ressources.
• Cohérence : Le renommage automatisé garantit l'uniformité et le respect des conventions de dénomination entre les feuilles, ce qui améliore l'organisation et la lisibilité des données.
• Évolutivité : Le renommage programmé des feuilles permet un renommage en masse et une évolutivité, ce qui le rend adapté à la gestion de grands ensembles de données ou à des tâches répétitives.
• Intégration : L'intégration avec les flux de travail ou les applications existants permet un traitement transparent des données et améliore la productivité globale.
• Personnalisation : L'automatisation permet de personnaliser la logique de renommage en fonction d'exigences ou de critères spécifiques.

Licences

IronXL est une bibliothèque d'entreprise qui fonctionne avec un accord de licence. Pour plus d'informations sur la licence, voir 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 s'appuyant sur la IronXL bibliothèque de Iron Softwarevous 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.