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.

How to Rename Excel WorkSheet in 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");
           }
       }
   }

   C#

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.

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

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 Package Manager de Visual Studio comme suit.

Ou peut être installée à partir du Package Manager NuGet avec une commande.

dotnet add package IronXL.Excel --version 2024.4.4

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:

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
                workBook.SaveAs(Path.Combine(outputPath, $"FinancialReport2024_{index}.xlsx"))
                index += 1
            Next
        End Sub
    End Class
End Namespace

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
                workBook.SaveAs(Path.Combine(outputPath, $"FinancialReport2024_{index}.xlsx"))
                index += 1
            Next
        End Sub
    End Class
End Namespace

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.

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 de gagner 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"
}

{
  "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.