Comment lire un fichier CSV dans une DataTable en C#

Pourquoi la conversion de CSV en DataTable est-elle importante ?

La conversion CSV en DataTable permet aux développeurs de transformer des valeurs séparées par des virgules en objets structurés en vue d'un traitement ultérieur. Que vous traitiez des données d'inventaire, des dossiers clients ou des journaux de transactions, il est essentiel de convertir efficacement le CSV en DataTable. En utilisant la première ligne comme en-tête de colonne, vous pouvez vous assurer que les colonnes de DataTable s'alignent sur le schéma de votre table de base de données, ce qui est parfait pour les opérations Excel to DataSet.

Les approches traditionnelles rencontrent souvent des difficultés avec les fichiers volumineux, les différents délimiteurs ou la gestion de la mémoire. IronXL élimine ces difficultés et gère différents délimiteurs, les champs entre guillemets et les virgules imbriquées sans code supplémentaire. Les capacités de lecture de fichiers CSV d'IronXL éliminent les difficultés courantes tout en offrant des fonctionnalités supplémentaires telles que la validation des données et le contrôle de la taille des fichiers.

Comment installer IronXL?

Pour commencer avec IronXL, il suffit d'installer un simple package NuGet . Ouvrez la console du gestionnaire de packages NuGet dans Visual Studio et exécutez :

Install-Package IronXL

Install-Package IronXL

Ou si vous préférez l'interface de ligne de commande .NET :

dotnet add package IronXL

dotnet add package IronXL

Une fois installé, ajoutez l'espace de noms IronXL à votre projet :

using IronXL;
using System.Data;

using IronXL;
using System.Data;

Imports IronXL
Imports System.Data

Cela permet d'accéder à toutes les fonctionnalités de traitement CSV sans aucune dépendance à Excel. Pour plus de détails, consultez la documentation IronXL et le guide d'installation NuGet.

Comment convertir un fichier CSV en DataTable?

Le flux de travail principal d' IronXL ne nécessite que quelques lignes de code. Voici comment lire un fichier CSV et le convertir en DataTable à l'aide d'instructions de premier niveau en C# 10+ :

using IronXL;
using System.Data;

// Load CSV file into a WorkBook object
WorkBook workbook = WorkBook.LoadCSV("sales_data.csv",
    fileFormat: ExcelFileFormat.XLSX);

// Access the default worksheet
WorkSheet worksheet = workbook.DefaultWorkSheet;

// Convert to DataTable with headers
DataTable dataTable = worksheet.ToDataTable(true);

// Display the data
foreach (DataRow row in dataTable.Rows)
{
    foreach (var item in row.ItemArray)
    {
        Console.Write($"{item}\t");
    }
    Console.WriteLine();
}

using IronXL;
using System.Data;

// Load CSV file into a WorkBook object
WorkBook workbook = WorkBook.LoadCSV("sales_data.csv",
    fileFormat: ExcelFileFormat.XLSX);

// Access the default worksheet
WorkSheet worksheet = workbook.DefaultWorkSheet;

// Convert to DataTable with headers
DataTable dataTable = worksheet.ToDataTable(true);

// Display the data
foreach (DataRow row in dataTable.Rows)
{
    foreach (var item in row.ItemArray)
    {
        Console.Write($"{item}\t");
    }
    Console.WriteLine();
}

Imports IronXL
Imports System.Data

' Load CSV file into a WorkBook object
Dim workbook As WorkBook = WorkBook.LoadCSV("sales_data.csv", fileFormat:=ExcelFileFormat.XLSX)

' Access the default worksheet
Dim worksheet As WorkSheet = workbook.DefaultWorkSheet

' Convert to DataTable with headers
Dim dataTable As DataTable = worksheet.ToDataTable(True)

' Display the data
For Each row As DataRow In dataTable.Rows
    For Each item In row.ItemArray
        Console.Write($"{item}" & vbTab)
    Next
    Console.WriteLine()
Next

La méthode LoadCSV analyse automatiquement votre fichier CSV, en gérant les champs entre guillemets et les virgules intégrées. Le paramètre fileFormat indique à IronXL comment interpréter les données CSV en interne, en veillant à ce qu'elles soient traitées comme une structure compatible avec Excel. Une fois chargée, la méthode ToDataTable(true) convertit la feuille de calcul en DataTable, le paramètre true indiquant que la première ligne doit être utilisée comme en-tête de colonne. Il en résulte un fichier propre et structuré DataTable avec des colonnes nommées qui correspondent à vos en-têtes CSV. Pour des options de manipulation plus avancées, consultez le guide pratique complet d'IronXL.

