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, vamos a explorar cómo cambiar el nombre de archivos de Excel utilizandoIronXL biblioteca deIron Software.

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

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

2. InstaleIronXL biblioteca deIron Software.

3. Renombrar hojas Excel utilizandoIronXL.

Biblioteca IronXL de Iron Software

IronXL es una potente biblioteca de C# Excel desarrollada porIron 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 de Excel: IronXL le permite leer, generar y editar archivos de hoja de cálculo Excel(incluidos los formatos XLSX, XLS, XLSM, XLTX, CSV y TSV) directamente desde su código C# o VB.NET.

2. No necesita Office Interop: No necesitará 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 intuitiva API le permite realizar tareas como leer valores de celdas, calcular valores agregados, trabajar con fórmulas, crear gráficos y mucho 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 Excel sin complicaciones: IronXL le 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 trabajas con archivos de Excel en C# o VB.NET, IronXL es tu librería ideal!

Configuración del entorno

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

1. Visual Studio: Instale 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 librería IronXL desde Iron Software.

IronXL puede instalarse desde el gestor de paquetes de Visual Studio como se indica 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 las 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

• Eficacia: La automatización reduce el esfuerzo manual y los errores humanos asociados al renombrado manual, ahorrando tiempo y recursos.
• Coherencia: El cambio de nombre automatizado garantiza la uniformidad y el cumplimiento de las convenciones de nomenclatura en todas las hojas, lo que mejora la organización y legibilidad de los datos.
• Escalabilidad: Cambiar el nombre de las hojas mediante programación permite cambiar el nombre de forma masiva y escalabilidad, por lo que es 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 fisuras y mejora la productividad general.
• Personalización: La automatización ofrece flexibilidad para personalizar la lógica de cambio de nombre en función de requisitos o criterios empresariales específicos.

Licencias

IronXL es una biblioteca empresarial que funciona con un acuerdo de licencia. Más información sobre la licenciaaquí. 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. Aprovechando laIronXL biblioteca deIron Softwarepuede renombrar fácilmente archivos Excel dentro de sus 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.