Comment ouvrir des fichiers Excel en C#

Quelles sont les principales caractéristiques d'IronXL ?

• Ouvrez, lisez et recherchez des données aux formats XLS/XLSX/CSV/TSV à l'aide de LoadSpreadsheets .
• Exportez vos feuilles de calcul Excel vers plusieurs formats grâce à la fonction Enregistrer et exporter .
• Chiffrez et déchiffrez des fichiers avec des mots de passe en utilisant des fonctionnalités sécurisées .
• Travailler avec des feuilles Excel en tant qu'objets DataSet et DataTable grâce à l'intégration DataSet .
• Les formules Excel se recalculent automatiquement et prennent en charge les fonctions mathématiques .
• Modifiez les données de la feuille de calcul grâce à une syntaxe de plage intuitive comme WorkSheet["A1:B10"] .
• Trier les plages de cellules , les colonnes et les lignes .
• Mettez en forme les cellules avec la police , l'arrière-plan , la bordure , l'alignement et les formats numériques .

De quoi ai-je besoin avant de commencer ?

Pour utiliser IronXL dans des applications C#, installez les composants suivants sur votre ordinateur local :

1. Visual Studio - L'IDE officiel pour le développement d'applications C# .NET. Vous pouvez télécharger et installer Visual Studio depuis le site web de Microsoft . Vous pouvez également utiliser JetBrains ReSharper et Rider . Pour obtenir des conseils supplémentaires sur la configuration, reportez-vous à la présentation générale " Premiers pas " .
2. IronXL - La bibliothèque Excel qui facilite le travail avec les feuilles Excel en C#. Il doit être installé dans votre application C# avant d'être utilisé. Vous pouvez le télécharger depuis le site web de NuGet ou depuis la section " Gérer les packages NuGet " dans Visual Studio. Vous pouvez également télécharger directement le fichier DLL .NET Excel . Pour la mise en œuvre des licences, voir Utilisation des clés de licence .

Quels espaces de noms dois-je importer ?

Une fois Visual Studio et IronXL installés, ajoutez les espaces de noms IronXL nécessaires en incluant la ligne suivante en haut de votre fichier C# :

// Add reference to the IronXL library
using IronXL;

// Add reference to the IronXL library
using IronXL;

Pour travailler avec des formats Excel spécifiques ou des fonctionnalités avancées, vous pourriez également avoir besoin de :

using IronXL.Formatting;  // For cell styling
using IronXL.Drawing;     // For images and charts
using System.Data;        // For DataSet/DataTable operations

using IronXL.Formatting;  // For cell styling
using IronXL.Drawing;     // For images and charts
using System.Data;        // For DataSet/DataTable operations

Comment charger un fichier Excel existant ?

Les fichiers Excel, également appelés classeurs, sont composés de plusieurs feuilles de calcul, chacune contenant des valeurs de cellules. Pour ouvrir et lire un fichier Excel , chargez-le à l'aide de la méthode Load de la classe WorkBook . La fonctionnalité LoadSpreadsheets prend en charge différents formats.

// Supported Excel spreadsheet formats for reading include: XLSX, XLS, CSV, and TSV
WorkBook workbook = WorkBook.Load("test.xlsx");

// You can also load from streams for web applications
// using (var stream = File.OpenRead("test.xlsx"))
// {
//     WorkBook workbook = WorkBook.Load(stream);
// }

// Supported Excel spreadsheet formats for reading include: XLSX, XLS, CSV, and TSV
WorkBook workbook = WorkBook.Load("test.xlsx");

// You can also load from streams for web applications
// using (var stream = File.OpenRead("test.xlsx"))
// {
//     WorkBook workbook = WorkBook.Load(stream);
// }

Cela initialise le classeur en tant qu'instance WorkBook . Pour ouvrir une WorkSheet spécifique, récupérez-la dans la collection WorkSheets . Le guide " Gérer les feuilles de calcul " fournit plus de détails sur les opérations sur les feuilles de calcul :

