Lecteur et enregistreur CSV en C# : créez, exportez et convertissez des fichiers CSV avec IronXL

Qu'est-ce que le format CSV et pourquoi est-il important ?

Un fichier CSV (Comma Separated Values) est l'un des formats les plus utilisés pour stocker et échanger des données tabulaires entre différentes applications. Dans sa forme la plus simple, un fichier CSV est un fichier texte brut dont chaque ligne contient une série de valeurs séparées par des virgules. Grâce à cette structure simple, les données CSV sont faciles à générer, à lire et à traiter dans un large éventail de systèmes logiciels.

Le format CSV est à la fois léger et lisible par l'homme, ce qui explique sa popularité pour l'exportation de rapports, le transfert de données entre bases de données et l'intégration avec des outils d'analyse. Chaque ligne d'un fichier CSV représente un enregistrement unique, et chaque valeur de cette ligne est séparée par une virgule. La première ligne du fichier sert généralement d'en-tête et énumère les noms de chaque colonne. Chaque ligne suivante contient les données réelles, chaque valeur correspondant à une colonne de l'en-tête.

Comprendre la structure des fichiers CSV vous aide à prendre de meilleures décisions concernant le choix du délimiteur, l'échappement des caractères et l'encodage – autant de facteurs qui influencent la capacité des systèmes en aval à analyser correctement votre sortie. Le format de fichier CSV est défini par la RFC 4180, qui fournit des indications sur la gestion des cas particuliers tels que les virgules imbriquées, les caractères de nouvelle ligne dans les champs et les valeurs de chaîne entre guillemets.

Comment installer IronXL dans votre projet .NET ?

L'ajout IronXL à un nouveau projet ne prend que quelques secondes via NuGet, le gestionnaire de packages de Microsoft for .NET. Ouvrez Visual Studio, puis accédez à la console du Package Manager NuGet et exécutez la commande suivante :

Install-Package IronXl.Excel

Vous pouvez également cliquer avec le bouton droit de la souris sur votre projet dans l'Explorateur de solutions, sélectionner "Gérer les packages NuGet", rechercher "IronXL" dans l'onglet Parcourir et cliquer sur Installer. IronXL prend en charge .NET Framework 4.6.2+, .NET Core, .NET 5/6/7/8/10 et fonctionne sur n'importe quelle plateforme sans dépendances externes ni exigences d'interopérabilité COM.

Une fois installé, ajoutez l'espace de noms IronXL à votre fichier de code en utilisant l'instruction using :

using IronXL;

using IronXL;

Cet espace de noms unique permet d'accéder à toutes les classes nécessaires à la création de feuilles de calcul et aux opérations d'exportation CSV. Contrairement aux approches qui s'appuient sur StreamWriter ou StringBuilder pour écrire manuellement des fichiers CSV, IronXL gère automatiquement toute la complexité d'un formatage CSV correct, y compris l'échappement des caractères spéciaux, la préservation des types de données et l'évaluation des formules avant l'exportation.

La documentation IronXL couvre l'intégralité de l'API, y compris les fonctionnalités avancées telles que la mise en forme des cellules, l'évaluation des formules, la protection par mot de passe et la génération de graphiques. Pour une consultation rapide, la bibliothèque d'exemples IronXL fournit des exemples de code prêts à l'emploi couvrant des dizaines de scénarios courants de feuilles de calcul.

Comment créer un nouveau fichier CSV à partir de zéro ?

La création d'un nouveau fichier CSV par programmation comprend trois étapes : la création d'un classeur, son remplissage avec des données et son enregistrement au format CSV. L'API d'IronXL reproduit le modèle objet Excel familier, ce qui permet aux développeurs d'écrire facilement du code fonctionnant avec les concepts de tableur dans une application console ou tout type de projet .NET .

Imaginez que vous deviez exporter une liste d'enregistrements d'employés au format CSV. Voici un exemple complet utilisant des instructions de niveau supérieur :

using IronXL;

// Create a new workbook and worksheet
WorkBook workBook = WorkBook.Create();
WorkSheet sheet = workBook.CreateWorkSheet("Employees");

// Add header row with column names
sheet["A1"].Value = "EmployeeID";
sheet["B1"].Value = "Name";
sheet["C1"].Value = "Department";
sheet["D1"].Value = "Salary";

