ExcelDataReader Écriture de fichiers Excel : Pourquoi il ne peut pas et comment IronXL résout ce problème

ExcelDataReader peut-il écrire des données de classeur Excel?

Non. ExcelDataReader est une bibliothèque en lecture seule par conception, et cette limitation est intentionnelle. Le dépôt GitHub officiel d'ExcelDataReader décrit explicitement le projet comme " une bibliothèque permettant de lire des fichiers Microsoft Excel " ; il n'y a pas d'API d'écriture, pas de méthode d'enregistrement et aucun outil de définition de valeur de cellule accessible au public. Vous pouvez le vérifier vous-même en consultant la page du package NuGet ExcelDataReader , où la description du package confirme la portée en lecture seule.

ExcelDataReader prend en charge les formats XLS, XLSX et CSV pour la lecture, et il effectue cette tâche efficacement. La bibliothèque expose un modèle de lecteur en flux continu, unidirectionnel, similaire à IDataReader dans .NET. Cette architecture est bien adaptée à l'extraction rapide de grands ensembles de données, mais elle est fondamentalement incompatible avec le modèle à accès aléatoire et modifiable qu'exige l'écriture dans Excel.

Le code ci-dessous illustre la limite que vous atteignez avec ExcelDataReader :

using ExcelDataReader;
using System.Text;

// Register the encoding provider required for .NET 5+
Encoding.RegisterProvider(CodePagesEncodingProvider.Instance);

using var stream = File.Open("source.xlsx", FileMode.Open, FileAccess.Read);
using var reader = ExcelReaderFactory.CreateReader(stream);

while (reader.Read())
{
    string cellValue = reader.GetString(0); // Read a cell value
    Console.WriteLine(cellValue);
    // There is no Write(), Save(), or SetCellValue() method here
}

using ExcelDataReader;
using System.Text;

// Register the encoding provider required for .NET 5+
Encoding.RegisterProvider(CodePagesEncodingProvider.Instance);

using var stream = File.Open("source.xlsx", FileMode.Open, FileAccess.Read);
using var reader = ExcelReaderFactory.CreateReader(stream);

while (reader.Read())
{
    string cellValue = reader.GetString(0); // Read a cell value
    Console.WriteLine(cellValue);
    // There is no Write(), Save(), or SetCellValue() method here
}

Imports ExcelDataReader
Imports System.Text
Imports System.IO

' Register the encoding provider required for .NET 5+
Encoding.RegisterProvider(CodePagesEncodingProvider.Instance)

Using stream = File.Open("source.xlsx", FileMode.Open, FileAccess.Read)
    Using reader = ExcelReaderFactory.CreateReader(stream)
        While reader.Read()
            Dim cellValue As String = reader.GetString(0) ' Read a cell value
            Console.WriteLine(cellValue)
            ' There is no Write(), Save(), or SetCellValue() method here
        End While
    End Using
End Using

Après avoir appelé Read(), il n'existe tout simplement pas d'équivalent Write() ou Save(). Lorsque votre application doit générer des rapports, mettre à jour des cellules de feuille de calcul, exporter des données au format XLSX, appliquer des formules ou traiter des modèles, ExcelDataReader vous laisse avec une boîte à outils vide.

Il ne s'agit pas d'un bug. Il s'agit d'une décision délibérée concernant le périmètre d'application. ExcelDataReader fait une seule chose correctement, et s'arrête là. Tout flux de travail impliquant l'écriture de données dans Excel nécessite une bibliothèque entièrement différente.

Comment IronXL résout-il le problème de l'écriture?

IronXL fournit une API unifiée pour lire, créer, modifier et enregistrer des fichiers Excel sans aucune installation de Microsoft Office. La bibliothèque traite un classeur Excel comme un graphe d'objets entièrement modifiable en mémoire. Vous chargez ou créez un classeur, naviguez vers n'importe quelle cellule par référence, définissez des valeurs ou des formules, appliquez des styles, puis appelez SaveAs() -- un flux de travail qui reflète la façon dont un humain travaillerait dans Excel lui-même.

IronXL prend en charge les formats XLSX, XLS, CSV, TSV et JSON pour l'entrée et la sortie. Il fonctionne sous .NET 10, .NET Standard et .NET Framework, ce qui le rend adapté aux applications console, aux API Web ASP.NET Core , aux outils de bureau et aux services de traitement en arrière-plan.

Install-Package IronXL

Install-Package IronXL

dotnet add package IronXL

dotnet add package IronXL

using IronXL;

WorkBook workBook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet sheet = workBook.CreateWorkSheet("Report");

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