// Access the first worksheet in the workbook
WorkSheet sheet = workbook.WorkSheets.First();

// Alternative ways to access worksheets
WorkSheet sheetByIndex = workbook.WorkSheets[0];  // By index
WorkSheet sheetByName = workbook.GetWorkSheet("Sheet1");  // By name

// Access the first worksheet in the workbook
WorkSheet sheet = workbook.WorkSheets.First();

// Alternative ways to access worksheets
WorkSheet sheetByIndex = workbook.WorkSheets[0];  // By index
WorkSheet sheetByName = workbook.GetWorkSheet("Sheet1");  // By name

Ceci permet d'accéder à la première feuille du fichier Excel, prête pour la lecture et l'écriture.

Feuille de calcul Excel présentant les données de 5 employés, avec des colonnes pour le nom, la fonction et le salaire, des en-têtes de cellules formatés et des bordures de cellules. Fichier Excel

Comment lire les données des cellules Excel ?

Une fois le fichier Excel ouvert, il est prêt à lire les données. La lecture de données à partir de fichiers Excel en C# avec IronXL est simple. Vous pouvez lire les valeurs des cellules en spécifiant la référence de la cellule à l'aide de la fonctionnalité Sélectionner une plage .

Le code suivant récupère la valeur d'une cellule :

// Select the cell using Excel notation and retrieve its integer value
int cellValue = sheet["C2"].IntValue;

// You can also retrieve values in different formats
string textValue = sheet["C2"].StringValue;
decimal decimalValue = sheet["C2"].DecimalValue;
DateTime dateValue = sheet["C2"].DateTimeValue;
bool boolValue = sheet["C2"].BoolValue;

// Display the value in the console
Console.WriteLine($"Cell C2 contains: {cellValue}");

// Check if cell is empty before reading
if (!sheet["C2"].IsEmpty)
{
    Console.WriteLine($"Cell value: {sheet["C2"].Value}");
}

// Select the cell using Excel notation and retrieve its integer value
int cellValue = sheet["C2"].IntValue;

// You can also retrieve values in different formats
string textValue = sheet["C2"].StringValue;
decimal decimalValue = sheet["C2"].DecimalValue;
DateTime dateValue = sheet["C2"].DateTimeValue;
bool boolValue = sheet["C2"].BoolValue;

// Display the value in the console
Console.WriteLine($"Cell C2 contains: {cellValue}");

// Check if cell is empty before reading
if (!sheet["C2"].IsEmpty)
{
    Console.WriteLine($"Cell value: {sheet["C2"].Value}");
}

La sortie est la suivante :

! Fenêtre de la console de débogage de Microsoft Visual Studio affichant l'extraction réussie de la valeur " 100000 " de la cellule C2 d'Excel avec un message de sortie contextuel Lire Excel

Pour lire les données d'une plage de cellules, utilisez une boucle pour parcourir la plage spécifiée. L'exemple " Sélectionner une plage Excel " propose d'autres modèles :

// Iterate through a range of cells and display their address and text content
foreach (var cell in sheet["A2:A6"])
{
    Console.WriteLine("Cell {0} has value '{1}'", cell.AddressString, cell.Text);
}

// Read an entire column
foreach (var cell in sheet.GetColumn(0))  // Column A
{
    if (!cell.IsEmpty)
    {
        Console.WriteLine($"Column A value: {cell.Text}");
    }
}

// Read an entire row
foreach (var cell in sheet.GetRow(1))  // Row 2
{
    Console.WriteLine($"Row 2 value: {cell.Text}");
}

// Iterate through a range of cells and display their address and text content
foreach (var cell in sheet["A2:A6"])
{
    Console.WriteLine("Cell {0} has value '{1}'", cell.AddressString, cell.Text);
}