Le processus de conversion préserve également les types de données : les nombres restent numériques, les dates sont analysées correctement et les champs de texte conservent leur mise en forme. Cette inférence automatique de type permet de gagner un temps de développement considérable par rapport aux approches d'analyse syntaxique manuelle. Pour les cas nécessitant un formatage personnalisé des données, vous pouvez appliquer un formatage de cellule avant la conversion.

Comment importer un DataTable dans SQL Server?

Une fois que vous avez votre DataTable, l'importation dans SQL Server devient efficace grâce au SqlBulkCopy. L'exemple suivant utilise des instructions de niveau supérieur C# :

using System.Data;
using Microsoft.Data.SqlClient;
using IronXL;

// Create connection string
string connectionString = "Data Source=localhost;Initial Catalog=SalesDB;" +
    "Integrated Security=True;TrustServerCertificate=True;";

// Read CSV into DataTable
WorkBook workbook = WorkBook.LoadCSV("inventory_report.csv");
DataTable dataTable = workbook.DefaultWorkSheet.ToDataTable(true);

// Bulk insert into SQL Server
using SqlConnection connection = new SqlConnection(connectionString);
connection.Open();

using SqlBulkCopy bulkCopy = new SqlBulkCopy(connection);

// Set destination table name
bulkCopy.DestinationTableName = "dbo.Inventory";

// Map DataTable columns to SQL table columns
bulkCopy.ColumnMappings.Add("ProductCode", "product_code");
bulkCopy.ColumnMappings.Add("Quantity", "quantity");
bulkCopy.ColumnMappings.Add("LastUpdated", "last_updated");

// Set batch size for better performance
bulkCopy.BatchSize = 1000;

// Write data to SQL Server
bulkCopy.WriteToServer(dataTable);

Console.WriteLine($"Successfully imported {dataTable.Rows.Count} records");

using System.Data;
using Microsoft.Data.SqlClient;
using IronXL;

// Create connection string
string connectionString = "Data Source=localhost;Initial Catalog=SalesDB;" +
    "Integrated Security=True;TrustServerCertificate=True;";

// Read CSV into DataTable
WorkBook workbook = WorkBook.LoadCSV("inventory_report.csv");
DataTable dataTable = workbook.DefaultWorkSheet.ToDataTable(true);

// Bulk insert into SQL Server
using SqlConnection connection = new SqlConnection(connectionString);
connection.Open();

using SqlBulkCopy bulkCopy = new SqlBulkCopy(connection);

// Set destination table name
bulkCopy.DestinationTableName = "dbo.Inventory";

// Map DataTable columns to SQL table columns
bulkCopy.ColumnMappings.Add("ProductCode", "product_code");
bulkCopy.ColumnMappings.Add("Quantity", "quantity");
bulkCopy.ColumnMappings.Add("LastUpdated", "last_updated");

// Set batch size for better performance
bulkCopy.BatchSize = 1000;

// Write data to SQL Server
bulkCopy.WriteToServer(dataTable);

Console.WriteLine($"Successfully imported {dataTable.Rows.Count} records");

Imports System.Data
Imports Microsoft.Data.SqlClient
Imports IronXL

' Create connection string
Dim connectionString As String = "Data Source=localhost;Initial Catalog=SalesDB;" &
    "Integrated Security=True;TrustServerCertificate=True;"

' Read CSV into DataTable
Dim workbook As WorkBook = WorkBook.LoadCSV("inventory_report.csv")
Dim dataTable As DataTable = workbook.DefaultWorkSheet.ToDataTable(True)

' Bulk insert into SQL Server
Using connection As New SqlConnection(connectionString)
    connection.Open()

    Using bulkCopy As New SqlBulkCopy(connection)
        ' Set destination table name
        bulkCopy.DestinationTableName = "dbo.Inventory"

        ' Map DataTable columns to SQL table columns
        bulkCopy.ColumnMappings.Add("ProductCode", "product_code")
        bulkCopy.ColumnMappings.Add("Quantity", "quantity")
        bulkCopy.ColumnMappings.Add("LastUpdated", "last_updated")

        ' Set batch size for better performance
        bulkCopy.BatchSize = 1000

        ' Write data to SQL Server
        bulkCopy.WriteToServer(dataTable)
    End Using
