Bibliothèque CSV C# : Tutoriel complet en utilisant IronXL

Comment configurer une bibliothèque de feuilles de calcul C# ?

L'installation IronXL via NuGet prend moins d'une minute. Ouvrez la console du gestionnaire de packages dans Visual Studio et exécutez la commande ci-dessous, ou utilisez l'interface de ligne de commande .NET depuis n'importe quel terminal :

Install-Package IronXL
dotnet add package IronXL

Install-Package IronXL
dotnet add package IronXL

Une fois le package installé, ajoutez l'espace de noms à tous les fichiers dans lesquels vous souhaitez travailler avec des données de type tableur :

using IronXL;

using IronXL;

IronXL cible .NET Framework 4.6.2+ et toutes les versions modernes de .NET (Core, 5, 6, 7, 8, 9 et 10). Il fonctionne sous Windows, Linux et macOS, ce qui le rend adapté aussi bien aux outils de bureau qu'aux charges de travail de serveurs conteneurisés. Consultez le guide d'installation IronXL pour obtenir des instructions étape par étape concernant les sources des packages et l'activation de la licence.

Comment lire des fichiers CSV en C# ?

La lecture d'un fichier CSV avec IronXL suit le même schéma que le chargement de n'importe quelle feuille de calcul. Appelez WorkBook.Load avec le chemin du fichier et IronXL déduira le format de l'extension ; aucune configuration supplémentaire n'est requise :

// Load a CSV file into a WorkBook
WorkBook workBook = WorkBook.Load("sales_data.csv");

// Access the default worksheet
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Read individual cells by Excel-style address
string customerName = workSheet["A2"].StringValue;
decimal orderAmount = workSheet["B2"].DecimalValue;

// Iterate rows, starting at index 1 to skip the header
for (int i = 1; i < workSheet.Rows.Count(); i++)
{
    var row = workSheet.Rows[i];
    Console.WriteLine($"Customer: {row.Columns[0].Value}, Amount: {row.Columns[1].Value}");
}

// Load a CSV file into a WorkBook
WorkBook workBook = WorkBook.Load("sales_data.csv");

// Access the default worksheet
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Read individual cells by Excel-style address
string customerName = workSheet["A2"].StringValue;
decimal orderAmount = workSheet["B2"].DecimalValue;

// Iterate rows, starting at index 1 to skip the header
for (int i = 1; i < workSheet.Rows.Count(); i++)
{
    var row = workSheet.Rows[i];
    Console.WriteLine($"Customer: {row.Columns[0].Value}, Amount: {row.Columns[1].Value}");
}

L'objet WorkBook expose le modèle complet de la feuille de calcul. Vous accédez aux cellules avec une notation Excel familière telle que "A2", et les propriétés de conversion intégrées -- StringValue, DecimalValue, IntValue, DateTimeValue -- gèrent la conversion de type afin que vous n'ayez pas à analyser les chaînes manuellement.

// Access a range and print each value
foreach (var cell in workSheet["A2:C10"])
{
    Console.WriteLine($"{cell.AddressString}: {cell.Value}");
}

// Access a range and print each value
foreach (var cell in workSheet["A2:C10"])
{
    Console.WriteLine($"{cell.AddressString}: {cell.Value}");
}

public record SalesRecord(string Customer, decimal Amount, DateTime OrderDate);

WorkBook workBook = WorkBook.Load("sales_data.csv");
WorkSheet workSheet = workBook.DefaultWorkSheet;

var records = new List<SalesRecord>();

// Start at row 1 to skip the header row (row 0)
for (int i = 1; i < workSheet.Rows.Count(); i++)
{
    var row = workSheet.Rows[i];
    records.Add(new SalesRecord(
        Customer: row.Columns[0].StringValue,
        Amount: row.Columns[1].DecimalValue,
        OrderDate: row.Columns[2].DateTimeValue
    ));
}

public record SalesRecord(string Customer, decimal Amount, DateTime OrderDate);