// Add employee data rows
sheet["A2"].Value = 1001;
sheet["B2"].Value = "Sarah Johnson";
sheet["C2"].Value = "Engineering";
sheet["D2"].Value = 85000;

sheet["A3"].Value = 1002;
sheet["B3"].Value = "Michael Chen";
sheet["C3"].Value = "Marketing";
sheet["D3"].Value = 72000;

sheet["A4"].Value = 1003;
sheet["B4"].Value = "Emily Rodriguez";
sheet["C4"].Value = "Finance";
sheet["D4"].Value = 91000;

// Save as CSV file
workBook.SaveAsCsv("employees.csv", ",");

using IronXL;

// Create a new workbook and worksheet
WorkBook workBook = WorkBook.Create();
WorkSheet sheet = workBook.CreateWorkSheet("Employees");

// Add header row with column names
sheet["A1"].Value = "EmployeeID";
sheet["B1"].Value = "Name";
sheet["C1"].Value = "Department";
sheet["D1"].Value = "Salary";

// Add employee data rows
sheet["A2"].Value = 1001;
sheet["B2"].Value = "Sarah Johnson";
sheet["C2"].Value = "Engineering";
sheet["D2"].Value = 85000;

sheet["A3"].Value = 1002;
sheet["B3"].Value = "Michael Chen";
sheet["C3"].Value = "Marketing";
sheet["D3"].Value = 72000;

sheet["A4"].Value = 1003;
sheet["B4"].Value = "Emily Rodriguez";
sheet["C4"].Value = "Finance";
sheet["D4"].Value = 91000;

// Save as CSV file
workBook.SaveAsCsv("employees.csv", ",");

La méthode WorkBook.Create() initialise une nouvelle feuille de calcul entièrement en mémoire, ne nécessitant aucun fichier temporaire ni entrée/sortie disque jusqu'à l'opération d'enregistrement finale. La méthode CreateWorkSheet() ajoute une feuille de calcul nommée au classeur -- ce nom devient pertinent lors de l'exportation de classeurs à plusieurs feuilles vers CSV.

using IronXL;

// Define the Student class with public string properties
public class Student
{
    public string FirstName { get; set; }
    public string LastName { get; set; }
    public string Email { get; set; }
}

// Create sample data
var students = new List<Student>
{
    new Student { FirstName = "John", LastName = "Smith", Email = "john@example.com" },
    new Student { FirstName = "Jane", LastName = "Doe", Email = "jane@example.com" }
};

WorkBook workBook = WorkBook.Create();
WorkSheet sheet = workBook.DefaultWorkSheet;

// Add header row
sheet["A1"].Value = "FirstName";
sheet["B1"].Value = "LastName";
sheet["C1"].Value = "Email";

// Use foreach to iterate through the list and write each item
int row = 2;
foreach (var item in students)
{
    sheet[$"A{row}"].Value = item.FirstName;
    sheet[$"B{row}"].Value = item.LastName;
    sheet[$"C{row}"].Value = item.Email;
    row++;
}

workBook.SaveAsCsv("students.csv", ",");

using IronXL;

// Define the Student class with public string properties
public class Student
{
    public string FirstName { get; set; }
    public string LastName { get; set; }
    public string Email { get; set; }
}

// Create sample data
var students = new List<Student>
{
    new Student { FirstName = "John", LastName = "Smith", Email = "john@example.com" },
    new Student { FirstName = "Jane", LastName = "Doe", Email = "jane@example.com" }
};

WorkBook workBook = WorkBook.Create();
WorkSheet sheet = workBook.DefaultWorkSheet;

// Add header row
sheet["A1"].Value = "FirstName";
sheet["B1"].Value = "LastName";
sheet["C1"].Value = "Email";

// Use foreach to iterate through the list and write each item
int row = 2;
foreach (var item in students)
{
    sheet[$"A{row}"].Value = item.FirstName;
    sheet[$"B{row}"].Value = item.LastName;
    sheet[$"C{row}"].Value = item.Email;
    row++;
}

workBook.SaveAsCsv("students.csv", ",");

Comment convertir un fichier Excel existant en CSV ?

La conversion de feuilles de calcul Excel au format CSV est une exigence courante lorsqu'il s'agit d'intégrer des systèmes existants, de préparer des données pour l'importation de bases de données ou de générer des résultats lisibles par machine à partir de rapports créés par l'homme. IronXL s'occupe de cette conversion avec un minimum de code tout en préservant la précision des données.

