Comment lire des fichiers Excel en C# sans utiliser StreamReader ?

Pourquoi StreamReader ne peut-il pas lire les fichiers Excel ?

StreamReader est un lecteur basé sur du texte. Il lit les données de caractères ligne par ligne en utilisant un encodage spécifié (UTF-8, ASCII, etc.) et ne tient pas compte des structures binaires ni des archives compressées. La documentation officielle de .NET StreamReader confirme que cette classe est conçue exclusivement pour le texte encodé en caractères. Les fichiers Excel, bien qu'ils ressemblent à de simples feuilles de calcul, sont en réalité des structures binaires complexes ou des structures XML compressées ZIP que StreamReader ne peuvent pas interpréter.

Lorsque vous ouvrez un fichier XLSX avec StreamReader, vous essayez essentiellement de lire une archive ZIP comme du texte brut. Le résultat est un flux de bruit binaire au lieu des données de votre feuille de calcul.

// This code will NOT work -- demonstrates the problem
using StreamReader reader = new StreamReader("ProductData.xlsx");
string content = reader.ReadLine();
Console.WriteLine(content); // Outputs garbled binary data like "PK♥♦"

// This code will NOT work -- demonstrates the problem
using StreamReader reader = new StreamReader("ProductData.xlsx");
string content = reader.ReadLine();
Console.WriteLine(content); // Outputs garbled binary data like "PK♥♦"

Lorsque vous exécutez ce fragment de code, au lieu d'afficher les lignes de votre feuille de calcul, vous obtenez des caractères binaires tels que PK♥♦ ou des caractères parasites similaires. Cela se produit pour les raisons suivantes :

• Les fichiers XLSX sont des archives ZIP contenant plusieurs fichiers XML : feuilles de calcul, styles, chaînes partagées, relations. La documentation du kit de développement logiciel Open XML (SDK) fournit une description détaillée de cette structure.
• Les fichiers XLS utilisent un format binaire propriétaire (BIFF – Binary Interchange Format de fichier).
• StreamReader applique un encodage de caractères à tous les octets qu'il lit, produisant une sortie incompréhensible pour les deux formats

Comment installer IronXL dans un projet .NET ?

IronXL est une bibliothèque .NET qui permet de lire, d'écrire et de créer des fichiers Excel sans nécessiter l'installation de Microsoft Excel. Il prend en charge les formats XLSX, XLS, XLSM, CSV et TSV, et fonctionne sous Windows, Linux, macOS et dans les conteneurs Docker.

Pour installer IronXL, utilisez soit la console du gestionnaire de packages NuGet, soit l'interface de ligne de commande .NET . Le package est publié sur NuGet sous le nom IronXL :

Install-Package IronXL
dotnet add package IronXL

Install-Package IronXL
dotnet add package IronXL

Après l'installation, ajoutez la directive using IronXL; à votre fichier et vous êtes prêt à travailler avec des documents Excel.

Pour connaître les étapes d'installation détaillées et les options de configuration NuGet , consultez le guide d'installation NuGet IronXL . Une licence d'essai gratuite est disponible pour vous permettre d'évaluer IronXL dans votre projet avant de l'acheter.

Comment lire des fichiers Excel avec IronXL?

IronXL fournit une API intuitive pour la lecture de fichiers Excel en C#. Contrairement à StreamReader, IronXL comprend la structure interne d'Excel et vous offre un accès clair aux lignes, aux colonnes et aux valeurs des cellules. La documentation IronXL fournit des références API complètes pour toutes les opérations prises en charge.

Voici comment lire un fichier Excel à l'aide IronXL avec des instructions de niveau supérieur :

using IronXL;

// Load the Excel file from disk
WorkBook workbook = WorkBook.Load("ProductData.xlsx");
WorkSheet worksheet = workbook.DefaultWorkSheet;

// Read a specific cell by address
string cellValue = worksheet["A1"].StringValue;
Console.WriteLine($"Cell A1 contains: {cellValue}");

// Iterate over a range of cells
foreach (var cell in worksheet["A1:C10"])
{
    Console.WriteLine($"{cell.AddressString}: {cell.Text}");
}

