Untitled Blog Post

Qu'est-ce qu'IronXL et pourquoi l'utiliser pour la génération de fichiers Excel ?

IronXL est une bibliothèque Excel .NET qui permet aux développeurs de créer, de lire et de manipuler des fichiers Excel directement à partir de code source C# ou Visual Basic. Contrairement aux approches d'interopérabilité de Microsoft Office qui reposent sur l'application Excel complète ou sur la rétro-ingénierie via le SDK Open XML, IronXL fonctionne sur les environnements Windows, Linux, macOS et cloud sans nécessiter l'installation d'Excel ni de dépendances tierces. Cela le rend idéal pour les rapports Excel côté serveur, les flux de travail automatisés et les applications Web construites sur .NET Core ou le framework .NET.

Pour les équipes qui passent de processus Excel manuels, d'anciennes bibliothèques ou de flux de travail d'outils de productivité Open XML nécessitant la navigation dans différents espaces de noms XML, IronXL fournit une API intuitive. Il prend en charge à la fois les fichiers XLS traditionnels et les fichiers XLSX modernes, qui sont essentiellement des fichiers ZIP contenant des fichiers XML et divers dossiers. Que vous souhaitiez générer un nouveau classeur Excel , manipuler plusieurs feuilles de calcul ou charger des données Excel à partir d'un code externe, IronXL simplifie considérablement le processus sans qu'il soit nécessaire de comprendre les formats sous-jacents.

Premiers pas avec IronXL pour créer un fichier Excel

Configurer IronXL pour créer des rapports Excel ne prend que quelques minutes. Installez la bibliothèque via le gestionnaire de packages NuGet dans Visual Studio :

Install-Package IronXL.Excel

Téléchargez IronXL dès aujourd'hui et commencez à automatiser la génération de vos rapports Excel.

Une fois installé, la création de votre premier rapport Excel ne nécessite que quelques lignes de code :

using IronXL;
// Create a new Excel workbook for reports
WorkBook workBook = WorkBook.Create(ExcelFileFormat.XLSX);
// Add a worksheet for the report
WorkSheet reportSheet = workBook.CreateWorkSheet("Monthly Report");
// Add a title
reportSheet["A1"].Value = "Sales Report - January 2024";
reportSheet["A1"].Style.Font.Bold = true;
// Save the Excel report
workBook.SaveAs("MonthlyReport.xlsx");

using IronXL;
// Create a new Excel workbook for reports
WorkBook workBook = WorkBook.Create(ExcelFileFormat.XLSX);
// Add a worksheet for the report
WorkSheet reportSheet = workBook.CreateWorkSheet("Monthly Report");
// Add a title
reportSheet["A1"].Value = "Sales Report - January 2024";
reportSheet["A1"].Style.Font.Bold = true;
// Save the Excel report
workBook.SaveAs("MonthlyReport.xlsx");

Ce code crée un nouveau fichier de rapport Excel avec un titre formaté. La syntaxe familière de référence de cellule (reportSheet["A1"]) permet aux développeurs de spécifier facilement l'emplacement exact où les données doivent apparaître, tout comme lorsqu'on travaille manuellement avec Excel.

Chargement de données à partir de sources multiples

Dans le monde réel, les rapports Excel utilisent rarement des données statiques. IronXL excelle dans l'intégration de données Excel provenant de divers formats, d'API, de nouvelles sources DataTable, ou même de plusieurs fichiers XML différents. Cela le rend idéal pour la génération dynamique de rapports Excel en C# dans des applications côté serveur ou Web.

using System.Data;
using System.Data.SqlClient;
// Fetch data from database
string connectionString = "Server=localhost;Database=Sales;Integrated Security=true;";
DataTable salesData = new DataTable();
using (SqlConnection conn = new SqlConnection(connectionString))
{
    SqlDataAdapter adapter = new SqlDataAdapter(
        "SELECT ProductName, Quantity, Revenue FROM MonthlySales", conn);
    adapter.Fill(salesData);
}
// Create Excel report from DataTable
WorkBook workBook = WorkBook.Create();
WorkSheet sheet = workBook.CreateWorkSheet("Sales Data");
// Add headers
sheet["A1"].Value = "Product";
sheet["B1"].Value = "Quantity";  
sheet["C1"].Value = "Revenue";
// Populate data
int row = 2;
foreach (DataRow dataRow in salesData.Rows)
{
    sheet[$"A{row}"].Value = dataRow["ProductName"];
    sheet[$"B{row}"].Value = dataRow["Quantity"];
    sheet[$"C{row}"].Value = dataRow["Revenue"];
    row++;
}