End Using

Console.WriteLine($"Successfully imported {dataTable.Rows.Count} records")

La classe SqlBulkCopy offre de bonnes performances pour les importations de données à grande échelle. La collection ColumnMappings fait correspondre les colonnes DataTable à des colonnes de base de données portant des noms différents, ce qui garantit la flexibilité de votre schéma de données. La propriété BatchSize optimise l'utilisation de la mémoire en traitant les enregistrements par morceaux au lieu de tout charger en même temps. En savoir plus sur les fonctionnalités d'importation et d'exportation d'IronXL.

Pour une intégrité des données accrue, envisagez la mise en œuvre d'une prise en charge des transactions pour vos opérations de copie en masse. Cela permet d'annuler les importations partielles en cas d'erreur. Vous pouvez également utiliser les fonctionnalités d'écriture de fichiers Excel d'IronXL pour pré-valider les données avant leur importation.

Comment gérer les différents délimiteurs CSV ?

Tous les fichiers CSV n'utilisent pas de virgules. IronXL prend en charge divers délimiteurs, ce qui le rend pratique pour les formats de données internationaux ou les systèmes hérités :

using IronXL;
using System;
using System.Data;
using System.IO;

// --- Tab-delimited file ---
string tsvPath = "export_data.tsv";
WorkBook tsvWorkbook = WorkBook.LoadCSV(tsvPath, ExcelFileFormat.XLSX, "\t");

// --- Semicolon-delimited file ---
string semiPath = "european_data.csv";
string tempCsv = Path.Combine(Path.GetTempPath(), "european_data_comma.csv");

// Replace semicolons with commas for proper parsing
string[] lines = File.ReadAllLines(semiPath);
for (int i = 0; i < lines.Length; i++)
{
    lines[i] = lines[i].Replace(';', ',');
}
File.WriteAllLines(tempCsv, lines);

WorkBook semiWorkbook = WorkBook.LoadCSV(tempCsv, ExcelFileFormat.XLSX);

// Print tab-delimited results
DataTable tsvTable = tsvWorkbook.DefaultWorkSheet.ToDataTable(true);
Console.WriteLine("--- Tab-delimited File ---");
foreach (DataColumn col in tsvTable.Columns)
    Console.Write($"{col.ColumnName}\t");
Console.WriteLine();
foreach (DataRow row in tsvTable.Rows)
{
    foreach (var item in row.ItemArray)
        Console.Write($"{item}\t");
    Console.WriteLine();
}

// Print semicolon-delimited results
DataTable semiTable = semiWorkbook.DefaultWorkSheet.ToDataTable(true);
Console.WriteLine("\n--- Semicolon-delimited File ---");
foreach (DataColumn col in semiTable.Columns)
    Console.Write($"{col.ColumnName}\t");
Console.WriteLine();
foreach (DataRow row in semiTable.Rows)
{
    foreach (var item in row.ItemArray)
        Console.Write($"{item}\t");
    Console.WriteLine();
}

using IronXL;
using System;
using System.Data;
using System.IO;

// --- Tab-delimited file ---
string tsvPath = "export_data.tsv";
WorkBook tsvWorkbook = WorkBook.LoadCSV(tsvPath, ExcelFileFormat.XLSX, "\t");

// --- Semicolon-delimited file ---
string semiPath = "european_data.csv";
string tempCsv = Path.Combine(Path.GetTempPath(), "european_data_comma.csv");

// Replace semicolons with commas for proper parsing
string[] lines = File.ReadAllLines(semiPath);
for (int i = 0; i < lines.Length; i++)
{
    lines[i] = lines[i].Replace(';', ',');
}
File.WriteAllLines(tempCsv, lines);

WorkBook semiWorkbook = WorkBook.LoadCSV(tempCsv, ExcelFileFormat.XLSX);

// Print tab-delimited results
DataTable tsvTable = tsvWorkbook.DefaultWorkSheet.ToDataTable(true);
Console.WriteLine("--- Tab-delimited File ---");
foreach (DataColumn col in tsvTable.Columns)
    Console.Write($"{col.ColumnName}\t");
Console.WriteLine();
foreach (DataRow row in tsvTable.Rows)
{
    foreach (var item in row.ItemArray)
        Console.Write($"{item}\t");
    Console.WriteLine();
}

