L'utilisation programmatique des fichiers Excel peut considérablement améliorer l'efficacité et les capacités d'automatisation de vos applications C#. Que vous génériez des rapports, traitiez des données ou créiez dynamiquement des feuilles de calcul complexes, la maîtrise de la manipulation des fichiers Excel est cruciale. Dans ce tutoriel, nous nous concentrerons sur l'utilisation des plages Excel avec IronXL . Nous verrons comment écrire , lire et manipuler des plages de valeurs dans un fichier Excel.

How to Read Excel Ranges in C#

1. Installez la bibliothèque IronXL pour la gestion des fichiers Excel.
2. Chargez le classeur et spécifiez la feuille de calcul.
3. Sélectionnez la plage de cellules à lire.
4. Extraire et lire les données de la plage spécifiée.

Qu'est-ce qu'IronXL ?

IronXL est une bibliothèque complète pour C# qui simplifie le travail avec les fichiers Excel, offrant une gamme de fonctionnalités pour une intégration et une manipulation transparentes des données de feuilles de calcul. Ses fonctionnalités incluent la lecture , l'écriture et la modification de fichiers Excel sans nécessiter l'installation de Microsoft Excel, permettant ainsi une compatibilité multiplateforme.

IronXL facilite l'extraction de données à partir de cellules spécifiques, de plages ou de feuilles de calcul entières, ainsi que des fonctionnalités avancées telles que la mise en forme , le style et la mise en forme conditionnelle . Grâce à sa prise en charge des calculs, des formules et des analyses statistiques, IronXL permet aux développeurs de gérer efficacement les opérations Excel par programmation, ce qui en fait un outil indispensable pour automatiser les tâches axées sur les données dans les applications C#.

Getting Started with Excel Range of cells in C#

Tout d'abord, nous devons installer la bibliothèque IronXL dans notre application.

Installez le package NuGet IronXL

Vous pouvez installer IronXL via le gestionnaire de packages NuGet avec la commande suivante :

Install-Package IronXL.Excel

La commande ci-dessus installera IronXL avec toutes ses dépendances.

Ajouter un espace de noms

Ajoutez l'espace de noms suivant en haut de la classe Program.cs, ou à l'endroit où vous souhaitez utiliser les méthodes IronXL.

using IronXL;

using IronXL;

Imports IronXL

Imports IronXL

Charger le classeur Excel

La toute première étape consiste à charger le classeur Excel. Le code suivant chargera le classeur Excel dans notre application.

static void Main(string[] args)
{
    // Load an existing Excel workbook
    var workbook = WorkBook.Load("test_excel.xlsx");
    
    // Retrieve the specified worksheet from the workbook
    var sheet = workbook.GetWorkSheet("Sheet1");
}

static void Main(string[] args)
{
    // Load an existing Excel workbook
    var workbook = WorkBook.Load("test_excel.xlsx");
    
    // Retrieve the specified worksheet from the workbook
    var sheet = workbook.GetWorkSheet("Sheet1");
}

Sub Main(args As String())
    ' Load an existing Excel workbook
    Dim workbook = WorkBook.Load("test_excel.xlsx")
    
    ' Retrieve the specified worksheet from the workbook
    Dim sheet = workbook.GetWorkSheet("Sheet1")
End Sub

Sub Main(args As String())
    ' Load an existing Excel workbook
    Dim workbook = WorkBook.Load("test_excel.xlsx")
    
    ' Retrieve the specified worksheet from the workbook
    Dim sheet = workbook.GetWorkSheet("Sheet1")
End Sub

La première ligne charge un classeur Excel existant à partir du fichier nommé " test_excel.xlsx ". La deuxième ligne récupère la feuille de calcul nommée " Sheet1 " du classeur chargé.

J'utiliserai le fichier Excel suivant tout au long de ce tutoriel.

Lecture des données à partir d'une plage

À présent, lisons les données des plages de cellules spécifiées.

// Define a range from cell A2 to G10 in the worksheet
var range = sheet["A2:G10"];

// Iterate over each cell in the range and output its value
foreach (var item in range)
{
    Console.WriteLine(item);
}