// Read a numeric value
decimal price = worksheet["B2"].DecimalValue;
Console.WriteLine($"Price: {price:C}");

using IronXL;

// Load the Excel file from disk
WorkBook workbook = WorkBook.Load("ProductData.xlsx");
WorkSheet worksheet = workbook.DefaultWorkSheet;

// Read a specific cell by address
string cellValue = worksheet["A1"].StringValue;
Console.WriteLine($"Cell A1 contains: {cellValue}");

// Iterate over a range of cells
foreach (var cell in worksheet["A1:C10"])
{
    Console.WriteLine($"{cell.AddressString}: {cell.Text}");
}

// Read a numeric value
decimal price = worksheet["B2"].DecimalValue;
Console.WriteLine($"Price: {price:C}");

La méthode WorkBook.Load détecte automatiquement le format du fichier (XLSX, XLS, XLSM, CSV) et gère toute l'analyse complexe. Vous accédez aux cellules en utilisant la notation Excel standard telle que "A1" ou aux plages telles que "A1:C10", ce qui rend le code immédiatement lisible par toute personne familière avec les tableurs.

using IronXL;

WorkBook workbook = WorkBook.Load("MultiSheet.xlsx");

// List all worksheets
foreach (WorkSheet sheet in workbook.WorkSheets)
{
    Console.WriteLine($"Sheet: {sheet.Name}, Rows: {sheet.RowCount}");
}

// Access a sheet by name
WorkSheet summary = workbook.GetWorkSheet("Summary");
string totalRevenue = summary["B20"].StringValue;
Console.WriteLine($"Total Revenue: {totalRevenue}");

// Access a sheet by index
WorkSheet firstSheet = workbook.WorkSheets[0];
int lastRow = firstSheet.RowCount;
Console.WriteLine($"Last row in first sheet: {lastRow}");

using IronXL;

WorkBook workbook = WorkBook.Load("MultiSheet.xlsx");

// List all worksheets
foreach (WorkSheet sheet in workbook.WorkSheets)
{
    Console.WriteLine($"Sheet: {sheet.Name}, Rows: {sheet.RowCount}");
}

// Access a sheet by name
WorkSheet summary = workbook.GetWorkSheet("Summary");
string totalRevenue = summary["B20"].StringValue;
Console.WriteLine($"Total Revenue: {totalRevenue}");

// Access a sheet by index
WorkSheet firstSheet = workbook.WorkSheets[0];
int lastRow = firstSheet.RowCount;
Console.WriteLine($"Last row in first sheet: {lastRow}");

Comment lire des données Excel à partir d'un flux mémoire ?

Dans le monde réel, les applications ont souvent besoin de traiter des fichiers Excel à partir de flux plutôt que de fichiers sur disque. Les scénarios courants incluent la gestion des téléchargements de fichiers à partir de formulaires Web, la récupération de classeurs à partir d'une colonne BLOB d'une base de données ou le traitement de fichiers téléchargés à partir d'un stockage cloud (Azure Blob Storage, AWS S3). IronXL gère ces scénarios via WorkBook.FromStream :

using IronXL;
using System.IO;

// Simulate reading file bytes (e.g., from a database or web upload)
byte[] fileBytes = File.ReadAllBytes("ProductData.xlsx");

using MemoryStream stream = new MemoryStream(fileBytes);
WorkBook workbook = WorkBook.FromStream(stream);
WorkSheet worksheet = workbook.DefaultWorkSheet;

// Get row and column counts
Console.WriteLine($"Rows: {worksheet.RowCount}, Columns: {worksheet.ColumnCount}");

// Convert to DataTable for database or grid binding
var dataTable = worksheet.ToDataTable(useHeaderRow: true);
Console.WriteLine($"Loaded {dataTable.Rows.Count} data rows");

foreach (System.Data.DataRow row in dataTable.Rows)
{
    string productName = row["ProductName"]?.ToString() ?? string.Empty;
    string sku = row["SKU"]?.ToString() ?? string.Empty;
    Console.WriteLine($"Product: {productName}, SKU: {sku}");
}

