Tutoriel sur le lecteur de fichiers CSV en C# : Analyser et convertir des données CSV avec IronXL

Pourquoi choisir IronXL pour la lecture de fichiers CSV ?

IronXL transforme la lecture des fichiers CSV, véritable casse-tête d'analyse, en opérations simples. Contrairement aux opérations de fractionnement manuelles ou aux nouvelles approches StreamReader de base, IronXL gère automatiquement les cas particuliers tels que les virgules imbriquées, les sauts de ligne et les colonnes séparées par des délimiteurs inhabituels.

Cette bibliothèque fonctionne indépendamment de Microsoft Office, ce qui la rend idéale pour les environnements serveur et les déploiements cloud. Que ce soit sur Windows, Linux, macOS , Azure ou AWS, IronXL offre des résultats constants sur toutes les plateformes. Cette compatibilité multiplateforme, associée à son API intuitive, en fait le choix idéal pour les applications C# modernes nécessitant une analyse CSV fiable.

IronXL traite les fichiers CSV au même titre que les formats Excel, permettant ainsi une transition fluide entre les types de fichiers sans perte de données ni problème de format. Au-delà de la simple lecture de fichiers CSV, IronXL est également capable d'utiliser C# pour écrire des fichiers CSV à partir de zéro. N'hésitez pas à consulter notre guide pratique pour en savoir plus. Cela en fait la bibliothèque idéale pour tous vos besoins en matière de fichiers CSV, capable de tout faire, de la lecture et la création de fichiers CSV à leur conversion vers n'importe quel format pris en charge.

Premiers pas : Installation d'IronXL

L'installation d'IronXL ne prend que quelques instants via le gestionnaire de packages NuGet de Visual Studio. Ouvrez votre projet, cliquez avec le bouton droit sur Références dans l'Explorateur de solutions et sélectionnez " Gérer les packages NuGet ". Recherchez " IronXL.Excel " et cliquez sur " Installer ".

Tutoriel sur la lecture de fichiers CSV en C# : analyser et convertir des données CSV avec IronXL : Image 1 - Installation du package NuGet d'IronXL

Pour obtenir des instructions d'installation détaillées, consultez la documentation d'installation d'IronXL .

Une fois installé, la lecture de votre premier fichier CSV nécessite un minimum de code source , comme le montre l'exemple suivant :

using IronXL;
// Load CSV file
WorkBook workbook = WorkBook.LoadCSV("data.csv");
WorkSheet sheet = workbook.DefaultWorkSheet;
// Read a specific cell
string cellValue = sheet["A1"].StringValue;
// Iterate through rows
foreach (var row in sheet.Rows)
{
    foreach (var cell in row)
    {
        Console.WriteLine(cell.StringValue);
    }
}

using IronXL;
// Load CSV file
WorkBook workbook = WorkBook.LoadCSV("data.csv");
WorkSheet sheet = workbook.DefaultWorkSheet;
// Read a specific cell
string cellValue = sheet["A1"].StringValue;
// Iterate through rows
foreach (var row in sheet.Rows)
{
    foreach (var cell in row)
    {
        Console.WriteLine(cell.StringValue);
    }
}

Imports IronXL

' Load CSV file
Dim workbook As WorkBook = WorkBook.LoadCSV("data.csv")
Dim sheet As WorkSheet = workbook.DefaultWorkSheet
' Read a specific cell
Dim cellValue As String = sheet("A1").StringValue
' Iterate through rows
For Each row In sheet.Rows
    For Each cell In row
        Console.WriteLine(cell.StringValue)
    Next
Next

Dans cet exemple, le lecteur var accède aux données CSV sous forme de tableaux de chaînes de caractères. La méthode WorkBook.LoadCSV gère l'identification de l'en-tête, crée une nouvelle table de données et effectue une analyse syntaxique économe en mémoire, simplifiant ainsi la gestion de votre structure de données.

