Read Excel Files in ASP.NET MVC Using C# with IronXL

Pourquoi Visual Studio 2022 est-il le plus adapté ?

À l'aide de Visual Studio 2022, créez un nouveau projet ASP.NET. Visual Studio 2022 offre une excellente prise en charge des frameworks .NET 6+, une IntelliSense améliorée pour les méthodes IronXL et de meilleures performances lors de l'utilisation de fichiers Excel volumineux. L'intégration NuGet de l'IDE rend l'installation de IronXL particulièrement simple.

Quel modèle de projet dois-je choisir ?

Pour la lecture de fichiers Excel en ASP.NET, choisissez le modèle "ASP.NET Core Web App (Model-View-Controller)". Ce modèle offre une structure MVC propre qui sépare le traitement des données (lecture d'Excel) de la logique de présentation. Le modèle MVC fonctionne parfaitement avec la conversion IronXL de DataTable, vous permettant de charger des feuilles de calcul dans les contrôleurs et de les afficher dans les vues de manière transparente.

Quelle est la version de .NET recommandée?

IronXL fonctionne avec .NET Framework 4.6.2+ et .NET Core 3.1+. Pour les nouveaux projets ASP.NET MVC, utilisez .NET 6.0 ou une version plus récente pour des performances et une sécurité optimales. Ces versions offrent une meilleure gestion de la mémoire lors du traitement de fichiers Excel volumineux et une meilleure prise en charge asynchrone/attente pour la conversion des types de fichiers de feuilles de calcul.

Quelle est la configuration requise pour l'installation?

Quelle est la méthode d'installation la plus rapide ?

Après avoir créé le nouveau projet, installez la bibliothèque IronXL. Suivez ces étapes pour installer IronXL. Ouvrez la console du gestionnaire de packages NuGet et exécutez la commande suivante :

Install-Package IronXl.Excel

Comment puis-je vérifier l'installation ?

Pour vérifier que IronXL est correctement installé, vérifiez les dépendances de votre projet dans l'explorateur de solutions. Vous devriez voir "IronXL" listé sous "Dependencies > Packages". De plus, essayez d'ajouter using IronXL; en haut de votre fichier de contrôleur - IntelliSense devrait reconnaître immédiatement l'espace de noms. Pour résoudre les problèmes d'installation, consultez le guide des licences.

Quel est le code contenu dans l'action du contrôleur ?

Ouvrez le contrôleur par défaut de votre projet ASP.NET (par exemple, HomeController.cs) et remplacez la méthode Index par le code suivant :

using IronXL;
using System.Data;

public ActionResult Index()
{
    // Load the Excel workbook from a specified path.
    WorkBook workBook = WorkBook.Load(@"C:\Files\Customer Data.xlsx");

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

    // Convert the worksheet data to a DataTable object.
    // The 'true' parameter uses the first row as column headers
    var dataTable = workSheet.ToDataTable(true);

    // Send the DataTable to the view for rendering.
    return View(dataTable);
}

using IronXL;
using System.Data;

public ActionResult Index()
{
    // Load the Excel workbook from a specified path.
    WorkBook workBook = WorkBook.Load(@"C:\Files\Customer Data.xlsx");

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

    // Convert the worksheet data to a DataTable object.
    // The 'true' parameter uses the first row as column headers
    var dataTable = workSheet.ToDataTable(true);

    // Send the DataTable to the view for rendering.
    return View(dataTable);
}

Pourquoi utiliser DataTable plutôt que d'autres formats ?

Dans la méthode d'action Index, chargez le fichier Excel en utilisant la méthode IronXL de Load. Le chemin d'accès au fichier Excel (y compris le nom du fichier) est fourni en tant que paramètre à l'appel de méthode. Ensuite, sélectionnez la première feuille Excel comme feuille de travail et chargez les données qu'elle contient dans un objet DataTable. Enfin, envoyez le DataTable au frontend.

DataTable est idéal pour ASP.NET MVC car il s'intègre parfaitement aux vues Razor et fournit une prise en charge intégrée pour l'itération sur les lignes et les colonnes. Contrairement aux objets personnalisés, DataTable ne nécessite pas de mappage de modèle et gère automatiquement les types de données mixtes. Vous pouvez également exporter DataSet et DataTable vers Excel en cas de besoin.

Qu'en est-il de la gestion des erreurs pour les fichiers manquants ?

Une gestion robuste des erreurs garantit que votre application ne se bloque pas lorsque des fichiers Excel sont manquants ou corrompus. Voici une version améliorée avec une gestion correcte des exceptions :

public ActionResult Index()
{
    try
    {
        string filePath = @"C:\Files\Customer Data.xlsx";

        // Check if file exists before attempting to load
        if (!System.IO.File.Exists(filePath))
        {
            ViewBag.Error = "Excel file not found at specified location.";
            return View(new DataTable());
        }

        // Load workbook with error handling
        WorkBook workBook = WorkBook.Load(filePath);

        // Verify worksheet exists
        if (workBook.WorkSheets.Count == 0)
        {
            ViewBag.Error = "No worksheets found in the Excel file.";
            return View(new DataTable());
        }

        WorkSheet workSheet = workBook.WorkSheets.First();
        var dataTable = workSheet.ToDataTable(true);

        return View(dataTable);
    }
    catch (Exception ex)
    {
        // Log the exception (consider using a logging framework)
        ViewBag.Error = $"Error reading Excel file: {ex.Message}";
        return View(new DataTable());
    }
}

public ActionResult Index()
{
    try
    {
        string filePath = @"C:\Files\Customer Data.xlsx";

        // Check if file exists before attempting to load
        if (!System.IO.File.Exists(filePath))
        {
            ViewBag.Error = "Excel file not found at specified location.";
            return View(new DataTable());
        }

        // Load workbook with error handling
        WorkBook workBook = WorkBook.Load(filePath);

        // Verify worksheet exists
        if (workBook.WorkSheets.Count == 0)
        {
            ViewBag.Error = "No worksheets found in the Excel file.";
            return View(new DataTable());
        }

        WorkSheet workSheet = workBook.WorkSheets.First();
        var dataTable = workSheet.ToDataTable(true);

        return View(dataTable);
    }
    catch (Exception ex)
    {
        // Log the exception (consider using a logging framework)
        ViewBag.Error = $"Error reading Excel file: {ex.Message}";
        return View(new DataTable());
    }
}

Comment puis-je sélectionner différentes feuilles de calcul ?

IronXL offre plusieurs façons de sélectionner et de travailler avec des feuilles de calcul spécifiques . Vous pouvez accéder aux feuilles de calcul par index ou par nom, ou parcourir toutes les feuilles disponibles :

// Method 1: Select by worksheet name
WorkSheet namedSheet = workBook.GetWorkSheet("Sales Data");

// Method 2: Select by index (zero-based)
WorkSheet secondSheet = workBook.WorkSheets[1];

// Method 3: Select the default/active worksheet
WorkSheet defaultSheet = workBook.DefaultWorkSheet;

// Method 4: Iterate through all worksheets
foreach (WorkSheet sheet in workBook.WorkSheets)
{
    string sheetName = sheet.Name;
    // Process each worksheet
}

// Method 1: Select by worksheet name
WorkSheet namedSheet = workBook.GetWorkSheet("Sales Data");

// Method 2: Select by index (zero-based)
WorkSheet secondSheet = workBook.WorkSheets[1];

// Method 3: Select the default/active worksheet
WorkSheet defaultSheet = workBook.DefaultWorkSheet;

// Method 4: Iterate through all worksheets
foreach (WorkSheet sheet in workBook.WorkSheets)
{
    string sheetName = sheet.Name;
    // Process each worksheet
}

Quel est le code d'affichage requis ?

L'exemple suivant montre comment afficher le code DataTable renvoyé dans l'exemple précédent dans un navigateur Web.

Le fichier Excel utilisé dans cet exemple est présenté ci-dessous :

*fichier Excel*

Ouvrez le fichier index.cshtml (vue index) et remplacez le code par le code HTML suivant :

@{
    ViewData["Title"] = "Home Page";
}

@using System.Data
@model DataTable

<div class="text-center">
    <h1 class="display-4">Welcome to IronXL Read Excel MVC</h1>
</div>

@* Check for errors first *@
@if (ViewBag.Error != null)
{
    <div class="alert alert-danger">
        @ViewBag.Error
    </div>
}

@* Display table only if data exists *@
@if (Model != null && Model.Rows.Count > 0)
{
    <table class="table table-dark">
        <tbody>
            @foreach (DataRow row in Model.Rows)
            {
                <tr>
                    @for (int i = 0; i < Model.Columns.Count; i++)
                    {
                        <td>@row[i]</td>
                    }
                </tr>
            }
        </tbody>
    </table>
}
else
{
    <p>No data to display.</p>
}

@{
    ViewData["Title"] = "Home Page";
}

@using System.Data
@model DataTable

<div class="text-center">
    <h1 class="display-4">Welcome to IronXL Read Excel MVC</h1>
</div>

@* Check for errors first *@
@if (ViewBag.Error != null)
{
    <div class="alert alert-danger">
        @ViewBag.Error
    </div>
}

@* Display table only if data exists *@
@if (Model != null && Model.Rows.Count > 0)
{
    <table class="table table-dark">
        <tbody>
            @foreach (DataRow row in Model.Rows)
            {
                <tr>
                    @for (int i = 0; i < Model.Columns.Count; i++)
                    {
                        <td>@row[i]</td>
                    }
                </tr>
            }
        </tbody>
    </table>
}
else
{
    <p>No data to display.</p>
}

Pourquoi utiliser Bootstrap pour l'habillage des tableaux ?

Le code ci-dessus utilise le DataTable renvoyé par la méthode Index comme modèle. Chaque ligne du tableau est imprimée sur la page web à l'aide d'une boucle @for, y compris la mise en forme Bootstrap pour la décoration.

Bootstrap permet de concevoir des tableaux réactifs qui s'adaptent automatiquement aux différentes tailles d'écran, ce qui est essentiel pour les applications web modernes. La classe table-dark crée un tableau attrayant à thème sombre et facile à lire. Pour une mise en forme Excel plus avancée, comme les bordures et l'alignement des cellules ou les motifs et couleurs d'arrière-plan , IronXL fournit des méthodes supplémentaires pour accéder directement aux données structurées.

À quoi ressemble le résultat final?

L'exécution du projet produit les résultats ci-dessous :

*Tableau Bootstrap*

Comment ajouter des en-têtes au tableau ?

Pour afficher les en-têtes de colonne de votre fichier Excel, modifiez le code d'affichage afin d'inclure une section d'en-tête de tableau. Lors de l'appel à ToDataTable(true), IronXL utilise automatiquement la première ligne comme noms de colonnes :

@if (Model != null && Model.Rows.Count > 0)
{
    <table class="table table-dark">
        <thead>
            <tr>
                @foreach (DataColumn column in Model.Columns)
                {
                    <th>@column.ColumnName</th>
                }
            </tr>
        </thead>
        <tbody>
            @foreach (DataRow row in Model.Rows)
            {
                <tr>
                    @for (int i = 0; i < Model.Columns.Count; i++)
                    {
                        <td>@row[i]</td>
                    }
                </tr>
            }
        </tbody>
    </table>
}

@if (Model != null && Model.Rows.Count > 0)
{
    <table class="table table-dark">
        <thead>
            <tr>
                @foreach (DataColumn column in Model.Columns)
                {
                    <th>@column.ColumnName</th>
                }
            </tr>
        </thead>
        <tbody>
            @foreach (DataRow row in Model.Rows)
            {
                <tr>
                    @for (int i = 0; i < Model.Columns.Count; i++)
                    {
                        <td>@row[i]</td>
                    }
                </tr>
            }
        </tbody>
    </table>
}

Cette amélioration affiche correctement les en-têtes de colonnes, tels que " Nom du client ", " Frais de livraison " et " Prix unitaire ", à partir de votre fichier Excel. Pour les scénarios plus complexes impliquant des plages ou des tableaux nommés , IronXL propose des méthodes supplémentaires pour accéder directement aux données structurées.