Renomear arquivos Excel programaticamente é uma tarefa comum em várias aplicações. Seja organizando arquivos, automatizando tarefas ou gerenciando dados, ter a capacidade de renomear arquivos Excel por meio de código pode ser altamente benéfico. Neste artigo, exploraremos como renomear arquivos Excel usando a biblioteca IronXL da Iron Software.

How to Rename Excel WorkSheet in C#

1. Crie um Projeto no Visual Studio para renomear planilhas Excel.
2. Instale a biblioteca IronXL da Iron Software.
3. Renomeie planilhas Excel usando o IronXL.

Biblioteca IronXL da Iron Software

IronXL é uma poderosa biblioteca de Excel em C# desenvolvida pela Iron Software. Ela permite que você trabalhe com documentos Excel em seus projetos .NET sem a necessidade de Microsoft Office ou Excel Interop.

Principais características do IronXL

1. Leia, Edite e Crie Arquivos Excel: O IronXL permite que você leia, gere e edite arquivos de planilhas Excel (incluindo formatos XLSX, XLS, XLSM, XLTX, CSV e TSV) diretamente do seu código C# ou VB.NET.

2. Nenhum Interop de Office Necessário: Você não precisará instalar o Microsoft Office ou lidar com as complexidades do Interop do Office. IronXL oferece uma experiência sem complicações.

3. Suporte Multiplataforma: IronXL é projetado para .NET 8, 7, 6, Core, Framework e Azure. Se você está desenvolvendo aplicativos de console, aplicativos web ou software de desktop, IronXL tem você coberto.

4. API amigável: A API intuitiva permite que você execute tarefas como leitura de valores de células, cálculo de valores agregados, trabalho com fórmulas, criação de gráficos e mais. Vamos examinar brevemente um exemplo:

   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. Funcionalidade em Excel sem complicações: IronXL permite que você crie, carregue, salve e manipule planilhas com facilidade. Se você está lidando com metadados, permissões, fórmulas ou formatação, IronXL simplifica o processo.

Lembre-se, IronXL é confiável por milhões de engenheiros em todo o mundo por sua precisão, facilidade de uso e velocidade. Se você está trabalhando com arquivos Excel em C# ou VB.NET, IronXL é sua biblioteca preferida!

Configurando o Ambiente

Antes de mergulhar na parte de codificação, certifique-se de ter as ferramentas necessárias instaladas:

1. Visual Studio: Instale o Visual Studio ou qualquer outro IDE C# preferido.
2. Microsoft Excel: Certifique-se de que o Microsoft Excel está instalado em seu sistema.

Para demonstrar um exemplo do mundo real de renomear um arquivo Excel, vamos escrever um programa para pegar uma pasta contendo todos os arquivos a serem renomeados e usar IronXL para renomear todos os arquivos, depois armazená-los na pasta de saída.

Passo 1: Criar projeto no Visual Studio para renomear planilhas do Excel.

Abra o Visual Studio e crie um novo projeto para a demonstração. Selecione Aplicativo de Console no modelo abaixo.

Forneça nomes para o Projeto e o caminho para armazenar os arquivos.

Selecione a versão do .NET desejada.

Passo 2: Instale a biblioteca IronXL da Iron Software.

A biblioteca IronXL pode ser instalada a partir do Gerenciador de Pacotes do Visual Studio conforme abaixo.

Ou pode ser instalada do Gerenciador de Pacotes NuGet com comando.

dotnet add package IronXL.Excel --version 2024.4.4

Uma vez instalado, o projeto está pronto para começar a codificar para renomear planilhas Excel.

Passo 3: Renomear planilhas Excel usando IronXL

Abaixo está o programa para renomear todos os arquivos e planilhas em um diretório para aplicativos de negócios.

Entrada:

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

Explicação do código

1. O programa solicita que o usuário insira um caminho de pasta onde os arquivos Excel estão localizados.
2. Ele verifica se o caminho da pasta está vazio e se a pasta realmente existe.
3. Ele recupera todos os arquivos da pasta especificada.
4. Ele itera por esses arquivos, carregando cada um em um objeto Workbook da biblioteca IronXL.
5. Para cada workbook, renomeia a primeira planilha.
6. Ele salva cada workbook modificado em uma pasta "output" dentro da pasta original.

Saída

Na saída abaixo, você pode ver que todos os 3 arquivos foram renomeados e a planilha Excel dentro deles também foi renomeada para FinancialReport2024.

Vantagens de renomear planilhas Excel programaticamente incluem

• Eficiência: A automação reduz o esforço manual e os erros humanos associados com a renomeação manual, economizando tempo e recursos.
• Consistência: A renomeação automatizada garante uniformidade e aderência às convenções de nomenclatura entre as planilhas, melhorando a organização e legibilidade dos dados.
• Escalabilidade: Renomear planilhas programaticamente permite a renomeação em massa e escalabilidade, tornando-o adequado para lidar com grandes conjuntos de dados ou tarefas repetitivas.
• Integração: A integração com fluxos de trabalho ou aplicativos existentes permite processamento de dados contínuo e melhora a produtividade geral.
• Customização: A automação fornece flexibilidade para personalizar a lógica de renomeação com base em requisitos ou critérios de negócios específicos.

Licenciamento

IronXL é uma biblioteca de nível empresarial que funciona com um contrato de licença. Mais sobre a licença pode ser encontrado aqui. A chave de licença precisa ser colocada no arquivo appsettings.json aqui.

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

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

Conclusão

Renomear arquivos Excel usando C# é um processo direto. Utilizando a biblioteca IronXL da Iron Software, você pode facilmente renomear arquivos Excel dentro de suas aplicações C#. Esta biblioteca é uma ferramenta útil para desenvolvedores para todas as operações em planilhas Excel, seja leitura, escrita ou gerenciamento.

Agora que você aprendeu como renomear arquivos Excel programaticamente, você pode incorporar essa funcionalidade em seus projetos C# para otimizar as tarefas de gerenciamento de arquivos e melhorar as capacidades de automação.