// Print semicolon-delimited results
DataTable semiTable = semiWorkbook.DefaultWorkSheet.ToDataTable(true);
Console.WriteLine("\n--- Semicolon-delimited File ---");
foreach (DataColumn col in semiTable.Columns)
    Console.Write($"{col.ColumnName}\t");
Console.WriteLine();
foreach (DataRow row in semiTable.Rows)
{
    foreach (var item in row.ItemArray)
        Console.Write($"{item}\t");
    Console.WriteLine();
}

Imports IronXL
Imports System
Imports System.Data
Imports System.IO

' --- Tab-delimited file ---
Dim tsvPath As String = "export_data.tsv"
Dim tsvWorkbook As WorkBook = WorkBook.LoadCSV(tsvPath, ExcelFileFormat.XLSX, ControlChars.Tab)

' --- Semicolon-delimited file ---
Dim semiPath As String = "european_data.csv"
Dim tempCsv As String = Path.Combine(Path.GetTempPath(), "european_data_comma.csv")

' Replace semicolons with commas for proper parsing
Dim lines As String() = File.ReadAllLines(semiPath)
For i As Integer = 0 To lines.Length - 1
    lines(i) = lines(i).Replace(";"c, ","c)
Next
File.WriteAllLines(tempCsv, lines)

Dim semiWorkbook As WorkBook = WorkBook.LoadCSV(tempCsv, ExcelFileFormat.XLSX)

' Print tab-delimited results
Dim tsvTable As DataTable = tsvWorkbook.DefaultWorkSheet.ToDataTable(True)
Console.WriteLine("--- Tab-delimited File ---")
For Each col As DataColumn In tsvTable.Columns
    Console.Write($"{col.ColumnName}{ControlChars.Tab}")
Next
Console.WriteLine()
For Each row As DataRow In tsvTable.Rows
    For Each item In row.ItemArray
        Console.Write($"{item}{ControlChars.Tab}")
    Next
    Console.WriteLine()
Next

' Print semicolon-delimited results
Dim semiTable As DataTable = semiWorkbook.DefaultWorkSheet.ToDataTable(True)
Console.WriteLine(vbCrLf & "--- Semicolon-delimited File ---")
For Each col As DataColumn In semiTable.Columns
    Console.Write($"{col.ColumnName}{ControlChars.Tab}")
Next
Console.WriteLine()
For Each row As DataRow In semiTable.Rows
    For Each item In row.ItemArray
        Console.Write($"{item}{ControlChars.Tab}")
    Next
    Console.WriteLine()
Next

Ce code démontre le chargement de fichiers CSV avec différents délimiteurs dans des objets IronXL WorkBook. Les fichiers délimités par des tabulations sont lus en utilisant "\t" comme séparateur, tandis que les fichiers délimités par des points-virgules sont convertis au format CSV standard avant d'être chargés. Pour des cas de figure plus complexes en matière de formats de fichiers, vous pouvez également envisager d'exporter des données Excel vers divers formats.

Quelles sont les fonctionnalités IronXL prises en charge en plus du format CSV ?

IronXL offre bien plus que la simple lecture de fichiers CSV. Cette bibliothèque gère l'ensemble des opérations Excel et tableur en C#, ce qui en fait une dépendance unique pour les applications axées sur les données.

Quelles sont les prochaines étapes?

IronXL transforme l'importation de bases de données CSV en un processus simple et fiable. Avec seulement quelques lignes de code, vous pouvez :

• Lire des fichiers CSV à partir de n'importe quel chemin d'accès à l'aide de la fonctionnalité LoadCSV
• Convertir des données CSV en un DataTable avec un formatage correct des données
• Conserver les en-têtes de colonnes et les colonnes DataTable grâce à l'analyse syntaxique automatique
• Importez efficacement des millions de lignes dans une table de base de données à l'aide d'opérations en masse

La bibliothèque gère les subtilités de l'analyse CSV, de la gestion de la mémoire et des conversions de types de données, vous permettant ainsi de vous concentrer sur votre logique métier plutôt que sur les détails du traitement des fichiers. Que vous développiez des applications ASP.NET, travailliez avec Blazor ou développiez des applications de bureau .NET 10, IronXL offre un traitement CSV cohérent et fiable sur toutes les plateformes.

Prêt à démarrer ? La documentation IronXL couvre chaque fonctionnalité en détail, et une Licence Trial vous permet d'évaluer l'intégralité de la bibliothèque IronXL.