Cómo convertir tipos de archivos de hoja de cálculo en C# con IronXL

Updated: 4 de junio de 2026

IronXL permite a los desarrolladores de C# convertir hojas de cálculo entre múltiples formatos que incluyen XLS, XLSX, CSV, JSON, XML y HTML utilizando métodos simples de Load y SaveAs, optimizando las transformaciones de formatos de archivos en aplicaciones empresariales.

IronXL admite la conversión de archivos de hoja de cálculo entre varios formatos, incluidos XLS, XLSX, XLSM, XLTX, CSV, TSV, JSON, XML y HTML. También admite tipos de datos de código en línea como cadenas HTML, datos binarios, matrices de bytes, DataSets y MemoryStreams. El método Load se utiliza para abrir un archivo de hoja de cálculo, y el método SaveAs se utiliza para exportar la hoja de cálculo al tipo de archivo deseado.

Esta flexibilidad hace de IronXL una herramienta esencial para los desarrolladores .NET que trabajan con archivos Excel en C# en diferentes plataformas y aplicaciones. Ya se trate de herramientas de migración de datos, sistemas de generación de informes o aplicaciones de inteligencia empresarial, la capacidad de convertir sin problemas entre formatos garantiza la compatibilidad con diversos sistemas y requisitos de los usuarios.

Inicio rápido: Convertir una hoja de cálculo de Excel a JSON

Con una simple línea de código, IronXL te permite cargar un archivo Excel y exportarlo como JSON - sin configuraciones complejas, sólo resultados rápidos. Es un ejemplo perfecto para desarrolladores que necesiten una conversión rápida de archivos.

1Install IronXL with NuGet Package Manager
PM > Install-Package IronXL.Excel
```
Install-Package IronXL.Excel
```

2Copie y ejecute este fragmento de código.

IronXL.WorkBook.Load("input.xlsx").SaveAsJson("output.json");

IronXL.WorkBook.Load("input.xlsx").SaveAsJson("output.json");

3Despliegue para probar en su entorno real

Comienza a usar IronXL en tu proyecto hoy mismo con una prueba gratuita

Flujo de trabajo mínimo (5 pasos)

Flujo de trabajo de la biblioteca IronXL de C# que muestra 5 pasos para convertir archivos de Excel a los formatos XLSX, XLS, XLSM, XLTX, CSV

Instalar la biblioteca C# para convertir archivos de Excel a otros formatos de archivo
Utilice la clase WorkBook para cargar o crear nuevos archivos XLS o XLSX
Ver, agregar o modificar datos en la hoja de cálculo de Excel usando C#
Utilice los métodos de la clase WorkBook para exportar la hoja de cálculo
Verifique el archivo exportado en el directorio especificado

¿Cómo convierto tipos de archivos de hoja de cálculo?

El proceso de conversión de tipos de hojas de cálculo implica cargar un archivo en un formato compatible y exportarlo a otro formato utilizando las funciones inteligentes de reestructuración de datos de IronXL. Este proceso de conversión preserva la integridad de los datos al tiempo que se adapta a los requisitos estructurales de cada formato de destino.

Mientras que el método SaveAs se puede utilizar para exportar a CSV, JSON, XML y HTML, se recomienda usar los métodos dedicados para cada formato de archivo:

SaveAsCsv - Optimizado para valores separados por comas con escape adecuado
SaveAsJson - Crea JSON correctamente formateado con preservación de tipo de datos
SaveAsXml - Genera XML bien formado con esquema apropiado
ExportToHtml - Produce tablas HTML estilizadas conservando el formato

Por favor nota: Para los formatos de archivo CSV, TSV, JSON y XML, se creará un archivo separado para cada hoja de trabajo. La convención de nomenclatura sigue el formato fileName.sheetName.format. En el ejemplo a continuación, la salida para el formato CSV sería sample.new_sheet.csv.

using IronXL;

// Load the Excel spreadsheet
WorkBook workbook = WorkBook.Load("sample.xlsx");

// Convert and save as CSV
workbook.SaveAsCsv("sample.csv");

// Convert and save as JSON
workbook.SaveAsJson("sample.json");

// Convert and save as XML
workbook.SaveAsXml("sample.xml");

// Convert and export to HTML
workbook.ExportToHtml("sample.html");

// The files will be saved in the project's directory with the specified formats

using IronXL;

// Load the Excel spreadsheet
WorkBook workbook = WorkBook.Load("sample.xlsx");

// Convert and save as CSV
workbook.SaveAsCsv("sample.csv");

// Convert and save as JSON
workbook.SaveAsJson("sample.json");

// Convert and save as XML
workbook.SaveAsXml("sample.xml");