// Define a range from cell A2 to G10 in the worksheet
var range = sheet["A2:G10"];

// Iterate over each cell in the range and output its value
foreach (var item in range)
{
    Console.WriteLine(item);
}

' Define a range from cell A2 to G10 in the worksheet
Dim range = sheet("A2:G10")

' Iterate over each cell in the range and output its value
For Each item In range
	Console.WriteLine(item)
Next item

' Define a range from cell A2 to G10 in the worksheet
Dim range = sheet("A2:G10")

' Iterate over each cell in the range and output its value
For Each item In range
	Console.WriteLine(item)
Next item

La première ligne sélectionne une adresse de plage spécifique (A2 à G10) dans la feuille de calcul, vous permettant de travailler simultanément avec plusieurs cellules Excel. La boucle foreach (var item in range) itère sur chaque cellule de cette plage de cellules, permettant ainsi un traitement efficace des données.

En utilisant Console.WriteLine(item);, le code imprime la valeur de chaque cellule sur la console, facilitant ainsi la révision du contenu de la plage. Cette approche simplifie la gestion des données et améliore la lisibilité du code.

Utiliser les formules Excel dans une plage

Sélectionnons une plage spécifique et appliquons quelques formules Excel.

// Define a range from cell F2 to F42 for statistical analysis
var range = sheet["F2:F42"];

// Output the minimum age within the range
Console.WriteLine($"Minimum Age: {range.Min()}");

// Output the maximum age within the range
Console.WriteLine($"Maximum Age: {range.Max()}");

// Output the average age, casting the average value to an integer
Console.WriteLine($"Average Age: {(int)range.Avg()}");

// Define a range from cell F2 to F42 for statistical analysis
var range = sheet["F2:F42"];

// Output the minimum age within the range
Console.WriteLine($"Minimum Age: {range.Min()}");

// Output the maximum age within the range
Console.WriteLine($"Maximum Age: {range.Max()}");

// Output the average age, casting the average value to an integer
Console.WriteLine($"Average Age: {(int)range.Avg()}");

Imports System

' Define a range from cell F2 to F42 for statistical analysis
Dim range = sheet("F2:F42")

' Output the minimum age within the range
Console.WriteLine($"Minimum Age: {range.Min()}")

' Output the maximum age within the range
Console.WriteLine($"Maximum Age: {range.Max()}")

' Output the average age, casting the average value to an integer
Console.WriteLine($"Average Age: {CInt(Math.Truncate(range.Avg()))}")

Imports System

' Define a range from cell F2 to F42 for statistical analysis
Dim range = sheet("F2:F42")

' Output the minimum age within the range
Console.WriteLine($"Minimum Age: {range.Min()}")

' Output the maximum age within the range
Console.WriteLine($"Maximum Age: {range.Max()}")

' Output the average age, casting the average value to an integer
Console.WriteLine($"Average Age: {CInt(Math.Truncate(range.Avg()))}")

Le code var range = sheet["F2:F42"]; sélectionne une plage de cellules allant de F2 à F42, facilitant l'analyse statistique des données d'âge. En utilisant range.Min() et range.Max(), il calcule efficacement les valeurs d'âge minimum et maximum dans la plage spécifiée, aidant à des analyses démographiques.

En outre, range.Avg() calcule l'âge moyen, offrant des indicateurs statistiques précieux pour l'interprétation des données. Cette approche simplifie les tâches d'analyse des données, offrant un accès rapide aux informations statistiques essentielles pour une prise de décision éclairée.

Lecture des données d'une seule cellule

Lisons les données d'une seule cellule.

// Retrieve the value from cell B2 in the worksheet
var read_from_single_cell = sheet["B2"];

// Output the value in cell B2
Console.WriteLine($"The Value in Cell B2 is: {read_from_single_cell}");

// Retrieve the value from cell B2 in the worksheet
var read_from_single_cell = sheet["B2"];

// Output the value in cell B2
Console.WriteLine($"The Value in Cell B2 is: {read_from_single_cell}");

' Retrieve the value from cell B2 in the worksheet
Dim read_from_single_cell = sheet("B2")

