C# Enregistrer en CSV en utilisant IronXL

Sortie

C# Save to CSV Using IronXL : Image 2 - CSV Output

Les références de cellules telles que sheet["A1"] permettent d'accéder directement à des cellules spécifiques auxquelles des valeurs peuvent être attribuées. IronXL accepte divers types de données, notamment les chaînes, les entiers, les décimales, les dates et les valeurs booléennes, en gérant automatiquement le format approprié pour chaque type. Pour des scénarios de saisie de données plus complexes, explorez le travail avec les plages Excel et les opérations de masse.

La méthode SaveAsCsv() exporte le contenu CSV de la feuille de calcul vers un fichier. Le premier paramètre spécifie le nom du fichier de sortie et le chemin d'accès, et le second paramètre définit le caractère de délimitation. IronXL gère automatiquement le formatage approprié, y compris l'échappement des caractères spéciaux qui pourraient autrement briser l'analyse CSV et maintenir l'intégrité des données tout au long du processus d'exportation.

Comment exporter une liste d'objets au format CSV?

Lorsque vous travaillez avec des objets fortement typés, vous pouvez utiliser une boucle foreach pour parcourir une nouvelle liste et écrire chaque élément sur la feuille de calcul. Voici un exemple utilisant une classe Student avec des propriétés publiques de type string :

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; }
}
// In your program class or method
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; }
}
// In your program class or method
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", ",");

Ce modèle montre comment exporter des objets de liste vers des données CSV en itérant à travers chaque élément et en mappant ses propriétés à des colonnes spécifiques. La boucle foreach traite chaque étudiant de la collection et l'interpolation de chaînes construit les références de cellules de manière dynamique.

Entrée

C# Enregistrer en CSV en utilisant IronXL : Image 3 - Exemple d'entrée Excel

Sortie

C# Save to CSV Using IronXL : Image 4 - Excel to CSV Output

L'une des caractéristiques remarquables d'IronXL lors de la conversion est l'évaluation automatique des formules. Lors de l'enregistrement au format CSV, IronXL calcule toutes les formules présentes dans la feuille de calcul et exporte les valeurs résultantes plutôt que le texte de la formule. Par exemple, une cellule contenant =SUM(A1:A10) serait exportée en tant que total calculé, garantissant que le fichier CSV contient des données exploitables que les systèmes en aval peuvent immédiatement utiliser.

