Cómo Renombrar una Hoja de Excel en C#

Introducción

Renombrar archivos Excel mediante programación es una tarea común en varias aplicaciones. Tanto si está organizando archivos, automatizando tareas o gestionando datos, tener la capacidad de renombrar archivos de Excel mediante código puede ser muy beneficioso. En este artículo, exploraremos cómo renombrar archivos de Excel utilizando la biblioteca IronXL de Iron Software.

Cómo cambiar el nombre de Excel WorkSheet en C#

1. Cree un proyecto de Visual Studio para renombrar hojas Excel.

2. Instale la biblioteca IronXL de Iron Software.

3. Renombrar hojas de Excel usando IronXL.

Biblioteca IronXL de Iron Software

IronXL es una poderosa biblioteca de Excel para C# desarrollada por Iron Software. Le permite trabajar con documentos Excel en sus proyectos .NET sin necesidad de Microsoft Office o Excel Interop.

Características principales de IronXL

1. Leer, Editar y Crear Archivos Excel: IronXL te permite leer, generar y editar archivos de hojas de cálculo Excel (incluyendo formatos XLSX, XLS, XLSM, XLTX, CSV y TSV) directamente desde tu código 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. Soporte multiplataforma: IronXL está diseñado para .NET 8, 7, 6, Core, Framework y Azure. Tanto si está creando aplicaciones de consola, aplicaciones web o software de escritorio, IronXL le cubre todas sus necesidades.

   4. API fácil de usar: La API intuitiva le 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 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. Funcionalidad de Excel Sin Complicaciones: IronXL te permite crear, cargar, guardar y manipular hojas de cálculo sin esfuerzo. Ya se trate de metadatos, permisos, fórmulas o estilos, IronXL simplifica el proceso.

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

Configuración del entorno

Antes de sumergirte en la parte de codificación, asegúrate de tener instaladas las herramientas necesarias:

1. Visual Studio: Instala Visual Studio o cualquier otro IDE de C# preferido.

2. Microsoft Excel: Asegúrese de que Microsoft Excel esté instalado en su sistema.

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

Paso 1: Crear Proyecto Visual Studio para renombrar hojas Excel.

Abre Visual Studio y crea un nuevo proyecto para la demo. Seleccione la aplicación Consola de la siguiente plantilla.

Indique el nombre del proyecto y la ruta para almacenar los archivos.

Seleccione la versión .NET necesaria.

Paso 2: Instale la biblioteca IronXL de Iron Software.

La biblioteca IronXL se puede instalar desde el administrador de paquetes de Visual Studio como se muestra a continuación.

O se puede instalar desde NuGet Package Manager con el comando.

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

Una vez instalado, el proyecto está listo para empezar a codificar el cambio de nombre de las hojas de cálculo de Excel.

Paso 3: Renombrar hojas de Excel usando IronXL

A continuación se muestra el programa para renombrar todos los archivos y hojas de cálculo de un directorio para aplicaciones empresariales.

Entrada:

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

Código Explicación

1. Tome la ruta de la carpeta para renombrar todos los archivos y sus hojas de trabajo

2. Comprobar si la ruta de la carpeta es una cadena vacía

3. Comprobar si la ruta de la carpeta es válida

4. Obtener todos los archivos de la carpeta con extensión xlsx

5. Itere a través de los archivos y cargue el objeto WorkBook desde IronXL para renombrar la propiedad del nombre de la hoja de trabajo.

6. Guardar el archivo en la carpeta de salida

   Salida

   En el siguiente resultado, puede ver que los 3 archivos han sido renombrados y que la hoja Excel que contienen también ha sido renombrada a FinancialReport2024.

   

Las ventajas de cambiar el nombre de las hojas de Excel mediante programación son las siguientes

• Eficiencia: La automatización reduce el esfuerzo manual y los errores humanos asociados con el renombrado manual, ahorrando tiempo y recursos.
• Consistencia: El renombrado automatizado garantiza la uniformidad y el cumplimiento de las convenciones de nomenclatura en todas las hojas, mejorando la organización y legibilidad de los datos.
• Escalabilidad: Renombrar hojas mediante programación permite el renombrado en masa y la escalabilidad, haciéndolo adecuado para manejar grandes conjuntos de datos o tareas repetitivas.
• Integración: La integración con flujos de trabajo o aplicaciones existentes permite un procesamiento de datos sin problemas y mejora la productividad general.
• Personalización: La automatización ofrece flexibilidad para personalizar la lógica de renombrado en función de requisitos o criterios comerciales específicos.

Licencias

IronXL es una biblioteca empresarial que funciona con un acuerdo de licencia. Más información sobre la licencia se puede encontrar aquí. La clave de licencia debe colocarse aquí en el archivo appsettings.json.

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

Conclusión

Renombrar archivos Excel utilizando C# es un proceso sencillo. Al aprovechar la biblioteca IronXL de Iron Software, puedes renombrar fácilmente archivos Excel dentro de tus aplicaciones C#. Esta biblioteca es una herramienta muy útil para los desarrolladores para todas las operaciones con hojas de Excel, ya sean de lectura, escritura o gestión.

Ahora que ha aprendido a renombrar archivos de Excel mediante programación, puede incorporar esta función a sus proyectos de C# para agilizar las tareas de gestión de archivos y mejorar las capacidades de automatización.