USO DE IRONXL

Cómo Renombrar una Hoja de Excel en C#

Actualizado 29 de abril, 2024
Compartir:

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 utilizando IronXL biblioteca 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 IronXL biblioteca de Iron Software.
  3. Renombrar hojas Excel utilizando IronXL.

Biblioteca IronXL de Iron Software

IronXL es una potente biblioteca de C# Excel 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 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.
    1. 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");
            //  Cargar un archivo Excel existente en el objeto Excel Workbook
            WorkBook workBook = WorkBook.Load("sample.xlsx"); //  ejemplo de archivo excel
            //  Seleccionar la hoja de cálculo especificada
            WorkSheet workSheet = workBook.WorkSheets [0];
            //  Leer el valor de una celda del mismo libro
            int cellValue = workSheet ["A2"].IntValue;
            //  Iterar a través de un rango de celdas
            foreach (var cell in workSheet ["A2:A10"])
            {
                Console.WriteLine($"Cell {cell.AddressString} has value     '{cell.Text}'");
            }
            //  Calcular valores agregados
            decimal sum = workSheet ["A2:A10"].Sum();
            decimal max = workSheet ["A2:A10"].Max(c => c.DecimalValue);
            workBook.SaveAs("sampleResult.xlsx"); //  guardar como nuevo libro
        }
    }
using IronXL;
    namespace RenameExcelSheets;
    public class Program
    {
        public static void Main()
        {
            Console.WriteLine("Rename Excel Sheets Using IronXL");
            //  Cargar un archivo Excel existente en el objeto Excel Workbook
            WorkBook workBook = WorkBook.Load("sample.xlsx"); //  ejemplo de archivo excel
            //  Seleccionar la hoja de cálculo especificada
            WorkSheet workSheet = workBook.WorkSheets [0];
            //  Leer el valor de una celda del mismo libro
            int cellValue = workSheet ["A2"].IntValue;
            //  Iterar a través de un rango de celdas
            foreach (var cell in workSheet ["A2:A10"])
            {
                Console.WriteLine($"Cell {cell.AddressString} has value     '{cell.Text}'");
            }
            //  Calcular valores agregados
            decimal sum = workSheet ["A2:A10"].Sum();
            decimal max = workSheet ["A2:A10"].Max(c => c.DecimalValue);
            workBook.SaveAs("sampleResult.xlsx"); //  guardar como nuevo libro
        }
    }
Imports IronXL
	Namespace RenameExcelSheets
		Public Class Program
			Public Shared Sub Main()
				Console.WriteLine("Rename Excel Sheets Using IronXL")
				'  Cargar un archivo Excel existente en el objeto Excel Workbook
				Dim workBook As WorkBook = WorkBook.Load("sample.xlsx") '  ejemplo de archivo excel
				'  Seleccionar la hoja de cálculo especificada
				Dim workSheet As WorkSheet = workBook.WorkSheets (0)
				'  Leer el valor de una celda del mismo libro
				Dim cellValue As Integer = workSheet ("A2").IntValue
				'  Iterar a través de un rango de celdas
				For Each cell In workSheet ("A2:A10")
					Console.WriteLine($"Cell {cell.AddressString} has value     '{cell.Text}'")
				Next cell
				'  Calcular valores agregados
				Dim sum As Decimal = workSheet ("A2:A10").Sum()
				Dim max As Decimal = workSheet ("A2:A10").Max(Function(c) c.DecimalValue)
				workBook.SaveAs("sampleResult.xlsx") '  guardar como nuevo libro
			End Sub
		End Class
	End Namespace
VB   C#
  1. 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.

Cómo Renombrar una Hoja de Excel en C#: Figura 1 - Creación de una aplicación de consola

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

Cómo Renombrar una Hoja de Excel en C#: Figura 2 - Nombre del proyecto

Seleccione la versión .NET necesaria.

Cómo Renombrar una Hoja de Excel en C#: Figura 3 - Seleccione la versión .NET requerida

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.

Cómo Renombrar una Hoja de Trabajo de Excel en C#: Figura 4 - Buscando IronXL usando el Gestor de Paquetes NuGet

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
VB   C#

Cómo Renombrar una Hoja de Trabajo de Excel en C#: Figura 5 - Página principal de IronXL

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:

Cómo Renombrar una Hoja de Excel en C#: Figura 6 - Ejemplo de entrada de hoja de cálculo Excel para renombrar

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)) //  comprobar si la cadena está vacía
        {
            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)
        {
            //  Cargar un archivo Excel existente
            WorkBook workBook = WorkBook.Load(file);
            //  Seleccione la primera hoja de cálculo (índice 0)
            WorkSheet workSheet = workBook.WorkSheets [0];
            //  Cambiar el nombre de la hoja de cálculo
            workSheet.Name = "FinancialReport2024"; //  cambiar la propiedad name
            //  Guardar el libro modificado
            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)) //  comprobar si la cadena está vacía
        {
            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)
        {
            //  Cargar un archivo Excel existente
            WorkBook workBook = WorkBook.Load(file);
            //  Seleccione la primera hoja de cálculo (índice 0)
            WorkSheet workSheet = workBook.WorkSheets [0];
            //  Cambiar el nombre de la hoja de cálculo
            workSheet.Name = "FinancialReport2024"; //  cambiar la propiedad name
            //  Guardar el libro modificado
            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 '  comprobar si la cadena está vacía
				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
				'  Cargar un archivo Excel existente
				Dim workBook As WorkBook = WorkBook.Load(file)
				'  Seleccione la primera hoja de cálculo (índice 0)
				Dim workSheet As WorkSheet = workBook.WorkSheets (0)
				'  Cambiar el nombre de la hoja de cálculo
				workSheet.Name = "FinancialReport2024" '  cambiar la propiedad name
				'  Guardar el libro modificado
'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
VB   C#

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.

    Cómo Renombrar una Hoja de Trabajo de Excel en C#: Figura 7 - Ejemplo de salida mostrando todas las hojas de trabajo de Excel renombradas usando IronXL

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 licencia 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
VB   C#

Conclusión

Renombrar archivos Excel utilizando C# es un proceso sencillo. Aprovechando la IronXL biblioteca de Iron Software puede 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.

< ANTERIOR
Cómo utilizar el estilo de fuente de Excel en C#
SIGUIENTE >
Cómo leer un archivo Excel en una aplicación de consola C#

¿Listo para empezar? Versión: 2024.6 recién publicada

Comenzar prueba gratuita Descargas totales: 856,014
Ver licencias >