// Write a data row
sheet["A2"].Value = "Widget";
sheet["B2"].Value = 150;
sheet["C2"].Value = 9.99;

workBook.SaveAs("report.xlsx");
Console.WriteLine("Workbook saved.");

using IronXL;

WorkBook workBook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet sheet = workBook.CreateWorkSheet("Report");

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

// Write a data row
sheet["A2"].Value = "Widget";
sheet["B2"].Value = 150;
sheet["C2"].Value = 9.99;

workBook.SaveAs("report.xlsx");
Console.WriteLine("Workbook saved.");

Imports IronXL

Dim workBook As WorkBook = WorkBook.Create(ExcelFileFormat.XLSX)
Dim sheet As WorkSheet = workBook.CreateWorkSheet("Report")

' Write header row
sheet("A1").Value = "Product"
sheet("B1").Value = "Quantity"
sheet("C1").Value = "Unit Price"

' Write a data row
sheet("A2").Value = "Widget"
sheet("B2").Value = 150
sheet("C2").Value = 9.99

workBook.SaveAs("report.xlsx")
Console.WriteLine("Workbook saved.")

Comment lire et écrire dans un seul flux de travail IronXL ?

Une exigence courante consiste à lire un fichier Excel existant, à transformer ses données et à réécrire les résultats. ExcelDataReader ne gère que la première étape, ce qui signifie que vous devez introduire une deuxième bibliothèque – une complication inutile qui ajoute une surcharge de gestion des dépendances et des conflits de versions potentiels.

IronXL couvre l'intégralité du processus. L'exemple ci-dessous charge un fichier source, lit les valeurs de la colonne A, les transforme et enregistre le classeur modifié dans un nouveau fichier :

using IronXL;

WorkBook workBook = WorkBook.Load("source.xlsx");
WorkSheet sheet = workBook.DefaultWorkSheet;

// Read existing data
string originalValue = sheet["A1"].StringValue;
Console.WriteLine($"Original: {originalValue}");

// Modify existing data
sheet["A1"].Value = originalValue.ToUpper();

// Add new data alongside existing content
sheet["B1"].Value = DateTime.Now.ToString("yyyy-MM-dd");
sheet["C1"].Formula = "=LEN(A1)";

workBook.SaveAs("modified.xlsx");
Console.WriteLine("Modified workbook saved.");

using IronXL;

WorkBook workBook = WorkBook.Load("source.xlsx");
WorkSheet sheet = workBook.DefaultWorkSheet;

// Read existing data
string originalValue = sheet["A1"].StringValue;
Console.WriteLine($"Original: {originalValue}");

// Modify existing data
sheet["A1"].Value = originalValue.ToUpper();

// Add new data alongside existing content
sheet["B1"].Value = DateTime.Now.ToString("yyyy-MM-dd");
sheet["C1"].Formula = "=LEN(A1)";

workBook.SaveAs("modified.xlsx");
Console.WriteLine("Modified workbook saved.");

Imports IronXL

Dim workBook As WorkBook = WorkBook.Load("source.xlsx")
Dim sheet As WorkSheet = workBook.DefaultWorkSheet

' Read existing data
Dim originalValue As String = sheet("A1").StringValue
Console.WriteLine($"Original: {originalValue}")

' Modify existing data
sheet("A1").Value = originalValue.ToUpper()

' Add new data alongside existing content
sheet("B1").Value = DateTime.Now.ToString("yyyy-MM-dd")
sheet("C1").Formula = "=LEN(A1)"

workBook.SaveAs("modified.xlsx")
Console.WriteLine("Modified workbook saved.")

L'appel WorkBook.Load() lit le fichier en mémoire comme un objet mutable. Vous pouvez ensuite naviguer dans les cellules à l'aide de références de type Excel, mettre à jour les valeurs, définir des formules et enregistrer, le tout au sein d'une seule bibliothèque et d'un seul modèle d'API.

Quelles sont les fonctionnalités d'écriture avancées prises en charge par IronXL ?

Au-delà de la simple affectation de cellules, IronXL expose toute la gamme des fonctionnalités Excel dont les applications métier ont généralement besoin.

using IronXL;
using IronXl.Styles;

WorkBook workBook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet sheet = workBook.CreateWorkSheet("Analytics");

// Write labels
sheet["A1"].Value = "Revenue";
sheet["B1"].Value = "Cost";
sheet["C1"].Value = "Margin";

// Write data
sheet["A2"].Value = 50000;
sheet["B2"].Value = 32000;

