Comment lire un fichier CSV dans une DataTable en C#

Pourquoi la conversion CSV vers DataTable est-elle importante ?

La conversion CSV vers DataTable permet aux développeurs de transformer des valeurs séparées par des virgules en objets structurés pour un traitement ultérieur. Que vous gériez des données d'inventaire, des dossiers clients ou des journaux de transactions, convertir efficacement les fichiers CSV en DataTable est crucial. En utilisant la première ligne comme en-têtes de colonnes, vous pouvez garantir que les colonnes de DataTable correspondent au schéma de votre table de base de données, ce qui la rend idéale pour les opérations Excel vers SQL .

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 CSV d'IronXL éliminent les problèmes courants 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 l'une des commandes suivantes :

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;

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 vérifier que l'installation a réussi ?

Créez un programme de test qui charge un fichier CSV pour vérifier l'installation. Si vous rencontrez des messages relatifs à la licence, vous devrez obtenir une clé de licence . Vérifiez les références des packages dans votre fichier de projet pour vous assurer IronXL apparaît avec la version correcte. Effectuez une opération de lecture CSV de base ; si elle se termine sans erreur, votre installation fonctionne correctement.

Installer avec NuGet

PM >  Install-Package IronXL.Excel

Consultez IronXL sur NuGet pour une installation rapide. Avec plus de 10 millions de téléchargements, il transforme le développement PDF avec C#. Vous pouvez également télécharger le DLL.

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 en utilisant des instructions de niveau supérieur 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();
}

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 un DataTable, avec le paramètre true indiquant que la première ligne doit être utilisée comme en-têtes de colonne. Cela donne 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 complet d'utilisation IronXL .

Le processus de conversion préserve également les types de données : les nombres restent numériques, les dates sont correctement analysées et les champs de texte conservent leur formatage. 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 scénarios nécessitant une mise en forme personnalisée des données, vous pouvez appliquer la mise en forme des cellules avant la conversion.

Comment importer un DataTable dans SQL Server ?

Une fois que vous avez votre DataTable, son importation dans SQL Server devient efficace grâce à 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");

La classe SqlBulkCopy offre des performances élevées pour les importations de données à grande échelle. La collection ColumnMappings mappe les colonnes DataTable à des colonnes de base de données avec des noms différents, assurant ainsi 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 plutôt qu'en chargeant tout en une seule fois. Découvrez plus en détail 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 l'importation.

Ici, vous pouvez utiliser la requête SELECT * FROM dbo.Inventory; dans SSMS pour vérifier que vos données CSV ont été importées dans le serveur SQL. Tout d'abord, examinez les données utilisées dans l'exemple de fichier CSV :

Si vous examinez le résultat de la requête, vous pouvez constater qu'elle a correctement copié chaque colonne, en-tête et ligne dans la table de la base de données.

Résultats d'une requête SQL affichant 3 enregistrements d'inventaire importés d'un fichier CSV avec les codes produits A100, B200 et C300, leurs quantités et horodatages dans un outil de gestion de base de données.

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

Tous les fichiers CSV n'utilisent pas de virgules. IronXL gère différents délimiteurs, ce qui le rend pratique pour les formats de données internationaux ou les systèmes existants. L'exemple suivant illustre le chargement de fichiers délimités par des tabulations et par des points-virgules :

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();
}

Ce code illustre 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. La feuille de calcul par défaut de chaque classeur est convertie en un DataTable avec ToDataTable(true), qui utilise la première ligne comme en-têtes de colonne. Pour les scénarios de formats de fichiers plus complexes, vous pouvez également envisager d'exporter des données Excel vers différents formats.

La possibilité de gérer différents délimiteurs permet de résoudre de nombreux problèmes concrets d'analyse des fichiers CSV. Lors de l'utilisation de formats de données européens, la gestion des délimiteurs d'IronXL prend en compte les différences régionales en matière de normes de formatage des données. Pour les fichiers dont la structure est incohérente, prétraitez le texte brut avant de le transmettre à LoadCSV.

La norme RFC 4180 définit la spécification du format CSV IronXL suit pour les champs entre guillemets et les virgules intégrées. Cette flexibilité est également abordée en détail dans le fil de discussion de la communauté Stack Overflow sur la lecture de fichiers CSV dans DataTable en .NET .

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 les fichiers CSV à partir de n'importe quel chemin d'accès grâce à la fonction LoadCSV
• Convertir les données CSV en un fichier DataTable avec une mise en forme correcte
• Préserver les en-têtes de colonnes et les colonnes DataTable grâce à une analyse automatique Importez efficacement des millions de lignes dans une table de base de données grâce aux opérations par lots.

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 créiez des applications ASP.NET , travailliez avec Blazor ou développiez des applications de bureau .NET 10, IronXL assure 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 d'essai vous permet d'évaluer la bibliothèque complète. Grâce à de nombreux exemples de code et à des références API claires, vous traiterez efficacement les fichiers CSV dans vos applications .NET 10 en un rien de temps.