// Convert and export to HTML
workbook.ExportToHtml("sample.html");

// The files will be saved in the project's directory with the specified formats

Imports IronXL

' Load the Excel spreadsheet
Dim workbook As WorkBook = WorkBook.Load("sample.xlsx")

' Convert and save as CSV
workbook.SaveAsCsv("sample.csv")

' Convert and save as JSON
workbook.SaveAsJson("sample.json")

' Convert and save as XML
workbook.SaveAsXml("sample.xml")

' Convert and export to HTML
workbook.ExportToHtml("sample.html")

' The files will be saved in the project's directory with the specified formats

Imports IronXL

' Load the Excel spreadsheet
Dim workbook As WorkBook = WorkBook.Load("sample.xlsx")

' Convert and save as CSV
workbook.SaveAsCsv("sample.csv")

' Convert and save as JSON
workbook.SaveAsJson("sample.json")

' Convert and save as XML
workbook.SaveAsXml("sample.xml")

' Convert and export to HTML
workbook.ExportToHtml("sample.html")

' The files will be saved in the project's directory with the specified formats

Cada método de exportación está optimizado para su formato de destino. Por ejemplo, convertir XLSX a CSV maneja correctamente los caracteres especiales y los delimitadores, mientras que la exportación JSON mantiene los tipos de datos y las estructuras jerárquicas.

¿Cuándo debo utilizar cada formato?

Entender cuándo utilizar cada formato de archivo es crucial para las aplicaciones empresariales:

CSV/TSV: Mejor para datos tabulares simples, importaciones de bases de datos, o cuando necesita la máxima compatibilidad con otras aplicaciones
JSON: Ideal para servicios web, APIs REST y aplicaciones modernas de JavaScript
XML: Adecuado para el intercambio de datos estructurados, archivos de configuración e integración con sistemas heredados
HTML: Perfecto para mostrar datos en sitios web o generar informes para su distribución por correo electrónico

¿Qué opciones avanzadas de conversión hay disponibles?

En la sección anterior, exploramos los formatos de archivo más comunes para la conversión. Sin embargo, IronXL tiene la capacidad de convertir hojas de cálculo a muchos más formatos. Explora todas las opciones disponibles para cargar y exportar hojas de cálculo, incluyendo escenarios avanzados como exportar a DataSet y DataTable para operaciones con bases de datos.

¿Qué formatos de archivo puedo cargar?

XLS, XLSX, XLSM y XLTX
CSV (Valores Separados por Comas)
TSV (valores separados por tabulaciones)

¿A qué formatos puedo exportar?

XLS, XLSX y XLSM
CSV y TSV
JSON
XML
HTML
Tipos de datos de código en línea:
- Cadena HTML
- Binario y matrices de bytes
- DataSet: Exportar Excel a los objetos System.Data.DataSet y System.Data.DataTable permite una fácil interoperabilidad o integración con DataGrids, SQL y EF.
- MemoryStream

Los tipos de datos de código en línea se pueden enviar como una respuesta API RESTful o utilizar con IronPDF para convertirlos en un documento PDF. Esta flexibilidad resulta especialmente útil a la hora de crear hojas de cálculo de forma dinámica en aplicaciones web.

using IronXL;

// Load the Excel spreadsheet
WorkBook workbook = WorkBook.Load("advanced_sample.xlsx");

// Convert and save to various formats
workbook.SaveAs("advanced_sample.xlsm");
workbook.SaveAsCsv("advanced_sample.csv");
workbook.SaveAsJson("advanced_sample.json");
workbook.SaveAsXml("advanced_sample.xml");
workbook.ExportToHtml("advanced_sample.html");

// You can also convert to binary or byte array for advanced uses
byte[] excelAsByteArray = workbook.ToBinary();

using IronXL;

// Load the Excel spreadsheet
WorkBook workbook = WorkBook.Load("advanced_sample.xlsx");

// Convert and save to various formats
workbook.SaveAs("advanced_sample.xlsm");
workbook.SaveAsCsv("advanced_sample.csv");
workbook.SaveAsJson("advanced_sample.json");
workbook.SaveAsXml("advanced_sample.xml");
workbook.ExportToHtml("advanced_sample.html");

// You can also convert to binary or byte array for advanced uses
byte[] excelAsByteArray = workbook.ToBinary();

Imports IronXL

' Load the Excel spreadsheet
Dim workbook As WorkBook = WorkBook.Load("advanced_sample.xlsx")

' Convert and save to various formats
workbook.SaveAs("advanced_sample.xlsm")
workbook.SaveAsCsv("advanced_sample.csv")
workbook.SaveAsJson("advanced_sample.json")
workbook.SaveAsXml("advanced_sample.xml")
workbook.ExportToHtml("advanced_sample.html")