using System.Data;
using System.Data.SqlClient;
// Fetch data from database
string connectionString = "Server=localhost;Database=Sales;Integrated Security=true;";
DataTable salesData = new DataTable();
using (SqlConnection conn = new SqlConnection(connectionString))
{
    SqlDataAdapter adapter = new SqlDataAdapter(
        "SELECT ProductName, Quantity, Revenue FROM MonthlySales", conn);
    adapter.Fill(salesData);
}
// Create Excel report from DataTable
WorkBook workBook = WorkBook.Create();
WorkSheet sheet = workBook.CreateWorkSheet("Sales Data");
// Add headers
sheet["A1"].Value = "Product";
sheet["B1"].Value = "Quantity";  
sheet["C1"].Value = "Revenue";
// Populate data
int row = 2;
foreach (DataRow dataRow in salesData.Rows)
{
    sheet[$"A{row}"].Value = dataRow["ProductName"];
    sheet[$"B{row}"].Value = dataRow["Quantity"];
    sheet[$"C{row}"].Value = dataRow["Revenue"];
    row++;
}

var salesRecords = new List<SalesRecord>
{
    new SalesRecord { Product = "Widget A", Units = 150, Price = 29.99m },
    new SalesRecord { Product = "Widget B", Units = 82, Price = 49.99m }
};
// Convert collection to Excel
for (int i = 0; i < salesRecords.Count; i++)
{
    sheet[$"A{i+2}"].Value = salesRecords[i].Product;
    sheet[$"B{i+2}"].Value = salesRecords[i].Units;
    sheet[$"C{i+2}"].Value = salesRecords[i].Price;
}

var salesRecords = new List<SalesRecord>
{
    new SalesRecord { Product = "Widget A", Units = 150, Price = 29.99m },
    new SalesRecord { Product = "Widget B", Units = 82, Price = 49.99m }
};
// Convert collection to Excel
for (int i = 0; i < salesRecords.Count; i++)
{
    sheet[$"A{i+2}"].Value = salesRecords[i].Product;
    sheet[$"B{i+2}"].Value = salesRecords[i].Units;
    sheet[$"C{i+2}"].Value = salesRecords[i].Price;
}

Mise en forme de rapports Excel professionnels

Les données brutes seules ne permettent pas d'établir un rapport professionnel. IronXL offre des options complètes de mise en forme des cellules pour créer des fichiers Excel soignés et prêts à l'emploi en entreprise. Le code suivant montre à quel point c'est facile avec IronXL :

using IronXL;
using IronXl.Styles;
class Program
{
    static void Main(string[] args)
    {
        // Create a new workbook
        var workbook = WorkBook.Create(ExcelFileFormat.XLSX);
        // Add a new worksheet
        var sheet = workbook.CreateWorkSheet("MySheet");
        // Add header values
        sheet["A1"].Value = "Product";
        sheet["B1"].Value = "Quantity";
        sheet["C1"].Value = "Price";
        // Add sample data rows
        sheet["A2"].Value = "Laptop";
        sheet["B2"].Value = 5;
        sheet["C2"].Value = 1299.99;
        sheet["A3"].Value = "Headphones";
        sheet["B3"].Value = 15;
        sheet["C3"].Value = 199.50;
        sheet["A4"].Value = "Keyboard";
        sheet["B4"].Value = 10;
        sheet["C4"].Value = 89.99;
        sheet["A5"].Value = "Monitor";
        sheet["B5"].Value = 7;
        sheet["C5"].Value = 249.00;
        // Header formatting
        var headerRange = sheet["A1:C1"];
        headerRange.Style.Font.Bold = true;
        headerRange.Style.SetBackgroundColor("#4472C4");
        headerRange.Style.Font.Color = "#FFFFFF";
        headerRange.Style.BottomBorder.Type = BorderType.Thick;
        // Number formatting for currency  
        sheet["C:C"].FormatString = "$#,##0.00";
        // Alternating row colors for readability
        for (int row = 2; row <= 10; row++)
        {
            if (row % 2 == 0)
            {
                sheet[$"A{row}:C{row}"].Style.SetBackgroundColor("#F2F2F2");
            }
        }
        // Column width adjustment
        sheet.Columns[0].Width = 15 * 256; // Width in 1/256th of character width
        sheet.Columns[2].Width = 12 * 256;
        // Add borders around data
        var dataRange = sheet["A1:C10"];
        dataRange.Style.TopBorder.Type = BorderType.Thin;
        dataRange.Style.RightBorder.Type = BorderType.Thin;
        dataRange.Style.BottomBorder.Type = BorderType.Thin;
        dataRange.Style.LeftBorder.Type = BorderType.Thin;
        // Save the workbook to a file
        workbook.SaveAs("MyWorkbook.xlsx");
    }
}