' Output the value in cell B2
Console.WriteLine($"The Value in Cell B2 is: {read_from_single_cell}")

' Retrieve the value from cell B2 in the worksheet
Dim read_from_single_cell = sheet("B2")

' Output the value in cell B2
Console.WriteLine($"The Value in Cell B2 is: {read_from_single_cell}")

Le code var read_from_single_cell = sheet["B2"]; récupère la valeur stockée dans la cellule B2 de la feuille de calcul. Grâce à cette méthode, vous pouvez facilement accéder aux valeurs de cellules spécifiques dans le fichier Excel.

Avec Console.WriteLine($"The Value in Cell B2 is: {read_from_single_cell}");, le code imprime la valeur récupérée des cellules référencées sur la console, facilitant ainsi la vérification des données et le débogage. Cela simplifie le processus de récupération et d'affichage des valeurs de cellules individuelles à partir de fichiers Excel.

Lecture des données de la colonne entière

Lisons les données d'une colonne entière à l'aide de l'index.

// Retrieve values from the column at index 2 (C column) 
var columnValues = sheet.GetColumn(2); // 2 is column index

// Iterate over each value in the column and output it
foreach (var columnValue in columnValues)
{
    Console.WriteLine(columnValue);
}

// Retrieve values from the column at index 2 (C column) 
var columnValues = sheet.GetColumn(2); // 2 is column index

// Iterate over each value in the column and output it
foreach (var columnValue in columnValues)
{
    Console.WriteLine(columnValue);
}

' Retrieve values from the column at index 2 (C column) 
Dim columnValues = sheet.GetColumn(2) ' 2 is column index

' Iterate over each value in the column and output it
For Each columnValue In columnValues
	Console.WriteLine(columnValue)
Next columnValue

' Retrieve values from the column at index 2 (C column) 
Dim columnValues = sheet.GetColumn(2) ' 2 is column index

' Iterate over each value in the column and output it
For Each columnValue In columnValues
	Console.WriteLine(columnValue)
Next columnValue

Le code var columnValues = sheet.GetColumn(2); récupère toutes les valeurs de la colonne située à l'indice 2 (colonne C) dans la feuille de calcul. Cela vous permet d'accéder efficacement à toutes les valeurs d'une colonne spécifique de la feuille Excel.

À travers la boucle foreach itérant sur columnValues, chaque valeur de la colonne est imprimée sur la console à l'aide de Console.WriteLine(columnValue);. Cette approche facilite le traitement et l'affichage des données en colonnes issues de fichiers Excel, rationalisant ainsi les tâches d'analyse de données.

Autrement, nous pouvons également lire les données d'une colonne en utilisant un nom de colonne au lieu d'un index. Considérez l'exemple suivant :

// Retrieve values from the column with name "C"
var columnValues = sheet.GetColumn("C");

// Retrieve values from the column with name "C"
var columnValues = sheet.GetColumn("C");

' Retrieve values from the column with name "C"
Dim columnValues = sheet.GetColumn("C")

' Retrieve values from the column with name "C"
Dim columnValues = sheet.GetColumn("C")

De cette manière, nous pouvons spécifier plusieurs colonnes.

Lecture des données de la ligne entière

Lisons les données de la ligne entière en utilisant les numéros de ligne.

// Retrieve values from the row at index 1 (Row 2)
var rowValues = sheet.GetRow(1); // 1 is row index

// Iterate over each value in the row and output it
foreach (var rowValue in rowValues)
{
    Console.Write(rowValue + "  ");
}

// Retrieve values from the row at index 1 (Row 2)
var rowValues = sheet.GetRow(1); // 1 is row index

// Iterate over each value in the row and output it
foreach (var rowValue in rowValues)
{
    Console.Write(rowValue + "  ");
}

' Retrieve values from the row at index 1 (Row 2)
Dim rowValues = sheet.GetRow(1) ' 1 is row index

' Iterate over each value in the row and output it
For Each rowValue In rowValues
	Console.Write(rowValue & "  ")
Next rowValue

' Retrieve values from the row at index 1 (Row 2)
Dim rowValues = sheet.GetRow(1) ' 1 is row index

