Los archivos CSV facilitan el intercambio de datos entre innumerables aplicaciones .NET, y las opciones de la biblioteca estándar a menudo se quedan cortas cuando hay que gestionar la complejidad del mundo real. Desde informes financieros hasta sistemas de inventario, puedes crear archivos CSV mediante programación con solo unas pocas líneas de código. Aunque bibliotecas como CsvHelper cubren operaciones básicas de CSV, los desarrolladores modernos enfrentan escenarios complejos: convertir libros de Excel con fórmulas, preservar los tipos de datos durante la exportación y manejar flujos de trabajo de hojas de cálculo de nivel empresarial. IronXL aborda estos retos combinando la escritura fiable de CSV con la funcionalidad completa de Excel en una única biblioteca IronXL sin dependencias que cumple con los estándares RFC 4180.
Esto la hace ideal para desarrolladores que crean un generador de CSV .NET personalizado o un analizador de CSV .NET que admita múltiples columnas, lógica de procesamiento específica por fila y separadores inferidos automáticamente. Este tutorial le guía a través de las capacidades CSV de IronXL, desde la creación básica de archivos hasta la exportación de datos a escala Enterprise.
En el entorno fiscal y regulatorio español, la escritura de CSV adquiere una dimensión adicional de cumplimiento. Las empresas sujetas al SII (Suministro Inmediato de Información) de la AEAT necesitan generar ficheros de datos estructurados que alimenten sus pipelines de remisión de facturas. Del mismo modo, la generación de ficheros CSV para TicketBAI — sistema obligatorio en los territorios forales de Bizkaia, Gipuzkoa y Araba — requiere exportaciones precisas con los campos establecidos por cada administración foral. IronXL permite generar estas exportaciones CSV directamente desde libros de trabajo .NET, garantizando la integridad tipológica de los datos fiscales.
La instalación de IronXL se realiza en cuestión de segundos a través del gestor de paquetes NuGet. Puede utilizar la Consola del Administrador de paquetes o la CLI de .NET :
Una vez instalado, añade el espacio de nombres IronXL y empieza a escribir archivos CSV de inmediato. El siguiente ejemplo muestra cómo crear un libro de trabajo, rellenarlo con datos y exportarlo a CSV utilizando sentencias de nivel superior en .NET 10:
using IronXL;
// Create a new workbook and worksheet
WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.CreateWorkSheet("data");
// Add headers
workSheet["A1"].Value = "Product";
workSheet["B1"].Value = "Quantity";
workSheet["C1"].Value = "Price";
// Add data rows
workSheet["A2"].Value = "Widget";
workSheet["B2"].Value = 100;
workSheet["C2"].Value = 19.99;
workSheet["A3"].Value = "Gadget";
workSheet["B3"].Value = 250;
workSheet["C3"].Value = 34.50;
workSheet["A4"].Value = "Component";
workSheet["B4"].Value = 75;
workSheet["C4"].Value = 8.99;
// Save as CSV with comma delimiter
workBook.SaveAsCsv("inventory.csv", ",");Imports IronXL
' Create a new workbook and worksheet
Dim workBook As WorkBook = WorkBook.Create()
Dim workSheet As WorkSheet = workBook.CreateWorkSheet("data")
' Add headers
workSheet("A1").Value = "Product"
workSheet("B1").Value = "Quantity"
workSheet("C1").Value = "Price"
' Add data rows
workSheet("A2").Value = "Widget"
workSheet("B2").Value = 100
workSheet("C2").Value = 19.99
workSheet("A3").Value = "Gadget"
workSheet("B3").Value = 250
workSheet("C3").Value = 34.5
workSheet("A4").Value = "Component"
workSheet("B4").Value = 75
workSheet("C4").Value = 8.99
' Save as CSV with comma delimiter
workBook.SaveAsCsv("inventory.csv", ",")Este sencillo programa muestra cómo escribir contenido CSV directamente desde tu código C#, creando un objeto WorkBook que almacena tus datos. El método SaveAsCsv utiliza una coma como separador predeterminado, pero permite especificar cualquier carácter delimitador, lo cual resulta útil en contextos específicos de cada región en los que los separadores de columna estándar son el punto y coma o las tabulaciones.
IronXL organiza los datos mediante una jerarquía de libros a hojas de cálculo. Un WorkBook actúa como contenedor de uno o más objetos WorkSheet, cada uno de los cuales representa una cuadrícula de celdas. Cuando exporta a CSV, IronXL crea un archivo por hoja de trabajo, nombrándolos con el patrón filename.SheetName.csv.
Este modelo le ofrece una API coherente tanto si crea archivos nuevos desde cero, como si carga libros de Excel existentes o exporta datos desde una base de datos. Para hacer referencia a las celdas se utiliza la notación estándar de Excel (A1, B2) o números enteros de fila y columna basados en cero, lo que mejor se adapte a su flujo de trabajo.
Las diferentes regiones y sistemas esperan distintos separadores de columnas. En las configuraciones regionales europeas se suelen utilizar puntos y comas, ya que las comas aparecen en los números decimales. Los valores separados por tabulaciones (TSV) son habituales en bioinformática y en los procesos de procesamiento de registros. El método SaveAsCsv de IronXL acepta cualquier cadena como delimitador:
using IronXL;
WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.CreateWorkSheet("sales");
workSheet["A1"].Value = "Region";
workSheet["B1"].Value = "Revenue";
workSheet["C1"].Value = "Units";
workSheet["A2"].Value = "Europe";
workSheet["B2"].Value = "1250000.50";
workSheet["C2"].Value = 3400;
workSheet["A3"].Value = "North America";
workSheet["B3"].Value = "2800000.00";
workSheet["C3"].Value = 7200;
// Semicolon delimiter for European locales
workBook.SaveAsCsv("sales_europe.csv", ";");
// Tab delimiter for TSV output
workBook.SaveAsCsv("sales_tsv.tsv", "\t");Imports IronXL
Dim workBook As WorkBook = WorkBook.Create()
Dim workSheet As WorkSheet = workBook.CreateWorkSheet("sales")
workSheet("A1").Value = "Region"
workSheet("B1").Value = "Revenue"
workSheet("C1").Value = "Units"
workSheet("A2").Value = "Europe"
workSheet("B2").Value = "1250000.50"
workSheet("C2").Value = 3400
workSheet("A3").Value = "North America"
workSheet("B3").Value = "2800000.00"
workSheet("C3").Value = 7200
' Semicolon delimiter for European locales
workBook.SaveAsCsv("sales_europe.csv", ";")
' Tab delimiter for TSV output
workBook.SaveAsCsv("sales_tsv.tsv", vbTab)La cadena delimitadora se introduce directamente en el campo del carácter separador sin necesidad de ninguna configuración de análisis adicional. IronXL gestiona las comillas de las celdas que contienen el carácter delimitador, garantizando que el resultado se ajuste a la norma RFC 4180.
IronXL destaca por convertir archivos Excel existentes a CSV, evaluar fórmulas y preservar la integridad de los datos. Esto es esencial cuando se trabaja con hojas de cálculo que contienen tanto filas de encabezado como valores calculados dinámicamente.
using IronXL;
// Load an Excel file with formulas and formatting
WorkBook workBook = WorkBook.Load("financial_report.xlsx");
// Evaluate all formulas before export so calculated values appear in CSV
workBook.EvaluateAll();
// Export to CSV -- each worksheet creates a separate CSV file
// Creates: report.Sheet1.csv, report.Sheet2.csv, etc.
workBook.SaveAsCsv("report.csv", ",");Imports IronXL
' Load an Excel file with formulas and formatting
Dim workBook As WorkBook = WorkBook.Load("financial_report.xlsx")
' Evaluate all formulas before export so calculated values appear in CSV
workBook.EvaluateAll()
' Export to CSV -- each worksheet creates a separate CSV file
' Creates: report.Sheet1.csv, report.Sheet2.csv, etc.
workBook.SaveAsCsv("report.csv", ",")Al convertir libros de múltiples hojas, IronXL genera automáticamente archivos CSV individuales para cada hoja de cálculo. Los cálculos de fórmulas se ejecutan antes de la exportación, asegurando datos precisos en la salida final del CSV. El método EvaluateAll resuelve todas las fórmulas, incluidas las referencias entre hojas, antes de que el archivo se guarde en el disco.
En primer lugar, aquí puede ver los archivos CSV generados a partir del archivo de Excel de varias hojas:
Y este es un ejemplo de comparación de una de las hojas de Excel versus el archivo CSV correspondiente:
El sistema TicketBAI es obligatorio en Bizkaia, Gipuzkoa y Araba (Álava), con cronogramas de implantación progresiva coordinados por la SEVeM (Sociedad para la Transformación Competitiva) en el caso de Bizkaia. Los desarrolladores .NET que integran TicketBAI en sus aplicaciones de facturación pueden usar IronXL para generar los ficheros CSV de transacciones antes de transformarlos al formato XML firmado requerido:
using IronXL;
WorkBook workBook = WorkBook.Create();
WorkSheet wsTicketBAI = workBook.CreateWorkSheet("transacciones");
// Campos requeridos por TicketBAI (simplificado)
wsTicketBAI["A1"].Value = "FechaExpedicion";
wsTicketBAI["B1"].Value = "NumFactura";
wsTicketBAI["C1"].Value = "BaseImponible";
wsTicketBAI["D1"].Value = "TipoIVA";
wsTicketBAI["E1"].Value = "CuotaIVA";
wsTicketBAI["F1"].Value = "ImporteTotal";
// Ejemplo de registro de transacción
wsTicketBAI["A2"].Value = "29-05-2026";
wsTicketBAI["B2"].Value = "FAC-2026-001";
wsTicketBAI["C2"].Value = 1000.00;
wsTicketBAI["D2"].Value = 21;
wsTicketBAI["E2"].Value = 210.00;
wsTicketBAI["F2"].Value = 1210.00;
// Exportar con punto y coma para compatibilidad con sistemas forales
workBook.SaveAsCsv("ticketbai_transacciones.csv", ";");Imports IronXL
Dim workBook As WorkBook = WorkBook.Create()
Dim wsTicketBAI As WorkSheet = workBook.CreateWorkSheet("transacciones")
' Campos requeridos por TicketBAI (simplificado)
wsTicketBAI("A1").Value = "FechaExpedicion"
wsTicketBAI("B1").Value = "NumFactura"
wsTicketBAI("C1").Value = "BaseImponible"
wsTicketBAI("D1").Value = "TipoIVA"
wsTicketBAI("E1").Value = "CuotaIVA"
wsTicketBAI("F1").Value = "ImporteTotal"
' Ejemplo de registro de transacción
wsTicketBAI("A2").Value = "29-05-2026"
wsTicketBAI("B2").Value = "FAC-2026-001"
wsTicketBAI("C2").Value = 1000.0
wsTicketBAI("D2").Value = 21
wsTicketBAI("E2").Value = 210.0
wsTicketBAI("F2").Value = 1210.0
' Exportar con punto y coma para compatibilidad con sistemas forales
workBook.SaveAsCsv("ticketbai_transacciones.csv", ";")Este patrón puede adaptarse a los esquemas específicos de cada territorio foral (Bizkaia, Gipuzkoa, Araba), generando los ficheros intermedios que los sistemas de firma y remisión a las haciendas forales consumen.
Para aplicaciones basadas en bases de datos, IronXL facilita la exportación de DataTable. El siguiente ejemplo lee un DataTable de una fuente de datos simulada y lo escribe en CSV con un delimitador de punto y coma:
using System.Data;
using IronXL;
// Simulate a DataTable from a database query
DataTable dataTable = GetSalesData();
WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.CreateWorkSheet("sales");
// Write column headers from DataTable schema
for (int col = 0; col < dataTable.Columns.Count; col++)
{
workSheet.SetCellValue(0, col, dataTable.Columns[col].ColumnName);
}
// Write data rows
int row = 1;
foreach (DataRow dataRow in dataTable.Rows)
{
for (int col = 0; col < dataTable.Columns.Count; col++)
{
workSheet.SetCellValue(row, col, dataRow[col]?.ToString() ?? string.Empty);
}
row++;
}
// Export with semicolon delimiter for European compatibility
workBook.SaveAsCsv("sales_data.csv", ";");Imports System.Data
Imports IronXL
' Simulate a DataTable from a database query
Dim dataTable As DataTable = GetSalesData()
Dim workBook As WorkBook = WorkBook.Create()
Dim workSheet As WorkSheet = workBook.CreateWorkSheet("sales")
' Write column headers from DataTable schema
For col As Integer = 0 To dataTable.Columns.Count - 1
workSheet.SetCellValue(0, col, dataTable.Columns(col).ColumnName)
Next
' Write data rows
Dim row As Integer = 1
For Each dataRow As DataRow In dataTable.Rows
For col As Integer = 0 To dataTable.Columns.Count - 1
workSheet.SetCellValue(row, col, If(dataRow(col)?.ToString(), String.Empty))
Next
row += 1
Next
' Export with semicolon delimiter for European compatibility
workBook.SaveAsCsv("sales_data.csv", ";")Al importar desde un DataTable, cada fila de la colección dataTable.Rows se convierte en una nueva fila en la hoja de cálculo. IronXL conserva los tipos de datos durante la conversión: los números siguen siendo numéricos, las fechas mantienen su formato y el texto gestiona los caracteres especiales sin necesidad de configuración adicional.
Aquí puede ver la fuente de datos de prueba junto al archivo CSV de salida:
Considere este escenario de exportación de datos de empleados que muestra flujos de trabajo de escritura en CSV con ambas bibliotecas.
Implementación de CsvHelper:
using System.Globalization;
using System.IO;
using CsvHelper;
using var writer = new StreamWriter("employees.csv");
using var csv = new CsvWriter(writer, CultureInfo.InvariantCulture);
csv.WriteRecords(employees);Imports System.Globalization
Imports System.IO
Imports CsvHelper
Using writer As New StreamWriter("employees.csv")
Using csv As New CsvWriter(writer, CultureInfo.InvariantCulture)
csv.WriteRecords(employees)
End Using
End UsingImplementación de IronXL:
using IronXL;
WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.CreateWorkSheet("employees");
int rowIndex = 1;
foreach (var emp in employees)
{
workSheet[$"A{rowIndex}"].Value = emp.Name;
workSheet[$"B{rowIndex}"].Value = emp.Salary;
workSheet[$"C{rowIndex}"].Value = emp.StartDate;
rowIndex++;
}
workBook.SaveAsCsv("employees.csv", ",");Imports IronXL
Dim workBook As WorkBook = WorkBook.Create()
Dim workSheet As WorkSheet = workBook.CreateWorkSheet("employees")
Dim rowIndex As Integer = 1
For Each emp In employees
workSheet($"A{rowIndex}").Value = emp.Name
workSheet($"B{rowIndex}").Value = emp.Salary
workSheet($"C{rowIndex}").Value = emp.StartDate
rowIndex += 1
Next
workBook.SaveAsCsv("employees.csv", ",")| Función | CsvHelper | IronXL |
|---|---|---|
| Escritura básica de CSV | Sí | Sí |
| Conversión de Excel a CSV | No | Sí |
| Evaluación de fórmulas | No | Sí |
| Manejo de múltiples hojas | No | Sí |
| Preservación del tipo de datos | Manual | Automático |
| Compatibilidad con formatos de Excel (XLSX, XLS, XLSM) | No | Sí |
| No se requiere MS Office | Sí | Sí |
| Formato y estilos de celdas | No | Sí |
| Multipropósito (compatible con .NET 10) | Sí | Sí |
CsvHelper gestiona de forma eficiente la serialización sencilla de objetos POCO. IronXL ofrece capacidades adicionales cuando necesitas cargar archivos Excel existentes, evaluar fórmulas antes de la exportación o gestionar rangos de hojas de cálculo con un control muy preciso. Si su flujo de trabajo implica recibir archivos .xlsx de usuarios empresariales y convertirlos a CSV para sistemas posteriores, IronXL elimina todo un paso de conversión de su proceso.
El método SaveAsCsv de IronXL incluye varias funciones listas para la producción:
| Función | Descripción | Caso de uso |
|---|---|---|
| Delimitadores personalizados | Coma, punto y coma, tabulación o cualquier carácter | Compatibilidad con configuraciones regionales |
| Opciones de codificación | UTF-8, UTF-16 y codificaciones personalizadas | Conjuntos de caracteres internacionales |
| Evaluación de fórmulas | Calcula fórmulas de Excel antes de exportar | Informes financieros, datos dinámicos |
| Soporte multiplataforma | Windows, Linux, macOS | Implementaciones en la nube y en contenedores |
| Exportación de varias hojas | Un archivo CSV por hoja de cálculo | Estructuras complejas de libros de trabajo |
| Cumplimiento con RFC 4180 | Cotización automática de caracteres especiales | Interoperabilidad garantizada |
Puede aplicar el formato de datos de celda antes de exportar para controlar cómo aparecen los números, las divisas y las fechas en el archivo CSV resultante. En el caso de conjuntos de datos de gran tamaño, procese los datos por partes utilizando operaciones de rango de hoja de cálculo para mantener un uso predecible de la memoria.
La compatibilidad multiplataforma significa que puede implementar la generación de CSV con tecnología IronXL en contenedores Linux en Kubernetes o Azure App Service sin necesidad de realizar cambios en su código. La biblioteca no incluye dependencias no gestionadas, por lo que se ejecuta de forma idéntica en todos los sistemas operativos. Consulte la guía de compatibilidad de la plataforma IronXL para obtener todos los detalles sobre los entornos de ejecución compatibles.
Al trabajar con exportaciones CSV a gran escala, surgen varios problemas previsibles. A continuación se explica cómo abordar cada uno de ellos:
Caracteres especiales en los datos: IronXL escapa automáticamente las comillas, las comas y los saltos de línea dentro de los valores de las celdas. No es necesario preprocesar cadenas ni escribir lógica de escape personalizada: la biblioteca gestiona internamente las reglas de comillas de RFC 4180.
Manejo de archivos grandes: Para libros con decenas de miles de filas, utilice rangos de hojas de cálculo para procesar los datos por lotes. Escribir en hojas intermedias antes de la exportación final te permite controlar la asignación de memoria.
Problemas de codificación: Especifique explícitamente la codificación UTF-8 cuando se trate de caracteres internacionales, escrituras asiáticas o emojis en los valores de las celdas. IronXL admite la codificación UTF-8 y UTF-16 de forma nativa, por lo que no se requiere ninguna biblioteca de codificación de terceros.
Datos faltantes o mal escritos: IronXL conserva los formatos numéricos y de fecha de forma predeterminada. Cuando una celda contiene una fórmula que hace referencia a datos que faltan, EvaluateAll() se resolverá con un valor de error en lugar de emitir silenciosamente texto en blanco, haciendo que los problemas de calidad de datos sean visibles en una fase temprana del proceso.
Conflictos de delimitador: Si sus datos contienen el carácter delimitador (por ejemplo, un campo de precio que contiene $1,200.00 cuando se utiliza la coma como delimitador), IronXL envuelve el valor entre comillas dobles automáticamente según las reglas RFC 4180.
Para obtener orientación detallada, consulta la documentación de IronXL CSV, la referencia de la API y los recursos de soporte.
La escritura en CSV es solo la mitad de la historia. IronXL también gestiona la lectura y el análisis de archivos CSV, cargando datos separados por comas en una estructura de libro de trabajo que se puede consultar, filtrar y transformar antes de exportar a cualquier formato.
using IronXL;
// Load an existing CSV file into a workbook
WorkBook workBook = WorkBook.Load("sales_data.csv");
WorkSheet workSheet = workBook.DefaultWorkSheet;
// Iterate over rows and process data
foreach (var row in workSheet.Rows)
{
string product = row["A"].ToString();
int quantity = row["B"].IntValue;
decimal price = (decimal)row["C"].DoubleValue;
Console.WriteLine($"Product: {product}, Qty: {quantity}, Price: {price:C}");
}
// Apply a filter and re-export to a new CSV
workBook.SaveAsCsv("filtered_output.csv", ",");Imports IronXL
' Load an existing CSV file into a workbook
Dim workBook As WorkBook = WorkBook.Load("sales_data.csv")
Dim workSheet As WorkSheet = workBook.DefaultWorkSheet
' Iterate over rows and process data
For Each row In workSheet.Rows
Dim product As String = row("A").ToString()
Dim quantity As Integer = row("B").IntValue
Dim price As Decimal = CType(row("C").DoubleValue, Decimal)
Console.WriteLine($"Product: {product}, Qty: {quantity}, Price: {price:C}")
Next
' Apply a filter and re-export to a new CSV
workBook.SaveAsCsv("filtered_output.csv", ",")Al cargar un archivo CSV a través de IronXL, se obtiene acceso a la API completa de la hoja de cálculo, incluyendo ordenación, filtrado y evaluación de fórmulas. También puede guardar los datos cargados como un archivo de Excel utilizando SaveAs, convirtiendo CSV a XLSX en una sola llamada al método, un requisito habitual al crear servicios de generación de informes.
Las empresas españolas que preparan la declaración del IVA mediante el Modelo 303 o la declaración de operaciones del Modelo 347 necesitan exportar datos de sus sistemas internos a CSV para su posterior carga en los modelos de la AEAT o para su procesamiento por parte de los asesores fiscales. IronXL permite construir este flujo de exportación con mínimo código:
using IronXL;
using System.Data;
// Obtener datos fiscales del sistema interno
DataTable operacionesIVA = ObtenerOperacionesTrimestre("Q1-2026");
WorkBook wb = WorkBook.Create();
WorkSheet ws = wb.CreateWorkSheet("Modelo303_T1");
// Cabeceras del informe fiscal
ws["A1"].Value = "NIF_Proveedor";
ws["B1"].Value = "RazonSocial";
ws["C1"].Value = "FechaFactura";
ws["D1"].Value = "BaseImponible";
ws["E1"].Value = "TipoIVA";
ws["F1"].Value = "CuotaIVA";
ws["G1"].Value = "TotalFactura";
// Poblar con datos
int rowIdx = 2;
foreach (DataRow dr in operacionesIVA.Rows)
{
ws[$"A{rowIdx}"].Value = dr["nif_proveedor"]?.ToString();
ws[$"B{rowIdx}"].Value = dr["razon_social"]?.ToString();
ws[$"C{rowIdx}"].Value = dr["fecha_factura"]?.ToString();
ws[$"D{rowIdx}"].Value = dr["base_imponible"];
ws[$"E{rowIdx}"].Value = dr["tipo_iva"];
ws[$"F{rowIdx}"].Value = dr["cuota_iva"];
ws[$"G{rowIdx}"].Value = dr["total_factura"];
rowIdx++;
}
// Exportar con punto y coma para compatibilidad AEAT
wb.SaveAsCsv("modelo303_T1_2026.csv", ";");Imports IronXL
Imports System.Data
' Obtener datos fiscales del sistema interno
Dim operacionesIVA As DataTable = ObtenerOperacionesTrimestre("Q1-2026")
Dim wb As WorkBook = WorkBook.Create()
Dim ws As WorkSheet = wb.CreateWorkSheet("Modelo303_T1")
' Cabeceras del informe fiscal
ws("A1").Value = "NIF_Proveedor"
ws("B1").Value = "RazonSocial"
ws("C1").Value = "FechaFactura"
ws("D1").Value = "BaseImponible"
ws("E1").Value = "TipoIVA"
ws("F1").Value = "CuotaIVA"
ws("G1").Value = "TotalFactura"
' Poblar con datos
Dim rowIdx As Integer = 2
For Each dr As DataRow In operacionesIVA.Rows
ws($"A{rowIdx}").Value = If(dr("nif_proveedor")?.ToString(), Nothing)
ws($"B{rowIdx}").Value = If(dr("razon_social")?.ToString(), Nothing)
ws($"C{rowIdx}").Value = If(dr("fecha_factura")?.ToString(), Nothing)
ws($"D{rowIdx}").Value = dr("base_imponible")
ws($"E{rowIdx}").Value = dr("tipo_iva")
ws($"F{rowIdx}").Value = dr("cuota_iva")
ws($"G{rowIdx}").Value = dr("total_factura")
rowIdx += 1
Next
' Exportar con punto y coma para compatibilidad AEAT
wb.SaveAsCsv("modelo303_T1_2026.csv", ";")Este patrón garantiza que los datos exportados respetan los tipos numéricos sin conversión de cadenas errónea, un problema frecuente al exportar importes decimales en entornos con configuración regional española (es-ES). La conformidad con la LOPDGDD se preserva al no incluir en el CSV más campos de datos personales de los estrictamente necesarios para el informe fiscal.
La validación de datos antes de la exportación evita fallos en el proceso posterior. IronXL te ofrece acceso directo a los valores y tipos de las celdas, por lo que puedes comprobar si hay valores nulos, aplicar rangos numéricos y rechazar fechas mal formadas antes de escribir:
using IronXL;
WorkBook workBook = WorkBook.Load("input.xlsx");
WorkSheet workSheet = workBook.DefaultWorkSheet;
var errors = new List<string>();
for (int rowIdx = 1; rowIdx <= workSheet.RowCount; rowIdx++)
{
string productName = workSheet[$"A{rowIdx}"].StringValue;
double price = workSheet[$"C{rowIdx}"].DoubleValue;
if (string.IsNullOrWhiteSpace(productName))
errors.Add($"Row {rowIdx}: Product name is empty.");
if (price <= 0)
errors.Add($"Row {rowIdx}: Price must be greater than zero (found {price}).");
}
if (errors.Count == 0)
{
workBook.SaveAsCsv("validated_output.csv", ",");
Console.WriteLine("Export complete.");
}
else
{
foreach (var error in errors)
Console.WriteLine(error);
}Imports IronXL
Dim workBook As WorkBook = WorkBook.Load("input.xlsx")
Dim workSheet As WorkSheet = workBook.DefaultWorkSheet
Dim errors As New List(Of String)()
For rowIdx As Integer = 1 To workSheet.RowCount
Dim productName As String = workSheet($"A{rowIdx}").StringValue
Dim price As Double = workSheet($"C{rowIdx}").DoubleValue
If String.IsNullOrWhiteSpace(productName) Then
errors.Add($"Row {rowIdx}: Product name is empty.")
End If
If price <= 0 Then
errors.Add($"Row {rowIdx}: Price must be greater than zero (found {price}).")
End If
Next
If errors.Count = 0 Then
workBook.SaveAsCsv("validated_output.csv", ",")
Console.WriteLine("Export complete.")
Else
For Each error As String In errors
Console.WriteLine(error)
Next
End IfEste patrón resulta especialmente valioso en los procesos ETL, donde las filas erróneas deben rechazarse —y registrarse— en lugar de exportarse sin más. Los métodos de acceso a datos de celda en los objetos RangeRow y Cell de IronXL devuelven valores fuertemente tipados, lo que reduce el riesgo de errores silenciosos de coerción de tipos.
IronXL transforma la escritura de CSV de un reto de análisis sintáctico en una operación directa. Al combinar la funcionalidad CSV con la compatibilidad con libros de Excel, la evaluación de fórmulas y el manejo automático de tipos, elimina la complejidad de gestionar múltiples bibliotecas o las conversiones manuales de datos.
Para los equipos de desarrollo que trabajan en proyectos de cumplimiento normativo en España — desde la integración con el SII de la AEAT hasta la implementación de TicketBAI en los territorios forales de Bizkaia, Gipuzkoa y Araba — IronXL proporciona una base sólida para la generación de exportaciones CSV que cumplen con los requisitos técnicos y de integridad de datos de cada administración. La capacidad de generar ficheros con delimitador punto y coma, codificación UTF-8 y validación tipológica hace de IronXL una herramienta de primera elección en proyectos fiscales y de cumplimiento de la LOPDGDD.
La versión de prueba gratuita le ofrece acceso completo a todas las funciones —incluidas las exportaciones de varias hojas, la evaluación de fórmulas y la implementación multiplataforma— sin necesidad de una clave de licencia durante el desarrollo. Cuando esté listo para pasar a producción, las licencias comienzan en un nivel de desarrollador único que cubre el uso comercial.
Recursos clave para empezar:
¿Listo para crear flujos de trabajo CSV listos para producción? Comienza tu prueba gratuita y ejecuta tu primera exportación CSV en menos de cinco minutos.
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.
IronXL es parte de IRONSUITE
10 productos API .NET para tus documentos de oficina
La API de Excel que necesita, sin la molestia de Office Interop.
