Cómo convertir archivos de hojas de cálculo a JSON, CSV, XML y más con IronXL en C#

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

This article was translated from English: Does it need improvement?
Translated
View the article in English

IronXL permite a los desarrolladores de C# convertir hojas de cálculo entre múltiples formatos, incluidos XLS, XLSX, CSV, JSON, XML y HTML, mediante sencillos métodos Load y SaveAs, agilizando las transformaciones de formatos de archivo en las 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.

como-encabezado:2(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.

Nuget IconEmpieza a crear PDF con NuGet ahora:

  1. Instalar IronXL con el gestor de paquetes NuGet

    PM > Install-Package IronXL.Excel

  2. Copie y ejecute este fragmento de código.

    IronXL.WorkBook.Load("input.xlsx").SaveAsJson("output.json");
  3. Despliegue para probar en su entorno real

    Empieza a utilizar IronXL en tu proyecto hoy mismo con una prueba gratuita
    arrow pointer


¿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 con el formato adecuado y preservando el tipo de datos
  • SaveAsXml - Genera XML bien formado con el esquema apropiado
  • ExportToHtml - Produce tablas HTML estilizadas con el formato conservado

Por favor notaPara los formatos de archivos CSV, TSV, JSON y XML, se creará un archivo separado para cada hoja de trabajo. El convenio de nomenclatura sigue el formato nombreArchivo.nombreHoja.formato. En el siguiente ejemplo, la salida para el formato CSV sería sample.new_sheet.csv .

:path=/static-assets/excel/content-code-examples/how-to/convert-spreadsheet-file-types-different-format.cs
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
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

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: lo mejor para datos tabulares sencillos, importaciones de bases de datos o cuando se necesita la máxima compatibilidad con otras aplicaciones
  • JSON: ideal para servicios web, API REST y aplicaciones JavaScript modernas
  • XML: adecuado para el intercambio de datos estructurados, archivos de configuración e integración de 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
    • Matriz binaria y de bytes
    • DataSet: La exportación de Excel a 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.

:path=/static-assets/excel/content-code-examples/how-to/convert-spreadsheet-file-types-different-format-advanced.cs
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();
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

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 de base de datos de empleados de Excel 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 mostrando ID, nombre, cargo, departamento, salario y columnas demográficas en editor de texto
Exportación de archivos TSV
Archivo CSV con datos de empleados en el que se muestran las columnas ID, nombre, cargo, departamento, salario y ubicación en el editor de código
Exportación de archivos CSV
Editor VS Code mostrando un archivo JSON de datos de empleados con campos de cabecera 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 RRHH
Exportación de archivos XML
Hoja de cálculo de base de datos de empleados que muestra datos de personal, incluidos ID, nombres, títulos, 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:

  1. 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.

  2. 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.

  3. 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}");
}
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel
  1. Elija el formato adecuado: Seleccione el formato de salida en función de sus necesidades específicas:

    • Utilice XLSX para obtener todas las funciones de Excel
    • Elija CSV para un intercambio de datos sencillo
    • Seleccione JSON para aplicaciones web y API
    • Elija XML para datos estructurados con esquemas
    • Exportación a HTML para su visualización en la web
  2. 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 de forma predeterminada, lo que garantiza una representación correcta de los 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.

Chaknith Bin
Ingeniero de Software
Chaknith trabaja en IronXL e IronBarcode. Tiene un profundo conocimiento en C# y .NET, ayudando a mejorar el software y apoyar a los clientes. Sus conocimientos derivados de las interacciones con los usuarios contribuyen a mejores productos, documentación y experiencia en general.
¿Listo para empezar?
Nuget Descargas 1,765,830 | Versión: 2025.12 recién lanzado