using IronXL;

// Load an existing Excel file
WorkBook workBook = WorkBook.Load("Monthly_Report_20251012.xlsx");

// Convert and save as CSV format
workBook.SaveAsCsv("Monthly_Report_20251012.csv");

using IronXL;

// Load an existing Excel file
WorkBook workBook = WorkBook.Load("Monthly_Report_20251012.xlsx");

// Convert and save as CSV format
workBook.SaveAsCsv("Monthly_Report_20251012.csv");

La méthode Load() ouvre les fichiers Excel dans différents formats, y compris XLSX, XLS, XLSM et même les fichiers CSV ou TSV existants. Cette flexibilité vous permet de créer des pipelines d'exportation standardisés qui acceptent les fichiers d'entrée quel que soit leur format d'origine. Consultez la liste complète des formats Excel pris en charge dans la documentation IronXL .

using IronXL;

// Load a multi-sheet workbook (e.g., annual sales by region)
WorkBook workBook = WorkBook.Load("annual_sales.xlsx");

// Export all sheets to CSV -- creates separate files for each sheet
workBook.SaveAsCsv("sales_export.csv");
// Output: sales_export.North.csv, sales_export.South.csv, sales_export.East.csv, etc.

// Or export a specific worksheet
WorkSheet northRegion = workBook.GetWorkSheet("North");
northRegion.SaveAsCsv("north_region_sales.csv");

using IronXL;

// Load a multi-sheet workbook (e.g., annual sales by region)
WorkBook workBook = WorkBook.Load("annual_sales.xlsx");

// Export all sheets to CSV -- creates separate files for each sheet
workBook.SaveAsCsv("sales_export.csv");
// Output: sales_export.North.csv, sales_export.South.csv, sales_export.East.csv, etc.

// Or export a specific worksheet
WorkSheet northRegion = workBook.GetWorkSheet("North");
northRegion.SaveAsCsv("north_region_sales.csv");

Comment exporter un DataTable au format CSV ?

Les applications d'entreprise fonctionnent fréquemment avec des objets DataTable remplis à partir de requêtes de base de données, de réponses d'API ou de traitements de données en mémoire. IronXL for .NET comble le fossé entre ces structures de données .NET et les exportations de fichiers, en fournissant un chemin fiable entre la mémoire de l'application et les fichiers CSV partageables. Cette méthode est plus fiable que l'écriture manuelle de fichiers CSV avec un StreamWriter car IronXL gère automatiquement l'échappement des caractères, la gestion des délimiteurs et l'encodage.

using IronXL;
using System.Data;

// Create and populate a DataTable with columns
DataTable products = new DataTable();
products.Columns.Add("SKU", typeof(string));
products.Columns.Add("ProductName", typeof(string));
products.Columns.Add("Price", typeof(decimal));
products.Columns.Add("InStock", typeof(int));

// Add rows of data
products.Rows.Add("SKU-001", "Wireless Mouse", 29.99m, 150);
products.Rows.Add("SKU-002", "Mechanical Keyboard", 89.99m, 75);
products.Rows.Add("SKU-003", "USB-C Hub", 45.99m, 200);

// Create workbook and transfer DataTable contents
WorkBook workBook = WorkBook.Create();
WorkSheet sheet = workBook.DefaultWorkSheet;

// Add header row from column names
for (int col = 0; col < products.Columns.Count; col++)
{
    sheet.SetCellValue(0, col, products.Columns[col].ColumnName);
}

// Add data rows using nested loops
for (int row = 0; row < products.Rows.Count; row++)
{
    for (int col = 0; col < products.Columns.Count; col++)
    {
        sheet.SetCellValue(row + 1, col, products.Rows[row][col].ToString());
    }
}

// Export to CSV
workBook.SaveAsCsv("product_inventory.csv", ",");

using IronXL;
using System.Data;

// Create and populate a DataTable with columns
DataTable products = new DataTable();
products.Columns.Add("SKU", typeof(string));
products.Columns.Add("ProductName", typeof(string));
products.Columns.Add("Price", typeof(decimal));
products.Columns.Add("InStock", typeof(int));

// Add rows of data
products.Rows.Add("SKU-001", "Wireless Mouse", 29.99m, 150);
products.Rows.Add("SKU-002", "Mechanical Keyboard", 89.99m, 75);
products.Rows.Add("SKU-003", "USB-C Hub", 45.99m, 200);