using IronXL;
using System.IO;

// Simulate reading file bytes (e.g., from a database or web upload)
byte[] fileBytes = File.ReadAllBytes("ProductData.xlsx");

using MemoryStream stream = new MemoryStream(fileBytes);
WorkBook workbook = WorkBook.FromStream(stream);
WorkSheet worksheet = workbook.DefaultWorkSheet;

// Get row and column counts
Console.WriteLine($"Rows: {worksheet.RowCount}, Columns: {worksheet.ColumnCount}");

// Convert to DataTable for database or grid binding
var dataTable = worksheet.ToDataTable(useHeaderRow: true);
Console.WriteLine($"Loaded {dataTable.Rows.Count} data rows");

foreach (System.Data.DataRow row in dataTable.Rows)
{
    string productName = row["ProductName"]?.ToString() ?? string.Empty;
    string sku = row["SKU"]?.ToString() ?? string.Empty;
    Console.WriteLine($"Product: {productName}, SKU: {sku}");
}

WorkBook.FromStream accepte tout Stream -- MemoryStream, FileStream, ou un flux réseau. Cette flexibilité signifie que vous n'aurez jamais besoin d'écrire de fichiers temporaires sur le disque simplement pour lire des données Excel. La conversion vers DataTable s'intègre également directement avec SqlBulkCopy, les contrôles de liaison de données et les cadres de reporting.

Comment convertir des fichiers Excel en fichiers CSV et inversement ?

Bien que StreamReader puisse gérer les fichiers CSV, les applications de production ont souvent besoin de transférer des données entre Excel et CSV. IronXL simplifie la conversion de format. Vous pouvez exporter des données Excel au format CSV ou importer des données CSV dans un classeur en quelques lignes seulement :

using IronXL;

// Load an Excel file and save as CSV
WorkBook workbook = WorkBook.Load("SalesData.xlsx");
workbook.SaveAsCsv("output.csv");

// Load a CSV file and save as Excel
WorkBook csvWorkbook = WorkBook.LoadCSV("legacy-report.csv");
csvWorkbook.SaveAs("converted.xlsx");

// Export a specific worksheet to CSV
WorkSheet worksheet = workbook.WorkSheets[0];
worksheet.SaveAsCsv("sheet1-export.csv");

using IronXL;

// Load an Excel file and save as CSV
WorkBook workbook = WorkBook.Load("SalesData.xlsx");
workbook.SaveAsCsv("output.csv");

// Load a CSV file and save as Excel
WorkBook csvWorkbook = WorkBook.LoadCSV("legacy-report.csv");
csvWorkbook.SaveAs("converted.xlsx");

// Export a specific worksheet to CSV
WorkSheet worksheet = workbook.WorkSheets[0];
worksheet.SaveAsCsv("sheet1-export.csv");

Ces conversions préservent vos données tout en modifiant le format du conteneur. Lors de la conversion d'Excel en CSV, IronXL exporte par défaut la première feuille de calcul ; Vous pouvez spécifier n'importe quelle feuille de votre choix. La conversion d'un fichier CSV en Excel crée un classeur correctement structuré que vous pouvez ensuite mettre en forme, auquel vous pouvez ajouter des formules et dans lequel vous pouvez écrire des données supplémentaires .

Comment créer et mettre en forme des fichiers Excel avec IronXL?

La lecture des données Excel ne représente qu'une partie du flux de travail. De nombreuses applications nécessitent également la création de nouveaux fichiers Excel et l'application d'une mise en forme. IronXL prend en charge la mise en forme des cellules, notamment les polices, les couleurs, les bordures, les formats numériques et la fusion des cellules :

using IronXL;

// Create a new workbook and worksheet
WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet sheet = workbook.CreateWorkSheet("Report");

// Write headers with formatting
sheet["A1"].Value = "Product";
sheet["B1"].Value = "Units Sold";
sheet["C1"].Value = "Revenue";

// Apply bold formatting to header row
sheet["A1:C1"].Style.Font.Bold = true;
sheet["A1:C1"].Style.SetBackgroundColor("#4472C4");
sheet["A1:C1"].Style.Font.Color = "#FFFFFF";