// Write a calculated formula
sheet["C2"].Formula = "=A2-B2";

// Apply bold formatting to the header row
sheet["A1:C1"].Style.Font.Bold = true;

// Highlight the margin cell
sheet["C2"].Style.BackgroundColor = "#D4EDDA";
sheet["C2"].Style.Font.Bold = true;

workBook.SaveAs("analytics.xlsx");

using IronXL;
using IronXl.Styles;

WorkBook workBook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet sheet = workBook.CreateWorkSheet("Analytics");

// Write labels
sheet["A1"].Value = "Revenue";
sheet["B1"].Value = "Cost";
sheet["C1"].Value = "Margin";

// Write data
sheet["A2"].Value = 50000;
sheet["B2"].Value = 32000;

// Write a calculated formula
sheet["C2"].Formula = "=A2-B2";

// Apply bold formatting to the header row
sheet["A1:C1"].Style.Font.Bold = true;

// Highlight the margin cell
sheet["C2"].Style.BackgroundColor = "#D4EDDA";
sheet["C2"].Style.Font.Bold = true;

workBook.SaveAs("analytics.xlsx");

Imports IronXL
Imports IronXl.Styles

Dim workBook As WorkBook = WorkBook.Create(ExcelFileFormat.XLSX)
Dim sheet As WorkSheet = workBook.CreateWorkSheet("Analytics")

' Write labels
sheet("A1").Value = "Revenue"
sheet("B1").Value = "Cost"
sheet("C1").Value = "Margin"

' Write data
sheet("A2").Value = 50000
sheet("B2").Value = 32000

' Write a calculated formula
sheet("C2").Formula = "=A2-B2"

' Apply bold formatting to the header row
sheet("A1:C1").Style.Font.Bold = True

' Highlight the margin cell
sheet("C2").Style.BackgroundColor = "#D4EDDA"
sheet("C2").Style.Font.Bold = True

workBook.SaveAs("analytics.xlsx")

using IronXL;

// Load a CSV file as if it were a workbook
WorkBook csvWorkBook = WorkBook.LoadCSV("data.csv", fileFormat: ExcelFileFormat.CSV);
WorkSheet csvSheet = csvWorkBook.DefaultWorkSheet;

// Apply a bold header style to the first row
csvSheet["A1:Z1"].Style.Font.Bold = true;

// Save as XLSX
csvWorkBook.SaveAs("converted.xlsx");
Console.WriteLine("CSV converted to XLSX.");

using IronXL;

// Load a CSV file as if it were a workbook
WorkBook csvWorkBook = WorkBook.LoadCSV("data.csv", fileFormat: ExcelFileFormat.CSV);
WorkSheet csvSheet = csvWorkBook.DefaultWorkSheet;

// Apply a bold header style to the first row
csvSheet["A1:Z1"].Style.Font.Bold = true;

// Save as XLSX
csvWorkBook.SaveAs("converted.xlsx");
Console.WriteLine("CSV converted to XLSX.");

Imports IronXL

' Load a CSV file as if it were a workbook
Dim csvWorkBook As WorkBook = WorkBook.LoadCSV("data.csv", fileFormat:=ExcelFileFormat.CSV)
Dim csvSheet As WorkSheet = csvWorkBook.DefaultWorkSheet

' Apply a bold header style to the first row
csvSheet("A1:Z1").Style.Font.Bold = True

' Save as XLSX
csvWorkBook.SaveAs("converted.xlsx")
Console.WriteLine("CSV converted to XLSX.")

Comment comparer ExcelDataReader et IronXL côte à côte ?

Le tableau ci-dessous résume les différences de fonctionnalités entre les deux bibliothèques dans les scénarios de développement Excel les plus courants :

ExcelDataReader reste un choix valable lorsque la lecture est la seule exigence et que la taille des données binaires importe. Pour tout scénario impliquant une sortie, IronXL est l'outil approprié.

Quand devriez-vous utiliser IronXL?

IronXL est le choix idéal chaque fois que votre application a besoin de produire ou de modifier des fichiers Excel. Les scénarios suivants sont représentatifs de besoins métiers réels auxquels ExcelDataReader ne peut pas répondre :