Comment fonctionne l'exportation de plusieurs feuilles ? Lorsque vous travaillez avec des classeurs Excel contenant plusieurs feuilles de calcul, IronXL crée automatiquement des fichiers CSV distincts pour chaque feuille. Cette capacité est particulièrement précieuse pour les rapports financiers, les données de ventes régionales ou tout scénario dans lequel chaque département ou catégorie occupe sa propre feuille de calcul au sein d'un seul classeur principal. ```cs 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 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"); ``` La convention de dénomination ajoute le nom de chaque feuille de calcul au nom du fichier de base, ce qui facilite l'identification de la source de chaque fichier exporté lors du traitement ou de l'archivage. Pour les exportations ciblées où seules des feuilles de calcul spécifiques sont nécessaires, récupérez la feuille de calcul souhaitée à l'aide de `GetWorkSheet()` et appelez `SaveAsCsv()` directement sur cet objet feuille. Pour en savoir plus sur [la conversion entre les formats Excel](/csharp/excel/how-to/csharp-convert-xlsx-to-csv/), consultez la documentation IronXL. ## Comment exporter une table de données au format CSV? Les applications d'entreprise utilisent fréquemment des objets `DataTable` alimentés par des requêtes de base de données, des réponses d'API ou des 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 robuste que l'écriture manuelle de fichiers CSV avec une approche `var` writer ou l'utilisation d'un nouveau `StreamWriter`. ```cs 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 a loop 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 and save to the specified path workBook.SaveAsCsv("product_inventory.csv", ","); ``` Ce modèle itère à travers la structure `DataTable`, en transférant d'abord les en-têtes de colonne, puis en remplissant systématiquement chaque ligne de données. La propriété `DefaultWorkSheet` permet d'accéder rapidement à la première feuille de calcul d'un classeur nouvellement créé, éliminant ainsi la nécessité de créer explicitement une feuille de calcul dans des scénarios simples. Par défaut, la méthode traite toutes les lignes dans l'ordre. ### Sortie [C# Save to CSV Using IronXL : Image 5 - DataTable to CSV Output](/static-assets/excel/blog/csharp-csv-reader/csharp-csv-reader-5.webp) IronXL préserve les types de données au cours du processus de transfert, en veillant à ce que les valeurs numériques conservent leur précision et les dates leur formatage. Cette approche s'adapte bien aux [Tables de données de toute taille](/csharp/excel/how-to/csharp-datable-to-csv/), qu'elles contiennent des dizaines de lignes provenant d'une simple requête de recherche ou des milliers d'enregistrements provenant d'exportations de données complètes. Pour une manipulation supplémentaire de la feuille de calcul avant l'exportation, explorez les options de formatage des cellules et les [opérations de plage](/csharp/excel/tutorials/how-to-read-excel-file-csharp/). ## 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 s'adapte à tous ces scénarios sans nécessiter de code supplémentaire pour traiter chaque ligne de sortie. ```cs 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, ce qui offre une flexibilité totale pour l'intégration avec divers systèmes et exigences régionales. Lorsque vous créez des fichiers pour une distribution internationale, tenez compte des paramètres linguistiques du système cible : les systèmes financiers européens exigent souvent une séparation par points-virgules, tandis que les systèmes nord-américains utilisent généralement des virgules par défaut. ## Bonnes pratiques Lorsque vous travaillez avec des fichiers CSV en C#, le respect des meilleures pratiques garantit que vos données restent précises, lisibles et compatibles avec d'autres systèmes. Voici quelques lignes directrices essentielles : * Délimiteurs cohérents : Utilisez toujours un délimiteur cohérent, tel qu'une virgule ou un point-virgule, dans votre fichier CSV. Cela permet d'éviter les erreurs d'analyse lors de l'importation ou de l'exportation de données. * Citation de valeurs spéciales : Si les valeurs de vos données contiennent des virgules, des guillemets ou d'autres caractères spéciaux, mettez-les entre guillemets doubles pour préserver l'intégrité de vos données CSV. * Formats de date et d'heure : Utilisez un format de date et d'heure cohérent dans vos fichiers CSV afin d'éviter toute confusion et d'assurer la compatibilité avec d'autres applications. * Éviter les retours à la ligne dans les valeurs : Évitez d'inclure des caractères de nouvelle ligne dans les valeurs, car ils peuvent perturber la structure des lignes et causer des problèmes de formatage. * Exploiter les bibliothèques : Utilisez des bibliothèques telles que CsvHelper pour simplifier la lecture et l'écriture de fichiers CSV. CsvHelper gère de nombreuses complexités du format CSV, telles que l'échappement, les guillemets et les délimiteurs personnalisés. * Traitement des fichiers : Vérifiez toujours si le fichier existe avant d'écrire, et gérez les exceptions avec élégance. Utilisez l'instruction `using` pour vous assurer que les flux de fichiers sont correctement fermés et éliminés après utilisation. Par exemple, vous pouvez démarrer un nouveau projet dans Visual Studio, installer le package NuGet CsvHelper et utiliser la classe `CsvWriter` pour écrire des données dans un fichier CSV. Définissez une classe Étudiant avec des propriétés telles que Prénom et Nom, puis exportez une liste d'objets Étudiant vers un fichier CSV à l'aide de la classe `CsvWriter`. Cette approche permet non seulement de rationaliser votre flux de travail, mais aussi de réduire le risque d'erreurs, en veillant à ce que vos fichiers CSV soient bien structurés et prêts à être utilisés dans n'importe quelle application. ## Conclusion La création et l'exportation de fichiers CSV en C# deviennent remarquablement efficaces avec IronXL. Qu'il s'agisse de générer de nouveaux fichiers remplis de données structurées ou de convertir des classeurs Excel complexes à feuilles multiples, la bibliothèque fournit une API propre et intuitive qui gère la complexité sous-jacente du formatage CSV, de l'échappement des caractères spéciaux et de l'évaluation des formules. Contrairement aux approches manuelles qui nécessitent d'écrire un code personnalisé avec des variables `var stream` et `var csv` ou une logique d'ajout de texte, IronXL rationalise l'ensemble du processus. Les principales méthodes et techniques abordées dans ce billet sont les suivantes : * `WorkBook.Create()` pour initialiser de nouvelles feuilles de calcul en mémoire * `WorkBook.Load()` pour ouvrir des fichiers Excel existants dans n'importe quel format pris en charge * `SaveAsCsv()` pour exporter des données avec des délimiteurs personnalisables * Exportation de feuilles de calcul individuelles à l'aide de `GetWorkSheet()` pour des conversions ciblées * Modèles d'itération DataTable pour les flux de travail de la base de données au CSV * Exportation d'une liste d'objets à l'aide de boucles `foreach` [Démarrez votre essai gratuit](trial-license) pour explorer l'ensemble des fonctionnalités du tableur, ou [achetez une licence](/csharp/excel/licensing/) pour un déploiement en production. Pour des exemples supplémentaires couvrant des scénarios avancés tels que le stylisme des cellules, la création de formules et la génération de graphiques, explorez la bibliothèque complète [documentation IronXL](/csharp/excel/docs/) et [exemples de code](/csharp/excel/examples/convert-excel-spreadsheet/).