' You can also convert to binary or byte array for advanced uses
Dim excelAsByteArray As Byte() = workbook.ToBinary()

Imports IronXL

' Load the Excel spreadsheet
Dim workbook As WorkBook = WorkBook.Load("advanced_sample.xlsx")

' Convert and save to various formats
workbook.SaveAs("advanced_sample.xlsm")
workbook.SaveAsCsv("advanced_sample.csv")
workbook.SaveAsJson("advanced_sample.json")
workbook.SaveAsXml("advanced_sample.xml")
workbook.ExportToHtml("advanced_sample.html")

' You can also convert to binary or byte array for advanced uses
Dim excelAsByteArray As Byte() = workbook.ToBinary()

El código anterior carga un archivo XLSX ordinario, luego lo convierte y exporta a varios formatos. Para ver ejemplos completos de conversiones de archivos, visite nuestra página de ejemplos de conversiones.

¿Qué aspecto tiene el resultado convertido?

Hoja de cálculo Excel de base de datos de empleados con datos salariales, demográficos y de ubicación en varias columnas

Archivo XLSX

Los diversos archivos exportados se muestran a continuación.

Archivo TSV con datos de empleados que muestra ID, nombre, cargo, departamento, salario y columnas demográficas en editor de texto

Exportación de archivos TSV

Archivo CSV con datos de empleados que muestra las columnas ID, nombre, cargo, departamento, salario y ubicación en el editor de código

Exportación de archivos CSV

Editor VS Code que muestra un archivo JSON de datos de empleados con campos de encabezado y registros de muestra que incluyen ID, nombre, cargo

Exportación de archivos JSON

Archivo XML que muestra la estructura de datos de los empleados con columnas para ID, nombre, cargo, departamento y otros campos de RR.HH

Exportación de archivos XML

Hoja de cálculo de la base de datos de empleados con datos de personal, incluidos ID, nombres, cargos, departamentos, datos demográficos y remuneración

Exportación de archivos HTML

Prácticas recomendadas para la conversión de archivos

Cuando convierta archivos de hojas de cálculo, tenga en cuenta estas prácticas recomendadas para garantizar unos resultados óptimos:

Preservar la integridad de los datos: Verifique siempre que los datos, las fórmulas y el formato críticos se mantengan tras la conversión. Algunos formatos, como CSV, no admiten hojas múltiples ni formatos.
Maneja archivos grandes de forma eficiente: En el caso de las hojas de cálculo de gran tamaño, considere la posibilidad de utilizar métodos de streaming o procesar los datos en trozos para gestionar el uso de la memoria de forma eficaz.
Manejo de errores: Implementar un manejo de errores adecuado para detectar fallos en la conversión:

try 
{
    WorkBook workbook = WorkBook.Load("input.xlsx");
    
    // Check if the file has data before converting
    if (workbook.WorkSheets.Count > 0 && workbook.DefaultWorkSheet.RowCount > 0)
    {
        workbook.SaveAsCsv("output.csv");
        Console.WriteLine("Conversion successful!");
    }
    else
    {
        Console.WriteLine("No data found in the spreadsheet.");
    }
}
catch (Exception ex)
{
    Console.WriteLine($"Conversion failed: {ex.Message}");
}

try 
{
    WorkBook workbook = WorkBook.Load("input.xlsx");
    
    // Check if the file has data before converting
    if (workbook.WorkSheets.Count > 0 && workbook.DefaultWorkSheet.RowCount > 0)
    {
        workbook.SaveAsCsv("output.csv");
        Console.WriteLine("Conversion successful!");
    }
    else
    {
        Console.WriteLine("No data found in the spreadsheet.");
    }
}
catch (Exception ex)
{
    Console.WriteLine($"Conversion failed: {ex.Message}");
}

Imports System

Try
    Dim workbook As WorkBook = WorkBook.Load("input.xlsx")

    ' Check if the file has data before converting
    If workbook.WorkSheets.Count > 0 AndAlso workbook.DefaultWorkSheet.RowCount > 0 Then
        workbook.SaveAsCsv("output.csv")
        Console.WriteLine("Conversion successful!")
    Else
        Console.WriteLine("No data found in the spreadsheet.")
    End If
Catch ex As Exception
    Console.WriteLine($"Conversion failed: {ex.Message}")
End Try

Imports System

Try
    Dim workbook As WorkBook = WorkBook.Load("input.xlsx")

    ' Check if the file has data before converting
    If workbook.WorkSheets.Count > 0 AndAlso workbook.DefaultWorkSheet.RowCount > 0 Then
        workbook.SaveAsCsv("output.csv")
        Console.WriteLine("Conversion successful!")
    Else
        Console.WriteLine("No data found in the spreadsheet.")
    End If
