C&#35 ; Lire un fichier XLSX

Pourquoi utiliser la méthode WorkBook.Load()?

Dans le code ci-dessus, la fonction WorkBook.Load() charge sample.xlsx dans workBook . Tout type de fonction peut être exécuté sur workBook en accédant à la feuille de calcul spécifique d'un fichier Excel. La méthode WorkBook.Load détecte automatiquement le format du fichier, qu'il s'agisse de XLS, XLSX, XLSM, XLTX ou CSV. Pour des scénarios de chargement plus avancés, consultez le guide détaillé sur le chargement de feuilles de calcul.

Quelles sont les différentes façons d'accéder à une feuille de calcul ?

:path=/static-assets/excel/content-code-examples/how-to/c-sharp-read-xlsx-file-get-worksheet.cs

using IronXL;

// Access sheet by name
WorkSheet workSheet = workBook.GetWorkSheet("Sheet1");

workBook est le WorkBook déclaré dans la partie ci-dessus.

OU

:path=/static-assets/excel/content-code-examples/how-to/c-sharp-read-xlsx-file-worksheet-index.cs

using IronXL;

// Access sheet by index
WorkSheet workSheet = workBook.WorkSheets[0];

OU

:path=/static-assets/excel/content-code-examples/how-to/c-sharp-read-xlsx-file-default-worksheet.cs

using IronXL;

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

OU

:path=/static-assets/excel/content-code-examples/how-to/c-sharp-read-xlsx-file-first-worksheet.cs

using IronXL;
using System.Linq;

// Access the first worksheet
WorkSheet workSheet = workBook.WorkSheets.First();

OU

:path=/static-assets/excel/content-code-examples/how-to/c-sharp-read-xlsx-file-first-or-default-worksheet.cs

using IronXL;
using System.Linq;

// Access the first or default worksheet
WorkSheet workSheet = workBook.WorkSheets.FirstOrDefault();

Quand dois-je utiliser chaque méthode d'accès à la feuille de calcul ?

Chaque méthode a son cas d'utilisation idéal :

• GetWorkSheet("name") : Lorsque vous connaissez le nom exact de la feuille
• WorkSheets[index] : Pour parcourir les feuilles de manière programmatique
• Feuille de travail par défaut : Accès rapide aux fichiers à feuille unique
• First() ou FirstOrDefault() : Options sûres lorsque les noms de feuilles risquent de changer

Une fois workSheet Excel obtenue, vous pouvez en extraire tout type de données et effectuer toutes les fonctions Excel dessus. Pour des opérations plus complexes sur les feuilles de calcul, consultez le guide sur l'ouverture de feuilles de calcul Excel en C#.

Quels types de données puis-je lire dans les cellules ?

:path=/static-assets/excel/content-code-examples/how-to/c-sharp-read-xlsx-file-get-data.cs

using IronXL;

// Accessing data as a string
string dataString = workSheet["A1"].ToString();

// Accessing data as an integer
int dataInt = workSheet["B1"].Int32Value;

IronXL fournit divers accesseurs de valeurs pour différents types de données :

• StringValue : Pour les données textuelles
• Int32Value : Pour les entiers
• Valeur double : Pour les décimales
• DateTimeValue : Pour les dates
• BoolValue : Pour les valeurs vrai/faux

Comment lire plusieurs cellules à la fois ?

Vous pouvez également obtenir des données à partir de plusieurs cellules d'une colonne spécifique :

foreach (var cell in workSheet["A2:A10"])
{
    Console.WriteLine("Value is: {0}", cell.Text);
}

foreach (var cell in workSheet["A2:A10"])
{
    Console.WriteLine("Value is: {0}", cell.Text);
}

Ceci affiche les valeurs des cellules A2 à A10. Pour des techniques de sélection de plage plus avancées, visitez le tutoriel de sélection de plage.

À quoi ressemble une implémentation complète?

Un exemple de code complet des spécificités ci-dessus est fourni ici :

:path=/static-assets/excel/content-code-examples/how-to/c-sharp-read-xlsx-file-log-data.cs

using IronXL;
using System;

// Load an Excel file
WorkBook workBook = WorkBook.Load("sample.xlsx");
WorkSheet workSheet = workBook.GetWorkSheet("Sheet1");

// Specify the range
foreach (var cell in workSheet["B2:B10"])
{
    Console.WriteLine("Value is: {0}", cell.Text);
}

Elle affiche le résultat suivant :

Avec le fichier Excel Sample.xlsx :

Ces méthodologies montrent à quel point il est facile d'utiliser des données de fichiers Excel dans votre projet. Pour des exemples pratiques de lecture de fichiers Excel sans Interop, consultez les exemples de lecture d'Excel.

Quelles sont les fonctions d'agrégation disponibles ?

:path=/static-assets/excel/content-code-examples/how-to/c-sharp-read-xlsx-file-aggregate-function.cs

using IronXL;

// Apply aggregate functions
decimal sum = workSheet["G2:G10"].Sum(); // Sum of cells from G2 to G10
decimal min = workSheet["G2:G10"].Min(); // Minimum value in cells from G2 to G10
decimal max = workSheet["G2:G10"].Max(); // Maximum value in cells from G2 to G10

IronXL prend en charge de nombreuses fonctions mathématiques, notamment :

• Moyenne() : Calculer la valeur moyenne
• Count() : Compter les cellules non vides
• CountIf() : Compter les cellules répondant à des critères
• Médiane() : Trouver la valeur moyenne
• StdDev() : Calculer l'écart-type