Tutoriel C# sur la lecture de fichiers CSV : analyser et convertir des données CSV avec IronXL : Image 2 - Exemple de sortie pour démarrer

Comment lire des données à partir de fichiers CSV avec différents délimiteurs ?

Dans la réalité, les fichiers CSV n'utilisent pas toujours de virgules. Les points-virgules, les barres verticales et les tabulations sont des alternatives courantes, notamment dans les ensembles de données internationaux où les virgules servent de séparateurs décimaux. IronXL gère avec élégance tous les délimiteurs grâce à ses options de chargement flexibles.

using IronXL;
// Load CSV with semicolon delimiter
WorkBook workbook = WorkBook.LoadCSV("european-data.csv",
    fileFormat: ExcelFileFormat.XLSX,
    listDelimiter: ";");
// Load tab-separated values
WorkBook tsvWorkbook = WorkBook.LoadCSV("export_data.tsv",
    fileFormat: ExcelFileFormat.XLSX,
    listDelimiter: "\t");
// Access data normally
WorkSheet sheet = workbook.DefaultWorkSheet;
decimal totalSales = sheet["B2:B10"].Sum();

using IronXL;
// Load CSV with semicolon delimiter
WorkBook workbook = WorkBook.LoadCSV("european-data.csv",
    fileFormat: ExcelFileFormat.XLSX,
    listDelimiter: ";");
// Load tab-separated values
WorkBook tsvWorkbook = WorkBook.LoadCSV("export_data.tsv",
    fileFormat: ExcelFileFormat.XLSX,
    listDelimiter: "\t");
// Access data normally
WorkSheet sheet = workbook.DefaultWorkSheet;
decimal totalSales = sheet["B2:B10"].Sum();

Imports IronXL
' Load CSV with semicolon delimiter
Dim workbook As WorkBook = WorkBook.LoadCSV("european-data.csv", fileFormat:=ExcelFileFormat.XLSX, listDelimiter:=";")
' Load tab-separated values
Dim tsvWorkbook As WorkBook = WorkBook.LoadCSV("export_data.tsv", fileFormat:=ExcelFileFormat.XLSX, listDelimiter:=vbTab)
' Access data normally
Dim sheet As WorkSheet = workbook.DefaultWorkSheet
Dim totalSales As Decimal = sheet("B2:B10").Sum()

Le paramètre listDelimiter accepte n'importe quelle chaîne de caractères, offrant un contrôle total sur le comportement d'analyse. IronXL préserve les valeurs des colonnes et les types de données lors de l'analyse. Les valeurs numériques restent des nombres, les dates restent des objets DateTime et les formules conservent leurs relations. Cette préservation automatique des types élimine le code de conversion manuel et réduit les erreurs.

Pour les fichiers présentant une mise en forme incohérente, la gestion des erreurs d'IronXL traite avec élégance les lignes malformées sans plantage, en consignant les problèmes pour examen tout en continuant à traiter les données valides.

Tutoriel C# sur la lecture de fichiers CSV : analyser et convertir des données CSV avec IronXL : Image 3 - Sortie pour la lecture de différents délimiteurs

Comment analyser des données CSV et les convertir en objets C# ?

Transformer les lignes CSV en objets fortement typés simplifie le traitement des données et permet les opérations LINQ. IronXL simplifie ce mappage grâce à ses méthodes d'accès aux cellules . Le code suivant montre comment créer un analyseur CSV simple pour gérer cela :

using IronXL;
public class Product
{
    public string Name { get; set; }
    public decimal Price { get; set; }
    public int Stock { get; set; }
    public DateTime? LastUpdated { get; set; }
}
class Program
{
    static void Main(string[] args)
    {
        // Parse CSV into objects
        var products = new List<Product>();
        WorkBook workbook = WorkBook.LoadCSV("inventory.csv");
        WorkSheet sheet = workbook.DefaultWorkSheet;
        // Skip first line (header), parse remaining lines
        for (int row = 2; row <= sheet.RowCount; row++)
        {
            products.Add(new Product
            {
                Name = sheet[$"A{row}"].StringValue,
                Price = sheet[$"B{row}"].DecimalValue,
                Stock = sheet[$"C{row}"].IntValue,
                LastUpdated = sheet[$"D{row}"].DateTimeValue
            });
        }
        // Use LINQ for analysis
        var lowStock = products.Where(p => p.Stock < 10).ToList();
    }
}