// Create workbook and transfer DataTable contents
WorkBook workBook = WorkBook.Create();
WorkSheet sheet = workBook.DefaultWorkSheet;

// Add header row from column names
for (int col = 0; col < products.Columns.Count; col++)
{
    sheet.SetCellValue(0, col, products.Columns[col].ColumnName);
}

// Add data rows using nested loops
for (int row = 0; row < products.Rows.Count; row++)
{
    for (int col = 0; col < products.Columns.Count; col++)
    {
        sheet.SetCellValue(row + 1, col, products.Rows[row][col].ToString());
    }
}

// Export to CSV
workBook.SaveAsCsv("product_inventory.csv", ",");

Ce modèle parcourt la structure DataTable, en transférant d'abord les en-têtes de colonnes puis en remplissant systématiquement chaque ligne de données. La propriété DefaultWorkSheet permet un accès rapide à la première feuille de calcul d'un classeur nouvellement créé, éliminant ainsi le besoin de créer explicitement une feuille de calcul dans des scénarios simples.

Comment gérer les délimiteurs personnalisés dans les fichiers CSV ?

Selon les systèmes et les normes régionales, les caractères de délimitation varient. Bien que la virgule soit le séparateur standard dans de nombreux pays, les points-virgules sont souvent préférés dans les régions européennes où les virgules servent de séparateurs décimaux dans les valeurs numériques. Les fichiers séparés par des tabulations (TSV) sont populaires lorsque les données sources contiennent des virgules dans les valeurs des champs. La méthode SaveAsCsv() d'IronXL prend en charge tous ces scénarios sans nécessiter de code supplémentaire pour gérer chaque ligne de sortie.

using IronXL;

WorkBook workBook = WorkBook.Load("data.xlsx");

// Standard comma delimiter (default format)
workBook.SaveAsCsv("output_comma.csv", ",");

// Semicolon delimiter (common in European systems)
workBook.SaveAsCsv("output_semicolon.csv", ";");

// Tab delimiter (TSV format)
workBook.SaveAsCsv("output_tab.tsv", "\t");

// Pipe delimiter (used in some data interchange formats)
workBook.SaveAsCsv("output_pipe.csv", "|");

using IronXL;

WorkBook workBook = WorkBook.Load("data.xlsx");

// Standard comma delimiter (default format)
workBook.SaveAsCsv("output_comma.csv", ",");

// Semicolon delimiter (common in European systems)
workBook.SaveAsCsv("output_semicolon.csv", ";");

// Tab delimiter (TSV format)
workBook.SaveAsCsv("output_tab.tsv", "\t");

// Pipe delimiter (used in some data interchange formats)
workBook.SaveAsCsv("output_pipe.csv", "|");

Le deuxième paramètre de SaveAsCsv() accepte n'importe quelle chaîne de caractères comme délimiteur, offrant une flexibilité totale pour l'intégration avec divers systèmes et exigences régionales. Lors de la génération de fichiers destinés à une distribution internationale, tenez compte des attentes locales du système cible : les systèmes financiers européens attendent souvent une séparation par point-virgule, tandis que les systèmes nord-américains utilisent généralement la virgule par défaut. La norme RFC 4180 pour le format CSV décrit comment les valeurs contenant des délimiteurs doivent être mises entre guillemets afin d'éviter les erreurs d'analyse.

Quelles sont les meilleures pratiques pour la génération de fichiers CSV en C# ?

Lors de la manipulation de fichiers CSV en C#, le respect des bonnes pratiques garantit que vos données restent exactes, lisibles et compatibles avec d'autres systèmes. Le tableau suivant résume les points les plus importants à prendre en compte :

Au-delà des éléments de base, pensez à encoder explicitement lorsque vous ciblez un public international. L'encodage UTF-8 avec BOM est souvent nécessaire pour que les fichiers CSV ouverts dans Microsoft Excel affichent correctement les caractères non ASCII. Pour les exportations à volume élevé impliquant des millions de lignes, envisagez de répartir les données dans plusieurs fichiers plutôt que d'écrire un seul fichier CSV volumineux ; cela permet de maintenir des tailles de fichiers gérables et de réduire la pression sur la mémoire lors de la génération et de la consommation.

