Como renomear uma planilha do Excel em C#

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 for .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");
           }
       }
   }

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

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.