WorkBook workBook = WorkBook.Load("sales_data.csv");
WorkSheet workSheet = workBook.DefaultWorkSheet;

var records = new List<SalesRecord>();

// Start at row 1 to skip the header row (row 0)
for (int i = 1; i < workSheet.Rows.Count(); i++)
{
    var row = workSheet.Rows[i];
    records.Add(new SalesRecord(
        Customer: row.Columns[0].StringValue,
        Amount: row.Columns[1].DecimalValue,
        OrderDate: row.Columns[2].DateTimeValue
    ));
}

Comment écrire des fichiers CSV en C# ?

La création d'un fichier CSV à partir de zéro implique trois étapes : créer un WorkBook, remplir un WorkSheet et appeler SaveAsCsv. Le processus est identique à la manière dont vous créeriez n'importe quelle feuille de calcul, ce qui garantit la cohérence de l'API quel que soit le format de sortie :

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

// Write header row
workSheet["A1"].Value = "Product";
workSheet["B1"].Value = "Quantity";
workSheet["C1"].Value = "Price";

// Write data rows
workSheet["A2"].Value = "Widget A";
workSheet["B2"].Value = 250;
workSheet["C2"].Value = 9.99;

workSheet["A3"].Value = "Gadget B";
workSheet["B3"].Value = 120;
workSheet["C3"].Value = 24.50;

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

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

// Write header row
workSheet["A1"].Value = "Product";
workSheet["B1"].Value = "Quantity";
workSheet["C1"].Value = "Price";

// Write data rows
workSheet["A2"].Value = "Widget A";
workSheet["B2"].Value = 250;
workSheet["C2"].Value = 9.99;

workSheet["A3"].Value = "Gadget B";
workSheet["B3"].Value = 120;
workSheet["C3"].Value = 24.50;

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

SaveAsCsv gère le placement du délimiteur, la mise entre guillemets des champs contenant des virgules et la normalisation des sauts de ligne. Vous n'avez rien à gérer manuellement. IronXL préserve les types numériques lors de l'exportation afin que les outils en aval tels qu'Excel ou pandas lisent les nombres comme des nombres, et non comme des chaînes de texte entre guillemets.

DataTable dataTable = GetProductsFromDatabase();

WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.CreateWorkSheet("products");

workSheet.InsertDataTable(dataTable, "A1");

workBook.SaveAsCsv("products.csv");

DataTable dataTable = GetProductsFromDatabase();

WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.CreateWorkSheet("products");

workSheet.InsertDataTable(dataTable, "A1");

workBook.SaveAsCsv("products.csv");

Comment convertir des fichiers CSV en fichiers Excel et inversement en C# ?

L'une des fonctionnalités les plus précieuses d' IronXL est la conversion bidirectionnelle entre les formats CSV et Excel. L'API est symétrique -- Load lit n'importe quel format pris en charge, et la famille de méthodes Save écrit dans votre format cible :

// Convert CSV to Excel
WorkBook csvWorkBook = WorkBook.Load("data.csv");
csvWorkBook.SaveAs("data.xlsx");

// Convert Excel back to CSV
WorkBook xlsxWorkBook = WorkBook.Load("report.xlsx");
xlsxWorkBook.SaveAsCsv("report.csv");

// Convert CSV to Excel
WorkBook csvWorkBook = WorkBook.Load("data.csv");
csvWorkBook.SaveAs("data.xlsx");

// Convert Excel back to CSV
WorkBook xlsxWorkBook = WorkBook.Load("report.xlsx");
xlsxWorkBook.SaveAsCsv("report.csv");

Ces conversions préservent l'intégrité des données. Les valeurs numériques restent numériques, les champs de date conservent leur type et les résultats des formules sont évalués à leurs valeurs calculées avant d'être enregistrés. Lorsque vous convertissez un fichier Excel multi-feuilles au format CSV, IronXL crée automatiquement un fichier CSV distinct pour chaque feuille de calcul :

WorkBook multiSheetWorkBook = WorkBook.Load("quarterly_report.xlsx");

