How to Use C# to Convert Datatable to CSV

¿Qué método de instalación debo utilizar?

Descárgalo desde la página oficial a través del siguiente enlace: https://ironsoftware.com/csharp/excel/docs/

or

• En Visual Studio, selecciona el menú Proyecto
• Haz clic en Administrar paquetes de NuGet
• Buscar IronXL.Excel
• Haz clic en Instalar

¿Qué comando NuGet debo usar?

Install-Package IronXL.Excel

¿Por qué elegir NuGet Package Manager?

NuGet es el método preferido por los desarrolladores .NET porque gestiona automáticamente las dependencias y mantiene las bibliotecas actualizadas. El paquete IronXL incluye todos los componentes necesarios para convertir tipos de archivo de hojas de cálculo y trabajar con varios formatos de Excel.

Figura 1 - Paquete NuGet IronXL.Excel

Tutorial de cómo hacerlo

¿Qué espacio de nombres necesito importar?

Primero, importa el espacio de nombres IronXL. IronXL proporciona soporte integral para importar y exportar objetos DataSet y DataTable, lo que lo hace ideal para aplicaciones impulsadas por bases de datos.

:path=/static-assets/excel/content-code-examples/how-to/csharp-datatable-to-csv-3.cs

using IronXL;

Imports IronXL

¿Cuál es el ejemplo de código completo?

Agrega el siguiente código:

:path=/static-assets/excel/content-code-examples/how-to/csharp-database-to-csv-datatable.cs

using IronXL;
using System;
using System.Data;

// Create a new DataTable object
DataTable table = new DataTable();

// Add a single column named "Example_DataSet" of type string
table.Columns.Add("Example_DataSet", typeof(string));

// Add rows to the DataTable
table.Rows.Add("0");
table.Rows.Add("1");
table.Rows.Add("2");
table.Rows.Add("3");
table.Rows.Add("1");
table.Rows.Add("2");
table.Rows.Add("3");

// Create a new Excel workbook and set its author metadata
WorkBook wb = WorkBook.Create(ExcelFileFormat.XLS);
wb.Metadata.Author = "OJ";

// Get the default worksheet
WorkSheet ws = wb.DefaultWorkSheet;

// Initialize rowCounter for Excel sheet rows
int rowCount = 1;

// Loop through each row in the DataTable and add the data to the Excel worksheet
foreach (DataRow row in table.Rows)
{
    // Populate worksheet cells with data from DataTable
    ws["A" + (rowCount)].Value = row[0].ToString();
    rowCount++;
}

// Save the workbook as a CSV file
wb.SaveAsCsv("Save_DataTable_CSV.csv", ";"); // Will be saved as: Save_DataTable_CSV.Sheet1.csv

Imports IronXL
Imports System
Imports System.Data

' Create a new DataTable object
Dim table As New DataTable()

' Add a single column named "Example_DataSet" of type string
table.Columns.Add("Example_DataSet", GetType(String))

' Add rows to the DataTable
table.Rows.Add("0")
table.Rows.Add("1")
table.Rows.Add("2")
table.Rows.Add("3")
table.Rows.Add("1")
table.Rows.Add("2")
table.Rows.Add("3")

' Create a new Excel workbook and set its author metadata
Dim wb As WorkBook = WorkBook.Create(ExcelFileFormat.XLS)
wb.Metadata.Author = "OJ"

' Get the default worksheet
Dim ws As WorkSheet = wb.DefaultWorkSheet

' Initialize rowCounter for Excel sheet rows
Dim rowCount As Integer = 1

' Loop through each row in the DataTable and add the data to the Excel worksheet
For Each row As DataRow In table.Rows
    ' Populate worksheet cells with data from DataTable
    ws("A" & rowCount).Value = row(0).ToString()
    rowCount += 1
Next

' Save the workbook as a CSV file
wb.SaveAsCsv("Save_DataTable_CSV.csv", ";") ' Will be saved as: Save_DataTable_CSV.Sheet1.csv

¿Cómo funciona el código paso a paso?