using IronXL;
public class Product
{
    public string Name { get; set; }
    public decimal Price { get; set; }
    public int Stock { get; set; }
    public DateTime? LastUpdated { get; set; }
}
class Program
{
    static void Main(string[] args)
    {
        // Parse CSV into objects
        var products = new List<Product>();
        WorkBook workbook = WorkBook.LoadCSV("inventory.csv");
        WorkSheet sheet = workbook.DefaultWorkSheet;
        // Skip first line (header), parse remaining lines
        for (int row = 2; row <= sheet.RowCount; row++)
        {
            products.Add(new Product
            {
                Name = sheet[$"A{row}"].StringValue,
                Price = sheet[$"B{row}"].DecimalValue,
                Stock = sheet[$"C{row}"].IntValue,
                LastUpdated = sheet[$"D{row}"].DateTimeValue
            });
        }
        // Use LINQ for analysis
        var lowStock = products.Where(p => p.Stock < 10).ToList();
    }
}

Imports IronXL

Public Class Product
    Public Property Name As String
    Public Property Price As Decimal
    Public Property Stock As Integer
    Public Property LastUpdated As DateTime?
End Class

Class Program
    Shared Sub Main(ByVal args As String())
        ' Parse CSV into objects
        Dim products As New List(Of Product)()
        Dim workbook As WorkBook = WorkBook.LoadCSV("inventory.csv")
        Dim sheet As WorkSheet = workbook.DefaultWorkSheet
        ' Skip first line (header), parse remaining lines
        For row As Integer = 2 To sheet.RowCount
            products.Add(New Product With {
                .Name = sheet($"A{row}").StringValue,
                .Price = sheet($"B{row}").DecimalValue,
                .Stock = sheet($"C{row}").IntValue,
                .LastUpdated = sheet($"D{row}").DateTimeValue
            })
        Next
        ' Use LINQ for analysis
        Dim lowStock = products.Where(Function(p) p.Stock < 10).ToList()
    End Sub
End Class

Les propriétés de valeur typées d'IronXL (StringValue, DecimalValue, IntValue, DateTimeValue) gèrent les conversions en toute sécurité, en renvoyant des valeurs par défaut pour les données invalides plutôt que de lever des exceptions. Cela évite un travail manuel fastidieux, comme la création d'une nouvelle chaîne de caractères pour chaque propriété après l'analyse. Cette approche défensive garantit des applications robustes qui gèrent les données imparfaites avec élégance.

La bibliothèque prend également en charge les types nullables et la logique d'analyse personnalisée en cas de besoin, permettant ainsi de s'adapter à des règles métier complexes sans sacrifier la simplicité.

Tutoriel C# sur la lecture de fichiers CSV : analyser et convertir des données CSV avec IronXL : Image 4 - Analyse des données CSV générées

Comment convertir un fichier CSV au format Excel ?

De nombreux processus métier nécessitent des données CSV au format Excel pour des analyses avancées, une mise en forme ou une distribution aux parties prenantes. IronXL simplifie considérablement cette conversion tout en préservant l'intégrité des données.

// Load CSV file
WorkBook csvWorkbook = WorkBook.LoadCSV("monthly-report.csv");
// Save as Excel with single method call
csvWorkbook.SaveAs("monthly-report.xlsx");
// Add formatting before saving
WorkSheet sheet = csvWorkbook.DefaultWorkSheet;
sheet["A1:D1"].Style.Font.Bold = true;
sheet["B:B"].FormatString = "$#,##0.00";  // Currency format