Catch ex As Exception
    Console.WriteLine($"Conversion failed: {ex.Message}")
End Try

Elija el formato adecuado: Seleccione el formato de salida en función de sus necesidades específicas:
- Utilice XLSX para la funcionalidad completa de Excel
- Elija CSV para un intercambio de datos simple
- Seleccione JSON para aplicaciones web y APIs
- Elija XML para datos estructurados con esquemas
- Exporte a HTML para su visualización en web
Codificación de caracteres: Presta atención a la codificación de caracteres, especialmente cuando se trate de datos internacionales. IronXL maneja la codificación UTF-8 por defecto, asegurando una representación adecuada de caracteres en diferentes sistemas.

Para obtener una guía más detallada sobre cómo trabajar con archivos de Excel en aplicaciones .NET, explore la completa documentación de IronXL.

Preguntas Frecuentes

¿Cómo convierto archivos Excel a formato CSV en C#?

Con IronXL, puede convertir archivos de Excel a CSV utilizando el método SaveAsCsv. Simplemente cargue su archivo Excel con WorkBook.Load() y luego llame a SaveAsCsv() para exportarlo. IronXL maneja el escape y el formato apropiados automáticamente, creando un archivo CSV separado para cada hoja de cálculo en su archivo de Excel.

¿Puedo convertir varias hojas de cálculo de Excel a JSON simultáneamente?

Sí, IronXL convierte automáticamente todas las hojas de trabajo al exportar a formato JSON. Cuando utiliza el método SaveAsJson, IronXL crea archivos JSON separados para cada hoja de trabajo siguiendo la convención de nomenclatura fileName.sheetName.json, preservando los tipos de datos y la estructura de cada hoja.

¿Qué formatos de archivo de hoja de cálculo se admiten para la conversión?

IronXL admite la conversión entre varios formatos, incluidos XLS, XLSX, XLSM, XLTX, CSV, TSV, JSON, XML y HTML. Además, admite tipos de datos de código en línea, como cadenas HTML, datos binarios, matrices de bytes, DataSets y MemoryStreams, para ofrecer la máxima flexibilidad en sus aplicaciones C#.

¿Cómo puedo conservar el formato de Excel al convertirlo a HTML?

Al convertir Excel a HTML, utilice el método ExportToHtml de IronXL en lugar del genérico SaveAs. Este método dedicado produce tablas HTML con estilo que conservan el formato de su archivo de Excel original, asegurando que la presentación de sus datos permanezca consistente en todos los formatos.

¿Es posible convertir archivos de Excel sin tener instalado Microsoft Office?

Sí, IronXL funciona de forma independiente sin necesidad de Microsoft Office o Excel Interop. Proporciona una solución autónoma para convertir archivos Excel en C#, por lo que es ideal para entornos de servidor y aplicaciones en las que la instalación de Office no es factible.

¿Cuál es la forma más sencilla de convertir un archivo Excel a otro formato?

El enfoque más sencillo con IronXL es utilizar una línea de código: IronXL.WorkBook.Load("input.xlsx").SaveAsJson("output.json"). Esto carga su archivo de Excel e inmediatamente lo exporta al formato deseado - reemplace SaveAsJson con SaveAsCsv, SaveAsXml, o ExportToHtml según sea necesario.

What are the best practices for converting files using IronXL?

Best practices for file conversion with IronXL include preserving data integrity, using appropriate error handling, choosing the suitable output format for your needs, and paying attention to character encoding.

When should I use JSON as the export format with IronXL?

JSON is an ideal export format when working with web services, REST APIs, and modern JavaScript applications due to its lightweight structure and ease of use in data interchange and integration.

Is it possible to convert Excel data into formats suitable for database operations with IronXL?

Yes, IronXL can export Excel data to formats suitable for database operations, such as `DataSet` and `DataTable`, allowing easy integration with SQL databases or other data processing systems.

What are the customization options available for converting spreadsheets using IronXL?

IronXL offers various customization options for converting spreadsheets, including specific export methods like SaveAsCsv or SaveAsJson for different formats, and the ability to convert Excel data into binary or byte arrays for advanced uses.

Curtis Chau

Chatea con el equipo de ingeniería ahora

Escritor Técnico

Curtis Chau tiene una licenciatura en Ciencias de la Computación (Carleton University) y se especializa en el desarrollo front-end con experiencia en Node.js, TypeScript, JavaScript y React. Apasionado por crear interfaces de usuario intuitivas y estéticamente agradables, disfruta trabajando con frameworks modernos y creando manuales bien estructurados y visualmente atractivos.

...