El código anterior crea un DataTable, crea un nuevo libro de trabajo especificando 'OJ' como su propietario, luego usa un bucle foreach para insertar datos del DataTable en la hoja de cálculo de Excel. Finalmente, el método SaveAsCsv exporta la tabla de datos a CSV.

Desglose del proceso:

1. Creación de DataTable: Inicializa un nuevo DataTable y define su esquema agregando columnas. Esto se asemeja a la definición de la estructura de una tabla de una base de datos.

2. Población de Datos: Añadir filas al DataTable usando el método Rows.Add(). Cada fila representa un registro para exportación a CSV.

3. Generación de Libro de Trabajo: El método WorkBook.Create() de IronXL inicializa un nuevo libro de trabajo de Excel. También puedes crear hojas de cálculo con varias hojas de cálculo si es necesario.

4. Población de Celdas: El bucle foreach itera a través de las filas DataTable y asigna cada valor a una celda específica de la hoja de trabajo utilizando la sintaxis de referencia de celda (por ejemplo, "A1", "A2").

5. Exportación de CSV: El método SaveAsCsv() maneja las complejidades del formateo de CSV, incluyendo el escape adecuado de caracteres especiales y el manejo de delimitadores.

¿Qué pasa con los escenarios avanzados de DataTable?

Para DataTables complejos con múltiples columnas, extiende el código de esta manera:

// Create a DataTable with multiple columns
DataTable advancedTable = new DataTable();
advancedTable.Columns.Add("ID", typeof(int));
advancedTable.Columns.Add("Name", typeof(string));
advancedTable.Columns.Add("Price", typeof(decimal));

--snip--
workbook.SaveAsCsv("products.csv", ",");

// Create a DataTable with multiple columns
DataTable advancedTable = new DataTable();
advancedTable.Columns.Add("ID", typeof(int));
advancedTable.Columns.Add("Name", typeof(string));
advancedTable.Columns.Add("Price", typeof(decimal));

--snip--
workbook.SaveAsCsv("products.csv", ",");

' Create a DataTable with multiple columns
Dim advancedTable As New DataTable()
advancedTable.Columns.Add("ID", GetType(Integer))
advancedTable.Columns.Add("Name", GetType(String))
advancedTable.Columns.Add("Price", GetType(Decimal))

' --snip--
workbook.SaveAsCsv("products.csv", ",")

¿Qué aspecto tiene el resultado?

La hoja de cálculo Excel de salida muestra lo siguiente:

Figura 2 - Salida de la tabla de datos a CSV

¿Cómo manejo DataTables grandes?

Cuando se trabaja con DataTables grandes que contienen miles de filas, IronXL mantiene un excelente rendimiento. La biblioteca maneja conjuntos de datos sustanciales de forma eficiente. Para entornos de producción, aplique su clave de licencia para eliminar las marcas de agua y habilitar la funcionalidad completa.

¿Qué pasa con la gestión de errores?

Aplique siempre una gestión de errores adecuada cuando trabaje con operaciones de archivos:

:path=/static-assets/excel/content-code-examples/how-to/csharp-datatable-to-csv-6.cs

try 
{
    // Your DataTable to CSV conversion code
    WorkBook wb = WorkBook.Create();
    // ... rest of the code
    wb.SaveAsCsv("output.csv", ",");
    Console.WriteLine("CSV file created successfully!");
}
catch (Exception ex)
{
    Console.WriteLine($"Error creating CSV: {ex.Message}");
}

Imports System

Try
    ' Your DataTable to CSV conversion code
    Dim wb As WorkBook = WorkBook.Create()
    ' ... rest of the code
    wb.SaveAsCsv("output.csv", ",")
    Console.WriteLine("CSV file created successfully!")
Catch ex As Exception
    Console.WriteLine($"Error creating CSV: {ex.Message}")
End Try

$vbLabelText   $csharpLabel

---

Acceso rápido a la biblioteca

Documentación de referencia de la API de IronXL

Obtenga más información y comparta cómo fusionar, separar y trabajar con celdas en hojas de cálculo de Excel utilizando la práctica documentación de referencia de API de IronXL.

Documentación de referencia de la API de IronXL