• Génération de rapports : produire des rapports Excel à partir de requêtes de base de données, de réponses d'API ou de calculs en mémoire. Consultez le guide de création de rapports Excel pour obtenir une procédure détaillée.
• Exportation de données : Convertissez les données de l'application (collections, DataTables ou DataSets) au format XLSX pour les télécharger ou les archiver. Le tutoriel DataTable vers Excel présente l'API exacte.
• Traitement de modèles : Charger un modèle XLSX avec des cellules d'espace réservé, les remplir dynamiquement, puis enregistrer le résultat. Modification par lots de fichiers : parcourez un répertoire de classeurs, appliquez les modifications par programmation et enregistrez chaque fichier. IronXL gère plusieurs classeurs ouverts indépendamment.
• Génération de factures et de documents financiers : Créez des documents structurés avec des formules, la mise en forme des nombres, des cellules fusionnées et des en-têtes stylisés.
• Conversion CSV vers XLSX : Accepter les fichiers téléchargés séparés par des virgules, les reformater en classeurs structurés et renvoyer des fichiers XLSX à télécharger aux utilisateurs.

Les applications métier qui nécessitaient auparavant une bibliothèque de lecture et une bibliothèque d'écriture, ou une dépendance à l'égard de l'automatisation Excel via COM, peuvent désormais être consolidées en IronXL uniquement.

Pour les scénarios de sortie avancés, la documentation sur la mise en forme conditionnelle et le guide de création de graphiques couvrent l'ensemble des fonctionnalités de mise en forme et de visualisation. La page relative aux licences décrit les options de déploiement en production, et la documentation complète de l'API détaille chaque classe et méthode.

Comment bénéficier d'un essai gratuit ?

IronXL est disponible sous une licence de développement gratuite. Installez le package NuGet , exécutez les exemples ci-dessus sur vos propres fichiers et vérifiez que le résultat répond à vos exigences avant de souscrire à une licence de production.

Le guide de démarrage IronXL détaille l'installation, les exemples de première utilisation et les scénarios courants avec du code exécutable. La section tutoriels aborde en détail les flux de travail de lecture, ce qui est utile si votre application nécessite à la fois des opérations de lecture et d'écriture.

Démarrez l'essai gratuit pour accéder à l'ensemble des fonctionnalités, y compris les formats d'exportation, la mise en forme avancée, l'évaluation des formules et la gestion des classeurs à plusieurs feuilles. Pour les équipes évaluant la bibliothèque à grande échelle, le pack IronSuite inclut IronXL ainsi IronPDF, IronOCR et d'autres bibliothèques de productivité à un prix combiné réduit.

ExcelDataReader vaut-il encore la peine d'être utilisé ?

ExcelDataReader est une bibliothèque open source bien maintenue, avec un objectif clair. Si votre application se contente de lire des fichiers Excel sans jamais les écrire (par exemple, un pipeline d'ingestion de données qui importe des fichiers XLSX dans une base de données), ExcelDataReader est un choix judicieux et léger. Son modèle de flux est économe en mémoire, même pour les fichiers très volumineux.

Le problème survient lorsque les exigences augmentent. Les applications qui débutent comme des importateurs en lecture seule évoluent souvent pour produire des exportations de confirmation, des rapports d'erreurs ou des copies modifiées des fichiers originaux. À ce stade, la limite de portée d'ExcelDataReader devient un obstacle, et migrer vers une bibliothèque de lecture-écriture en cours de projet est plus perturbateur que de commencer avec une telle bibliothèque.

Choisir IronXL dès le départ couvre les deux cas de figure. Le tutoriel de lecture IronXL démontre que la lecture avec IronXL est tout aussi simple : les références de cellules, l'itération de plages, l'exportation de DataSet et l'accès aux valeurs avec sécurité de type fonctionnent tous via la même API familière.

Que devez-vous faire ensuite ?

ExcelDataReader est une bibliothèque en lecture seule. Cette contrainte est intentionnelle et ne changera pas. Si votre projet nécessite l'écriture, la modification ou l'exportation de fichiers Excel sous quelque forme que ce soit, vous avez besoin d'une bibliothèque conçue pour un accès bidirectionnel à Excel.

IronXL offre cette fonctionnalité sans dépendances Office, sans complexité d'interopérabilité COM et sans combiner plusieurs packages dans une pile multi-bibliothèques fragile. Installez-le depuis NuGet, remplacez votre code de lecture existant par les méthodes équivalentes d'IronXL et ajoutez des opérations d'écriture là où c'est nécessaire ; l'API est cohérente dans les deux sens.

Explorez la documentation IronXL pour comprendre toute l'étendue de la bibliothèque. Consultez les guides pratiques pour des tâches spécifiques telles que l'écriture de fichiers Excel , la création de feuilles de calcul et la lecture de classeurs existants . Lorsque vous serez prêt à évaluer les licences de production, la page des tarifs et des licences répertorie tous les niveaux disponibles.