// Produces: quarterly_report.Sheet1.csv, quarterly_report.Sheet2.csv, etc.
multiSheetWorkBook.SaveAsCsv("quarterly_report.csv");

WorkBook multiSheetWorkBook = WorkBook.Load("quarterly_report.xlsx");

// Produces: quarterly_report.Sheet1.csv, quarterly_report.Sheet2.csv, etc.
multiSheetWorkBook.SaveAsCsv("quarterly_report.csv");

Ce comportement est particulièrement utile pour les processus de reporting où les utilisateurs en aval attendent un sujet par fichier. Le tutoriel sur l'écriture CSV aborde des options supplémentaires, comme la spécification du délimiteur et le contrôle des feuilles incluses dans l'exportation.

Comment utiliser une bibliothèque CSV C# pour lire et écrire des fichiers : Figure 3 - Fichier Excel multipage enregistré sous forme de fichiers CSV séparés.

Commencez avec IronXL maintenant.

Commencer gratuitement

Pourquoi les bibliothèques basées uniquement sur le format CSV sont-elles insuffisantes pour les projets réels ?

De nombreux développeurs C# commencent par CsvHelper ou leTextFieldParser de Microsoft.VisualBasic. Ce sont deux outils performants pour les flux de travail utilisant exclusivement des fichiers CSV. Le problème apparaît lorsque les exigences évoluent : un intervenant demande un téléchargement Excel au lieu d'un fichier CSV, le service financier a besoin que les formules soient conservées ou la politique de sécurité exige des fichiers protégés par mot de passe. À ce stade, une bibliothèque compatible uniquement avec les fichiers CSV vous oblige à ajouter une seconde dépendance et à maintenir deux chemins d'intégration distincts. Une bibliothèque de feuilles de calcul unifiée élimine cette séparation dès le départ.

Quelles sont vos prochaines étapes ?

IronXL vous offre une API unique et cohérente pour la lecture, l'écriture et la conversion de fichiers CSV et Excel dans n'importe quelle application .NET 10. Les principaux avantages sont simples : aucune dépendance à Office, compatibilité multiplateforme, saisie robuste des valeurs de cellules et passage direct des projets utilisant uniquement le format CSV à une fonctionnalité complète de tableur dès que les besoins évoluent.

Lorsque vous serez prêt à approfondir le sujet, commencez par les thèmes les plus pertinents pour votre projet actuel. Si vous travaillez principalement avec des pipelines d'importation CSV, les modèles de lecture et de mappage présentés ci-dessus couvrent la majorité des scénarios réels. Si vos exigences de sortie varient (parfois CSV pour les scripts en aval, parfois XLSX pour les utilisateurs finaux), la section sur la conversion de format montre comment fournir les deux avec une seule base de code.

Pour les équipes qui créent des systèmes de reporting ou exportent des résultats de bases de données, l'approche InsertDataTable s'adapte bien et évite la surcharge de performance de l'affectation de cellules ligne par ligne. Associez cela à la mise en forme des cellules pour produire des rapports que les utilisateurs peuvent ouvrir directement dans Excel sans reformatage.

Pour aller de l'avant, suivez ces étapes :

1. Installez la bibliothèque via NuGet en utilisant Install-Package IronXL ou dotnet add package IronXL.
2. Suivez le guide de démarrage rapide d' IronXL pour charger votre premier fichier CSV.
3. Explorez la conversion de format avec le tutoriel CSV vers Excel lorsque vous avez besoin des deux formats dans le même projet.
4. Consultez la documentation de l'API dans la section Référence des objets IronXL pour obtenir des informations sur les opérations avancées sur les cellules, la prise en charge des formules et le style.
5. Démarrez un essai gratuit sur la page de licence d'essai IronXL – aucune carte de crédit requise, assistance technique incluse.

Si vous évaluez les options en parallèle avec d'autres outils Iron Software , la Suite de produits IronSoftware couvre la génération de PDF avec IronPDF , la lecture de codes-barres, l'OCR et bien plus encore – le tout partageant le même modèle de licence et le même canal de support.