using IronXL;
using IronXl.Styles;
class Program
{
    static void Main(string[] args)
    {
        // Create a new workbook
        var workbook = WorkBook.Create(ExcelFileFormat.XLSX);
        // Add a new worksheet
        var sheet = workbook.CreateWorkSheet("MySheet");
        // Add header values
        sheet["A1"].Value = "Product";
        sheet["B1"].Value = "Quantity";
        sheet["C1"].Value = "Price";
        // Add sample data rows
        sheet["A2"].Value = "Laptop";
        sheet["B2"].Value = 5;
        sheet["C2"].Value = 1299.99;
        sheet["A3"].Value = "Headphones";
        sheet["B3"].Value = 15;
        sheet["C3"].Value = 199.50;
        sheet["A4"].Value = "Keyboard";
        sheet["B4"].Value = 10;
        sheet["C4"].Value = 89.99;
        sheet["A5"].Value = "Monitor";
        sheet["B5"].Value = 7;
        sheet["C5"].Value = 249.00;
        // Header formatting
        var headerRange = sheet["A1:C1"];
        headerRange.Style.Font.Bold = true;
        headerRange.Style.SetBackgroundColor("#4472C4");
        headerRange.Style.Font.Color = "#FFFFFF";
        headerRange.Style.BottomBorder.Type = BorderType.Thick;
        // Number formatting for currency  
        sheet["C:C"].FormatString = "$#,##0.00";
        // Alternating row colors for readability
        for (int row = 2; row <= 10; row++)
        {
            if (row % 2 == 0)
            {
                sheet[$"A{row}:C{row}"].Style.SetBackgroundColor("#F2F2F2");
            }
        }
        // Column width adjustment
        sheet.Columns[0].Width = 15 * 256; // Width in 1/256th of character width
        sheet.Columns[2].Width = 12 * 256;
        // Add borders around data
        var dataRange = sheet["A1:C10"];
        dataRange.Style.TopBorder.Type = BorderType.Thin;
        dataRange.Style.RightBorder.Type = BorderType.Thin;
        dataRange.Style.BottomBorder.Type = BorderType.Thin;
        dataRange.Style.LeftBorder.Type = BorderType.Thin;
        // Save the workbook to a file
        workbook.SaveAs("MyWorkbook.xlsx");
    }
}

Ces options de mise en forme transforment des données de base en rapports professionnels. L'API de style couvre tout, des polices et des couleurs aux bordures et à l'alignement , offrant un contrôle total sur l'apparence du rapport Excel. Pour des besoins de mise en forme avancés, explorez la mise en forme conditionnelle pour mettre automatiquement en évidence les données importantes.

Comment créer des rapports Excel en C# avec IronXL: Figure 3 - Sortie Excel formatée

Utilisation de formules pour les calculs dynamiques des rapports Excel

La puissance d'Excel réside dans ses formules, et IronXL prend entièrement en charge la création de formules Excel :

// Add formula for row totals
sheet["D1"].Value = "Total";
sheet["D2"].Formula = "=B2*C2";
// Copy formula down the column
for (int row = 3; row <= 10; row++)
{
    sheet[$"D{row}"].Formula = $"=B{row}*C{row}";
}
// Add summary formulas
sheet["A12"].Value = "Summary";
sheet["B12"].Formula = "=SUM(B2:B10)";
sheet["C12"].Formula = "=AVERAGE(C2:C10)";
sheet["D12"].Formula = "=SUM(D2:D10)";