// Load CSV file
WorkBook csvWorkbook = WorkBook.LoadCSV("monthly-report.csv");
// Save as Excel with single method call
csvWorkbook.SaveAs("monthly-report.xlsx");
// Add formatting before saving
WorkSheet sheet = csvWorkbook.DefaultWorkSheet;
sheet["A1:D1"].Style.Font.Bold = true;
sheet["B:B"].FormatString = "$#,##0.00";  // Currency format

' Load CSV file
Dim csvWorkbook As WorkBook = WorkBook.LoadCSV("monthly-report.csv")
' Save as Excel with single method call
csvWorkbook.SaveAs("monthly-report.xlsx")
' Add formatting before saving
Dim sheet As WorkSheet = csvWorkbook.DefaultWorkSheet
sheet("A1:D1").Style.Font.Bold = True
sheet("B:B").FormatString = "$#,##0.00"  ' Currency format

La conversion préserve la précision numérique, les formats de date et les caractères spéciaux qui posent souvent problème avec les méthodes de conversion manuelles. IronXL optimise automatiquement la structure du fichier Excel résultant, créant ainsi des fichiers efficaces qui s'ouvrent rapidement même avec de grands ensembles de données.

Cette capacité de conversion transparente permet des flux de production de rapports automatisés où les données CSV provenant de diverses sources se transforment en rapports Excel soignés, prêts à être examinés par la direction.

Tutoriel sur la lecture de fichiers CSV en C# : analyser et convertir des données CSV avec IronXL : Image 5 - Conversion d'un fichier CSV au format Excel

Meilleures pratiques et fonctionnalités avancées

IronXL intègre plusieurs améliorations avancées qui améliorent la fiabilité du traitement des fichiers CSV. La bibliothèque gère automatiquement différents encodages de texte ( UTF-8, UTF-16, ASCII ), garantissant ainsi un affichage correct des valeurs de chaînes internationales et des colonnes. Le traitement de flux économe en mémoire permet de traiter les fichiers CSV volumineux sans charger simultanément toutes les données dans la RAM.

Lors du traitement de fichiers CSV provenant de sources non fiables, enveloppez les opérations dans des blocs try-catch (Exception ex) pour plus de sécurité. Pour des stratégies complètes de gestion des erreurs, consultez les guides de dépannage d'IronXL .

Pour des performances optimales avec de grands ensembles de données, utilisez des opérations de plage (feuille["A1:Z1000"]) au lieu d'accéder aux lignes individuelles du tableau de données ou à une colonne de chaîne entière cellule par cellule. Le moteur de formules d'IronXL fonctionne également avec les données CSV, permettant ainsi d'effectuer des calculs sans conversion préalable au format Excel. La compatibilité multiplateforme de la bibliothèque va bien au-delà de la simple compatibilité de base. Les conteneurs Docker, les serveurs Linux et les fonctions cloud exécutent tous IronXL sans modification de configuration, ce qui le rend idéal pour les architectures de microservices.

La prise en charge multiplateforme de la bibliothèque va au-delà de la simple compatibilité. Les conteneurs Docker, les serveurs Linux et les fonctions cloud exécutent tous IronXL sans modification de configuration, ce qui le rend idéal pour les architectures de microservices.

Conclusion

IronXL transforme la lecture des fichiers CSV en C#, une tâche fastidieuse, en une solution fiable et adaptée aux entreprises. Ses capacités d'analyse automatique des fichiers CSV, de gestion des structures de données et de conversion Excel transparente en font le choix idéal pour les développeurs manipulant des fichiers CSV, des datatables dt ou des données CSV dans des applications .NET modernes.

Prêt à optimiser le traitement de vos fichiers CSV ? Procurez-vous IronXL dès aujourd'hui et bénéficiez d'une gestion des données de niveau entreprise dans vos applications.