// Read an entire column
foreach (var cell in sheet.GetColumn(0))  // Column A
{
    if (!cell.IsEmpty)
    {
        Console.WriteLine($"Column A value: {cell.Text}");
    }
}

// Read an entire row
foreach (var cell in sheet.GetRow(1))  // Row 2
{
    Console.WriteLine($"Row 2 value: {cell.Text}");
}

Chaque valeur de la plage de cellules A2:A6 est extraite et affichée sur la console.

! Console de débogage Microsoft Visual Studio avec coloration syntaxique affichant la sortie de la lecture de la plage Excel A2:A6, présentant les noms des employés John, Sara, Peter, Method et Katherine Lire une plage de cellules

Pour des exemples de lecture et d'écriture plus détaillés, consultez le tutoriel de lecture Excel en C# . Vous pouvez également convertir les données Excel en DataTables pour une manipulation plus aisée :

// Convert worksheet to DataTable for easier data manipulation
DataTable dataTable = sheet.ToDataTable(true);  // true = first row contains headers

// Access data using DataTable methods
foreach (DataRow row in dataTable.Rows)
{
    Console.WriteLine($"Employee: {row["Name"]}, Salary: {row["Salary"]}");
}

// Convert worksheet to DataTable for easier data manipulation
DataTable dataTable = sheet.ToDataTable(true);  // true = first row contains headers

// Access data using DataTable methods
foreach (DataRow row in dataTable.Rows)
{
    Console.WriteLine($"Employee: {row["Name"]}, Salary: {row["Salary"]}");
}

Comment créer un nouveau fichier Excel ?

IronXL facilite également la création de nouveaux classeurs pour la sauvegarde et la récupération des données. Le guide " Créer des feuilles de calcul " fournit des exemples complets.

Vous pouvez créer un nouveau fichier Excel avec une seule ligne de code :

// Create a new workbook with the XLSX format
WorkBook workBook = new WorkBook(ExcelFileFormat.XLSX);

// Alternative: Create with XLS format for compatibility
WorkBook xlsWorkBook = new WorkBook(ExcelFileFormat.XLS);

// Set workbook metadata
workBook.Metadata.Title = "Employee Data";
workBook.Metadata.Author = "Your Name";
workBook.Metadata.Keywords = "employees, salary, data";

// Create a new workbook with the XLSX format
WorkBook workBook = new WorkBook(ExcelFileFormat.XLSX);

// Alternative: Create with XLS format for compatibility
WorkBook xlsWorkBook = new WorkBook(ExcelFileFormat.XLS);

// Set workbook metadata
workBook.Metadata.Title = "Employee Data";
workBook.Metadata.Author = "Your Name";
workBook.Metadata.Keywords = "employees, salary, data";

Ensuite, créez une feuille de calcul et ajoutez-y des données. Pour des modèles de création plus avancés, consultez Créer un nouveau fichier Excel .

Comment ajouter des feuilles de travail à un classeur ?

// Create a worksheet named "GDPByCountry" in the workbook
WorkSheet workSheet = workBook.CreateWorkSheet("GDPByCountry");

// Create multiple worksheets at once
WorkSheet sheet2 = workBook.CreateWorkSheet("PopulationData");
WorkSheet sheet3 = workBook.CreateWorkSheet("Summary");

// Copy an existing worksheet
WorkSheet copiedSheet = workSheet.CopySheet("GDPByCountryCopy");

// Create a worksheet named "GDPByCountry" in the workbook
WorkSheet workSheet = workBook.CreateWorkSheet("GDPByCountry");

// Create multiple worksheets at once
WorkSheet sheet2 = workBook.CreateWorkSheet("PopulationData");
WorkSheet sheet3 = workBook.CreateWorkSheet("Summary");

// Copy an existing worksheet
WorkSheet copiedSheet = workSheet.CopySheet("GDPByCountryCopy");

Ce code ajoute une feuille de calcul nommée " GDPByCountry " au classeur, vous permettant d'ajouter des valeurs aux cellules. Apprenez-en davantage sur la gestion et la copie des feuilles de calcul .

