Cómo renombrar una hoja de trabajo de Excel en C#

Características principales de IronXL

1. Leer, editar y crear archivos de Excel: IronXL te permite leer, generar y editar archivos de hojas de cálculo de Excel (incluyendo los formatos XLSX, XLS, XLSM, XLTX, CSV y TSV) directamente desde tu código en C# o VB.NET.
2. No se requiere Interop de Office: No necesitarás instalar Microsoft Office ni lidiar con las complejidades de Office Interop. IronXL proporciona una experiencia sin complicaciones.
3. Compatibilidad multiplataforma: IronXL está diseñado para .NET 8, 7, 6, Core, Framework y Azure. Ya sea que estés construyendo aplicaciones de consola, aplicaciones web, o software de escritorio, IronXL cubre tus necesidades.

4. API amigable: La API intuitiva te permite realizar tareas como leer valores de celdas, calcular valores agregados, trabajar con fórmulas, crear gráficos, y más. Examinemos brevemente un ejemplo:

   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. Funcionalidad de Excel sin complicaciones: IronXL te permite crear, cargar, guardar y manipular hojas de cálculo fácilmente. Ya sea que estés tratando con metadatos, permisos, fórmulas o estilos, IronXL simplifica el proceso.

Recuerda, IronXL es confiado por millones de ingenieros en todo el mundo por su precisión, facilidad de uso y velocidad. Si estás trabajando con archivos de Excel en C# o VB.NET, ¡IronXL es tu biblioteca de referencia!

Configuración del entorno

Antes de sumergirte en la parte del código, asegúrate de tener instaladas las herramientas necesarias:

1. Visual Studio: Instala Visual Studio o cualquier otro IDE de C# que prefieras.
2. Microsoft Excel: Asegúrate de que Microsoft Excel esté instalado en tu sistema.

Para demostrar un ejemplo del mundo real de renombrar un archivo de Excel, escribamos un programa para tomar una carpeta que contenga todos los archivos a renombrar y usar IronXL para renombrar todos los archivos, luego almacenarlos en la carpeta de salida.

Explicación del código

1. El programa pide al usuario que ingrese una ruta de carpeta donde están ubicados los archivos de Excel.
2. Verifica si la ruta de la carpeta es una cadena vacía y si la carpeta realmente existe.
3. Recupera todos los archivos de la carpeta especificada.
4. Itera a través de estos archivos, cargando cada uno en un objeto WorkBook de la biblioteca IronXL.
5. Para cada libro, renombra la primera hoja de trabajo.
6. Guarda cada libro modificado en una carpeta "output" dentro de la carpeta original.

Output

En la siguiente salida, puedes ver que los 3 archivos son renombrados y la hoja de Excel dentro de ellos también es renombrada a FinancialReport2024.