' Iterate over each value in the row and output it
For Each rowValue In rowValues
	Console.Write(rowValue & "  ")
Next rowValue

Le code var rowValues = sheet.GetRow(1); récupère toutes les valeurs d'une seule ligne située à l'indice 1 (ligne 2) dans la feuille de calcul, permettant un accès efficace aux données spécifiques à une ligne. À travers la boucle foreach itérant sur rowValues, chaque valeur de la ligne est imprimée sur la console à l'aide de Console.Write(rowValue + " ");.

Cette approche simplifie l'extraction et l'affichage des données brutes des fichiers Excel, facilitant ainsi l'analyse des données et les tâches de reporting. De cette manière, nous pouvons lire les valeurs de plusieurs cellules sans spécifier de plage.

Écriture de données dans une cellule ou une plage

Nous pouvons écrire des données à la fois dans une cellule et dans une plage. Tout d'abord, nous allons écrire des données dans une plage.

// Select a range from D2 to D14 for modification
var range = sheet["D2:D14"];

// Set the value for each cell in the range
range.Value = "Prefer Not to Say"; // Change Gender Value

// Save the modified workbook to persist changes
workbook.Save();

// Select a range from D2 to D14 for modification
var range = sheet["D2:D14"];

// Set the value for each cell in the range
range.Value = "Prefer Not to Say"; // Change Gender Value

// Save the modified workbook to persist changes
workbook.Save();

' Select a range from D2 to D14 for modification
Dim range = sheet("D2:D14")

' Set the value for each cell in the range
range.Value = "Prefer Not to Say" ' Change Gender Value

' Save the modified workbook to persist changes
workbook.Save()

' Select a range from D2 to D14 for modification
Dim range = sheet("D2:D14")

' Set the value for each cell in the range
range.Value = "Prefer Not to Say" ' Change Gender Value

' Save the modified workbook to persist changes
workbook.Save()

Le code var range = sheet["D2:D14"]; sélectionne une plage allant de la cellule D2 à D14, permettant une modification massive des données. En réglant range.Value sur "Ne préfère pas dire", il met à jour efficacement la valeur de genre pour chaque cellule de la plage spécifiée, réduisant ainsi les tâches répétitives.

La commande workbook.Save(); suivante assure le stockage persistant de ces modifications, maintenant l'intégrité et la cohérence des données. Cette approche simplifie les mises à jour par lots et garantit l'uniformité entre plusieurs cellules, améliorant ainsi l'efficacité de la gestion des données.

Maintenant, écrivons des données dans une cellule spécifique.

// Set the value for cell B2
sheet["B2"].Value = "John";

// Save the workbook to persist the changes
workbook.Save();

// Set the value for cell B2
sheet["B2"].Value = "John";

// Save the workbook to persist the changes
workbook.Save();

' Set the value for cell B2
sheet("B2").Value = "John"

' Save the workbook to persist the changes
workbook.Save()

' Set the value for cell B2
sheet("B2").Value = "John"

' Save the workbook to persist the changes
workbook.Save()

Le code sheet["B2"].Value = "John"; assigne directement la valeur "John" à la cellule B2 dans la feuille Excel, offrant une méthode concise et simple pour mettre à jour les valeurs spécifiques des cellules. Cette approche simplifie le processus de modification du contenu des cellules individuelles, améliorant ainsi la lisibilité et l'efficacité du code.

Conclusion

En conclusion, la maîtrise des opérations sur les plages Excel en C# à l'aide d'IronXL améliore considérablement l'efficacité et les capacités d'automatisation des applications, facilitant des tâches telles que le traitement des données, la génération de rapports et la création de feuilles de calcul dynamiques.

Grâce aux puissantes fonctionnalités d'IronXL pour la lecture, l'écriture et la manipulation de fichiers Excel, les développeurs peuvent rationaliser les processus de gestion des données et tirer parti de fonctionnalités avancées telles que les formules, la mise en forme et l'analyse statistique. De plus, IronXL propose un essai gratuit , garantissant flexibilité et évolutivité pour répondre aux exigences de divers projets.