// Add formula for row totals
sheet["D1"].Value = "Total";
sheet["D2"].Formula = "=B2*C2";
// Copy formula down the column
for (int row = 3; row <= 10; row++)
{
    sheet[$"D{row}"].Formula = $"=B{row}*C{row}";
}
// Add summary formulas
sheet["A12"].Value = "Summary";
sheet["B12"].Formula = "=SUM(B2:B10)";
sheet["C12"].Formula = "=AVERAGE(C2:C10)";
sheet["D12"].Formula = "=SUM(D2:D10)";

La prise en charge des formules inclut toutes les fonctions Excel standard telles que SOMME, MOYENNE, SI, RECHERCHEV, et bien plus encore. IronXL gère automatiquement les dépendances des formules et l'ordre de calcul, ce qui simplifie la génération de rapports Excel avec des calculs complexes. Apprenez-en davantage sur les fonctions mathématiques dans IronXL .

Comment créer des rapports Excel en C# avec IronXL: Figure 4 - Exemple de résultat avec formules

Rapports basés sur des modèles

Pour les rapports Excel récurrents ou les classeurs standardisés, IronXL prend en charge la génération basée sur des modèles, permettant aux développeurs de créer un fichier Excel à partir d'un modèle sans avoir à gérer le SDK Open XML, les fichiers rels ou divers dossiers :

// Load existing template
WorkBook templateBook = WorkBook.Load("ReportTemplate.xlsx");
WorkSheet templateSheet = templateBook.DefaultWorkSheet;
// Find and replace template markers
foreach (var cell in templateSheet["A1:Z100"])
{
    if (cell.Text.Contains("{{CompanyName}}"))
        cell.Value = cell.Text.Replace("{{CompanyName}}", "Acme Corp");
    if (cell.Text.Contains("{{ReportDate}}"))
        cell.Value = cell.Text.Replace("{{ReportDate}}", DateTime.Now.ToString("MMMM yyyy"));
}
// Save as new report
templateBook.SaveAs($"Report_{DateTime.Now:yyyyMMdd}.xlsx");

// Load existing template
WorkBook templateBook = WorkBook.Load("ReportTemplate.xlsx");
WorkSheet templateSheet = templateBook.DefaultWorkSheet;
// Find and replace template markers
foreach (var cell in templateSheet["A1:Z100"])
{
    if (cell.Text.Contains("{{CompanyName}}"))
        cell.Value = cell.Text.Replace("{{CompanyName}}", "Acme Corp");
    if (cell.Text.Contains("{{ReportDate}}"))
        cell.Value = cell.Text.Replace("{{ReportDate}}", DateTime.Now.ToString("MMMM yyyy"));
}
// Save as new report
templateBook.SaveAs($"Report_{DateTime.Now:yyyyMMdd}.xlsx");

Cette approche permet de conserver une mise en forme cohérente tout en mettant à jour le contenu dynamique, ce qui est idéal pour les rapports mensuels ou les documents standardisés.

Comment créer des rapports Excel en C# avec IronXL: Figure 5 - Comparaison entre le modèle de rapport et notre fichier Excel créé à partir de ce modèle.

Meilleures pratiques et dépannage

Lors de la mise en œuvre de la génération de rapports Excel, gardez ces conseils à l'esprit :

• Utilisation de la mémoire avec les fichiers volumineux : Traitez les données par blocs plutôt que de charger des ensembles de données entiers ( recommandations de Microsoft pour les fichiers Excel volumineux ).
• Problèmes de formatage de date : utilisez DateTime.ToOADate() pour les dates compatibles avec Excel ( explication du système de dates d'Excel ).
• Erreurs de verrouillage de fichier : libérez toujours correctement les objets Excel à l'aide d'instructions using ou des nouvelles approches MemoryStream. Styles manquants : certaines propriétés de style nécessitent de définir d'abord la couleur d'arrière-plan.

Conclusion

IronXL transforme la génération de rapports Excel, un processus manuel fastidieux, en un flux de travail automatisé et fiable. Grâce à son API intuitive, sa compatibilité multiplateforme et son ensemble complet de fonctionnalités, les développeurs peuvent créer des rapports Excel professionnels en quelques minutes plutôt qu'en quelques heures. La combinaison d'une intégration de données facile, d'options de mise en forme puissantes et d'une prise en charge des formules fait d'IronXL un outil essentiel pour tout développeur C# travaillant avec des rapports Excel. Pour les développeurs intéressés, IronXL propose un essai gratuit et d'autres options de licence pour les entreprises et les particuliers.

Commencez avec IronXL maintenant.

Commencer gratuitement