Comment mettre en œuvre plusieurs fonctions ensemble ?

Pour plus de détails, consultez notre tutoriel approfondi sur Comment Écrire des fichiers Excel en C# avec des spécificités sur les fonctions d'agrégation. Vous pouvez également explorer la liste complète des fonctions mathématiques disponibles dans IronXL.

:path=/static-assets/excel/content-code-examples/how-to/c-sharp-read-xlsx-file-min-max.cs

using IronXL;
using System;

// Load the Excel workbook
WorkBook workBook = WorkBook.Load("sample.xlsx");

// Get the specified WorkSheet
WorkSheet workSheet = workBook.GetWorkSheet("Sheet1");

// Calculate sum, minimum, and maximum for a range of cells
decimal sum = workSheet["G2:G10"].Sum();
decimal min = workSheet["G2:G10"].Min();
decimal max = workSheet["G2:G10"].Max();

// Output results
Console.WriteLine("Sum is: {0}", sum);
Console.WriteLine("Min is: {0}", min);
Console.WriteLine("Max is: {0}", max);

Ce code affiche la sortie suivante :

Voici à quoi ressemble le fichier Excel Sample.xlsx :

Quelle est la méthode de conversion de base ?

:path=/static-assets/excel/content-code-examples/how-to/c-sharp-read-xlsx-file-datatable.cs

using IronXL;
using System.Data;

// Convert worksheet to DataTable
DataTable dt = workSheet.ToDataTable();

Comment utiliser la première ligne comme en-tête de colonne ?

Pour utiliser la première ligne de la feuille Excel comme table de données ColumnName :

:path=/static-assets/excel/content-code-examples/how-to/c-sharp-read-xlsx-file-datatable-header.cs

using IronXL;
using System.Data;

// Convert worksheet to DataTable with the first row as column names
DataTable dt = workSheet.ToDataTable(true);

Le paramètre booléen de ToDataTable() définit la première ligne comme nom de colonne de votre DataTable. Par défaut, sa valeur est False . Ceci est particulièrement utile lorsque l'on travaille avec des données structurées qui incluent des en-têtes.

Comment itérer à travers le DataTable?

:path=/static-assets/excel/content-code-examples/how-to/c-sharp-read-xlsx-file-print-datatable.cs

using IronXL;
using System;
using System.Data;

// Load the Excel workbook
WorkBook workBook = WorkBook.Load("sample.xlsx");

// Get the specified WorkSheet
WorkSheet workSheet = workBook.GetWorkSheet("Sheet1");

// Convert WorkSheet to DataTable
DataTable dt = workSheet.ToDataTable(true); // Use first row as column names

// Iterate through rows and columns and display data
foreach (DataRow row in dt.Rows) // Access rows
{
    for (int i = 0; i < dt.Columns.Count; i++) // Access columns of corresponding row
    {
        Console.Write(row[i] + " ");
    }
    Console.WriteLine();
}

À l'aide du code ci-dessus, chaque valeur de cellule de la Feuille de travail peut être consultée et utilisée selon les besoins. Pour des opérations DataTable plus avancées, voir le guide sur l'importation et l'exportation en tant que DataSet.

Comment convertir un classeur en DataSet?

:path=/static-assets/excel/content-code-examples/how-to/c-sharp-read-xlsx-file-excel-to-dataset.cs

using IronXL;
using System;
using System.Data;

// Load the Excel workbook
WorkBook workBook = WorkBook.Load("sample.xlsx");

// Convert the WorkBook to a DataSet
DataSet ds = workBook.ToDataSet();

// Iterate through tables in the DataSet and display table names
foreach (DataTable dt in ds.Tables)
{
    Console.WriteLine(dt.TableName);
}

Le résultat du code ci-dessus ressemble à ceci :

Et le fichier Excel Sample.xlsx ressemble à ceci :

Comment puis-je accéder à la valeur de chaque cellule dans toutes les feuilles de calcul ?

Dans l'exemple ci-dessus, nous pouvons facilement analyser un fichier Excel en un DataSet et travailler avec chaque WorkSheet d'un fichier Excel en tant que DataTable. Découvrez comment parser Excel en tant que DataSet en vous appuyant sur des exemples de code.

Voyons un autre exemple de la façon d'accéder à la valeur de chaque cellule de toutes les feuilles Excel. Ici, nous pouvons accéder à chaque valeur de cellule de chaque Feuille de travail d'un fichier Excel.

:path=/static-assets/excel/content-code-examples/how-to/c-sharp-read-xlsx-all-excel-sheets.cs

// CET EXTRAIT DE CODE N'EST PAS DISPONIBLE !

Dans l'exemple ci-dessus, il est pratique d'accéder à chaque valeur de cellule de chaque Feuille de travail d'un fichier Excel. Cette approche est particulièrement utile lorsqu'il s'agit de classeurs à plusieurs feuilles où les données sont réparties sur différents onglets.

Pour en savoir plus sur la manière de Lire des fichiers Excel sans interopérabilité, consultez le code ici. La documentation de référence de l'API fournit des détails complets sur toutes les méthodes et propriétés disponibles à l'adresse Référence de l'API IronXL.

Accès rapide au tutoriel

Référence API pour IronXL

Pour en savoir plus sur les fonctionnalités, les classes, les champs de méthode, les espaces de noms et les énumérations d'IronXL, consultez la documentation.

Référence API pour IronXL