// Write data rows
string[] products = { "Widget A", "Widget B", "Widget C" };
int[] units = { 120, 85, 210 };
decimal[] revenues = { 2400.00m, 1700.00m, 4200.00m };

for (int i = 0; i < products.Length; i++)
{
    sheet[$"A{i + 2}"].Value = products[i];
    sheet[$"B{i + 2}"].Value = units[i];
    sheet[$"C{i + 2}"].Value = revenues[i];
    sheet[$"C{i + 2}"].FormatString = "$#,##0.00";
}

// Save the workbook
workbook.SaveAs("FormattedReport.xlsx");
Console.WriteLine("Report created successfully.");

using IronXL;

// Create a new workbook and worksheet
WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet sheet = workbook.CreateWorkSheet("Report");

// Write headers with formatting
sheet["A1"].Value = "Product";
sheet["B1"].Value = "Units Sold";
sheet["C1"].Value = "Revenue";

// Apply bold formatting to header row
sheet["A1:C1"].Style.Font.Bold = true;
sheet["A1:C1"].Style.SetBackgroundColor("#4472C4");
sheet["A1:C1"].Style.Font.Color = "#FFFFFF";

// Write data rows
string[] products = { "Widget A", "Widget B", "Widget C" };
int[] units = { 120, 85, 210 };
decimal[] revenues = { 2400.00m, 1700.00m, 4200.00m };

for (int i = 0; i < products.Length; i++)
{
    sheet[$"A{i + 2}"].Value = products[i];
    sheet[$"B{i + 2}"].Value = units[i];
    sheet[$"C{i + 2}"].Value = revenues[i];
    sheet[$"C{i + 2}"].FormatString = "$#,##0.00";
}

// Save the workbook
workbook.SaveAs("FormattedReport.xlsx");
Console.WriteLine("Report created successfully.");

Grâce à sa capacité à la fois à lire des classeurs existants et à créer de nouveaux fichiers formatés, IronXL constitue une solution Excel complète pour les applications .NET . Consultez la page complète des fonctionnalités IronXL pour obtenir une description détaillée des opérations prises en charge.

Comment obtenir une licence et déployer IronXL en production ?

IronXL est gratuit pour le développement et les tests. Pour les applications de production, une licence est requise. Vous pouvez consulter les options de licence IronXL sur la page produit, qui proposent les niveaux Développeur, Équipe et Organisation en fonction de vos besoins de déploiement.

Après l'achat, saisissez votre clé de licence sous forme de code avant toute utilisation IronXL :

IronXl.License.LicenseKey = "YOUR-LICENSE-KEY-HERE";

IronXl.License.LicenseKey = "YOUR-LICENSE-KEY-HERE";

Vous pouvez également définir la variable d'environnement IRONXL_LICENSE_KEY dans votre environnement de déploiement et IronXL la détectera automatiquement. Il s'agit de l'approche privilégiée pour les déploiements conteneurisés (Docker, Kubernetes) et les environnements cloud où le codage en dur des clés n'est pas acceptable.

À des fins d'évaluation, une licence d'essai gratuite offre toutes les fonctionnalités nécessaires pour valider IronXL en fonction de vos charges de travail spécifiques avant de procéder à un achat. L'essai est disponible sans carte de crédit et s'active immédiatement.

Comparé à des alternatives telles que Microsoft.Office.Interop.Excel, IronXL présente plusieurs avantages en matière de déploiement :

• Aucune obligation d'installer Microsoft Excel sur le serveur
• Compatible avec Linux et Docker – essentiel pour les applications natives du cloud
• Aucun problème de gestion du cycle de vie des objets COM ou de gestion des threads d'appartements
• Démarrage plus rapide et consommation de mémoire réduite dans les contextes serveur
• Comportement cohérent sur toutes les plateformes prises en charge

Ces qualités font IronXL un choix judicieux pour toute application .NET ayant besoin de traiter des fichiers Excel en production, que ce soit sur site ou dans le cloud.