Pour définir une valeur pour une cellule spécifique, utilisez le code ci-dessous :

// Set the value of cell A1 to "Example"
workSheet["A1"].Value = "Example";

// Add different types of data
workSheet["A2"].Value = 12345;  // Integer
workSheet["A3"].Value = 99.99m;  // Decimal
workSheet["A4"].Value = DateTime.Now;  // Date
workSheet["A5"].Value = true;  // Boolean

// Add formulas
workSheet["B1"].Formula = "=SUM(A2:A3)";

// Set multiple cells at once using a range
workSheet["C1:C5"].Value = "Bulk Value";

// Save the workbook
workBook.SaveAs("output.xlsx");

// Set the value of cell A1 to "Example"
workSheet["A1"].Value = "Example";

// Add different types of data
workSheet["A2"].Value = 12345;  // Integer
workSheet["A3"].Value = 99.99m;  // Decimal
workSheet["A4"].Value = DateTime.Now;  // Date
workSheet["A5"].Value = true;  // Boolean

// Add formulas
workSheet["B1"].Formula = "=SUM(A2:A3)";

// Set multiple cells at once using a range
workSheet["C1:C5"].Value = "Bulk Value";

// Save the workbook
workBook.SaveAs("output.xlsx");

Le résultat final est :

! Feuille de calcul Excel montrant la cellule A1 remplie avec le texte " Exemple " ajouté par programmation en C#, avec l'onglet de la feuille de calcul GDPByCountry visible et la mise en surbrillance de la cellule pour indiquer la valeur ajoutée Ajouter de la valeur à la cellule

Travailler avec différents formats Excel

IronXL prend en charge plusieurs formats Excel. Voici comment gérer différents types de fichiers :

// Convert between formats
WorkBook workbook = WorkBook.Load("data.csv");
workbook.SaveAs("data.xlsx");  // Convert CSV to XLSX

// Export to different formats
workbook.SaveAsCsv("output.csv", ";");  // CSV with semicolon delimiter
workbook.SaveAsJson("output.json");     // Export as JSON
workbook.SaveAsXml("output.xml");       // Export as XML

// Convert between formats
WorkBook workbook = WorkBook.Load("data.csv");
workbook.SaveAs("data.xlsx");  // Convert CSV to XLSX

// Export to different formats
workbook.SaveAsCsv("output.csv", ";");  // CSV with semicolon delimiter
workbook.SaveAsJson("output.json");     // Export as JSON
workbook.SaveAsXml("output.xml");       // Export as XML

Apprenez-en davantage sur la conversion des types de fichiers tableur et la conversion de XLSX en CSV, JSON, XML .

Gestion des erreurs et meilleures pratiques

Lors de la manipulation de fichiers Excel, mettez en œuvre une gestion des erreurs appropriée :

try
{
    WorkBook workbook = WorkBook.Load("test.xlsx");
    WorkSheet sheet = workbook.GetWorkSheet("Sheet1");

    // Check if sheet exists
    if (sheet == null)
    {
        Console.WriteLine("Worksheet not found!");
        return;
    }

    // Process data
    var value = sheet["A1"].Value;
}
catch (Exception ex)
{
    Console.WriteLine($"Error reading Excel file: {ex.Message}");
}

try
{
    WorkBook workbook = WorkBook.Load("test.xlsx");
    WorkSheet sheet = workbook.GetWorkSheet("Sheet1");

    // Check if sheet exists
    if (sheet == null)
    {
        Console.WriteLine("Worksheet not found!");
        return;
    }

    // Process data
    var value = sheet["A1"].Value;
}
catch (Exception ex)
{
    Console.WriteLine($"Error reading Excel file: {ex.Message}");
}

Pour les applications de production, envisagez de configurer la journalisation et de mettre en œuvre des modèles de gestion des erreurs appropriés.