Pour les équipes qui créent des pipelines de données, la documentation IronXL sur les processus asynchrones et de flux couvre les modèles de gestion de grands ensembles de données sans avoir à charger des classeurs entiers en mémoire. La bibliothèque d'exemples IronXL inclut des modèles supplémentaires pour le traitement par lots, les tâches d'exportation planifiées et l'intégration avec des frameworks ORM populaires comme Entity Framework.

Lorsque vous travaillez avec les outils de traitement CSV de l'écosystème .NET , comprendre la place IronXL par rapport aux approches de bas niveau vous aide à choisir l'outil adapté à chaque situation. Pour une génération CSV pure sans aucune intervention d'Excel, StreamWriter avec une logique de citation manuelle peut suffire. Pour tout ce qui concerne la compatibilité des formats Excel, l'évaluation des formules ou la mise en forme avancée, IronXL offre une base plus fiable.

Comment lire un fichier CSV existant avec IronXL?

La réimportation des données CSV dans votre application suit le même schéma que le chargement de tout autre format de feuille de calcul. La méthode Load() d'IronXL reconnaît les fichiers CSV et les analyse selon le modèle standard classeur/feuille de calcul, vous donnant accès aux cellules et plages individuelles en utilisant la même API que celle utilisée pour les fichiers Excel.

using IronXL;

// Load an existing CSV file
WorkBook workBook = WorkBook.Load("employees.csv");
WorkSheet sheet = workBook.DefaultWorkSheet;

// Access specific cells by reference
string firstHeader = sheet["A1"].StringValue;

// Iterate through all rows
foreach (var row in sheet.Rows)
{
    foreach (var cell in row)
    {
        Console.Write(cell.StringValue + "\t");
    }
    Console.WriteLine();
}

// Access a range of cells
var nameColumn = sheet["B2:B100"];
foreach (var cell in nameColumn)
{
    Console.WriteLine(cell.StringValue);
}

using IronXL;

// Load an existing CSV file
WorkBook workBook = WorkBook.Load("employees.csv");
WorkSheet sheet = workBook.DefaultWorkSheet;

// Access specific cells by reference
string firstHeader = sheet["A1"].StringValue;

// Iterate through all rows
foreach (var row in sheet.Rows)
{
    foreach (var cell in row)
    {
        Console.Write(cell.StringValue + "\t");
    }
    Console.WriteLine();
}

// Access a range of cells
var nameColumn = sheet["B2:B100"];
foreach (var cell in nameColumn)
{
    Console.WriteLine(cell.StringValue);
}

Cette cohérence entre les opérations de lecture et d'écriture signifie que votre équipe n'a besoin d'apprendre qu'une seule API pour toutes les tâches liées aux feuilles de calcul. La même méthode WorkBook.Load() qui ouvre les fichiers CSV gère également les formats XLSX, XLS et XLSM -- utile lors de la construction de pipelines qui acceptent des entrées dans plusieurs formats. Pour en savoir plus sur la lecture des fichiers CSV avec IronXL , consultez la documentation.

Quelles sont vos prochaines étapes ?

Ce guide a abordé les principaux modèles de création et de gestion de fichiers CSV à l'aide IronXL en C# :

• WorkBook.Create() pour initialiser de nouvelles feuilles de calcul en mémoire
• WorkBook.Load() pour ouvrir les fichiers Excel et CSV existants dans n'importe quel format pris en charge
• SaveAsCsv() pour l'exportation de données avec des délimiteurs personnalisables
• Exportation individuelle des feuilles de calcul à l'aide de GetWorkSheet() pour des conversions ciblées
• DataTable Modèles d'itération pour les flux de travail de conversion de base de données en CSV
• Exportation de la liste d'objets à l'aide des boucles foreach
• Réintégrer des données CSV dans votre application avec un accès complet

Pour mettre ces techniques en pratique, commencez un essai gratuit IronXL pour explorer toute la gamme des fonctionnalités du tableur sans limite de temps pour les tests. Lorsque vous serez prêt pour le déploiement en production, consultez les options de licence IronXL afin de trouver le plan adapté à la taille de votre équipe et à vos besoins d'utilisation.

Pour des exemples supplémentaires couvrant des scénarios avancés tels que la mise en forme des cellules, la création de formules, la génération de graphiques et la protection par mot de passe, consultez la documentation IronXL et la bibliothèque complète d'exemples de code . La série de tutoriels IronXL détaille des scénarios d'intégration plus complexes, notamment les exportations de DataTable , les conversions de format et l'écriture dans des fichiers CSV .