Lesen von Excel-Dateien in ASP.NET MVC mit C# und IronXL

Warum eignet sich Visual Studio 2022 am besten für diese Aufgabe?

Erstellen Sie mit Visual Studio 2022 ein neues ASP.NET-Projekt. Visual Studio 2022 bietet hervorragende Unterstützung für .NET 6+ Frameworks, verbessertes IntelliSense für IronXL-Methoden und eine bessere Leistung bei der Arbeit mit großen Excel-Dateien. Die NuGet-Integration der IDE macht die Installation von IronXL besonders einfach.

Welche Projektvorlage soll ich wählen?

Für das Lesen von Excel-Dateien in ASP.NET wählen Sie die Vorlage "ASP.NET Core Web App (Model-View-Controller)". Diese Vorlage bietet eine saubere MVC-Struktur, die die Datenverarbeitung (Excel-Lesen) von der Präsentationslogik trennt. Das MVC-Muster funktioniert perfekt mit der IronXL-Konvertierung von DataTable, so dass Sie Tabellenkalkulationen nahtlos in Controllern laden und in Ansichten anzeigen können.

Welche .NET-Version wird empfohlen?

IronXL funktioniert mit .NET Framework 4.6.2+ und .NET Core 3.1+. Für neue ASP.NET MVC-Projekte sollten Sie .NET 6.0 oder höher verwenden, um optimale Leistung und Sicherheit zu gewährleisten. Diese Versionen bieten eine verbesserte Speicherverwaltung bei der Verarbeitung großer Excel-Dateien und eine bessere async/await-Unterstützung für die Konvertierung von Tabellenkalkulationsdateien.

Was sind die Installationsvoraussetzungen?

Nutzen Sie IronXL heute kostenlos in Ihrem Projekt.

Erster Schritt:

Jetzt kostenlos starten

Welche Installationsmethode ist am schnellsten?

Nach der Erstellung des neuen Projekts installieren Sie die IronXL-Bibliothek. Folgen Sie diesen Schritten, um IronXL zu installieren. Öffnen Sie die NuGet-Pakete-Verwaltungskonsole und führen Sie den folgenden Befehl aus:

Install-Package IronXL.Excel

Wie kann ich die Installation überprüfen?

Um zu überprüfen, ob IronXL richtig installiert ist, überprüfen Sie die Abhängigkeiten Ihres Projekts im Solution Explorer. IronXL" sollte unter "Abhängigkeiten > Pakete" aufgeführt sein. Versuchen Sie außerdem, using IronXL; am Anfang Ihrer Controller-Datei hinzuzufügen - IntelliSense sollte den Namensraum sofort erkennen. Informationen zur Behebung von Installationsproblemen finden Sie im Lizenzierungsleitfaden.

Welcher Code gehört in die Controller-Aktion?

Öffnen Sie den Standard-Controller in Ihrem ASP.NET-Projekt (z. B. HomeController.cs) und ersetzen Sie die Methode Index durch den folgenden Code:

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);
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

Warum DataTable anstelle von anderen Formaten verwenden?

In der Aktionsmethode Index laden Sie die Excel-Datei mit der Load-Methode von IronXL. Der Pfad der Excel-Datei (einschließlich des Dateinamens) wird als Parameter für den Methodenaufruf bereitgestellt. Wählen Sie dann das erste Excel-Blatt als Arbeitsblatt aus und laden Sie die darin enthaltenen Daten in ein DataTable-Objekt. Abschließend senden Sie die DataTable an das Frontend.

DataTable ist ideal für ASP.NET MVC, da es sich nahtlos in Razor-Ansichten integrieren lässt und integrierte Unterstützung für die Iteration durch Zeilen und Spalten bietet. Im Gegensatz zu benutzerdefinierten Objekten erfordert DataTable kein Model Mapping und verarbeitet gemischte Datentypen automatisch. Sie können DataSet und DataTable bei Bedarf auch zurück nach Excel exportieren.

Was ist mit der Fehlerbehandlung bei fehlenden Dateien?

Eine robuste Fehlerbehandlung sorgt dafür, dass Ihre Anwendung nicht abstürzt, wenn Excel-Dateien fehlen oder beschädigt sind. Hier ist eine verbesserte Version mit korrekter Ausnahmebehandlung:

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());
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

Wie kann ich verschiedene Arbeitsblätter auswählen?

IronXL bietet mehrere Möglichkeiten zur Auswahl und Arbeit mit bestimmten Arbeitsblättern. Sie können auf Arbeitsblätter nach Index oder Namen zugreifen oder alle verfügbaren Blätter durchgehen:

// 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
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

Welcher Ansichtscode ist erforderlich?

Das nächste Beispiel zeigt, wie man die DataTable, die im vorherigen Beispiel zurückgegeben wurde, in einem Webbrowser anzeigt.

Die in diesem Beispiel verwendete Excel-Arbeitsdatei ist unten abgebildet:

Excel-Datei

Öffnen Sie die index.cshtml (Indexansicht) und ersetzen Sie den Code durch den folgenden HTML-Code:

@{
    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>
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

Warum Bootstrap für die Gestaltung von Tabellen verwenden?

Der obige Code verwendet das von der Index-Methode zurückgegebene DataTable als Modell. Jede Zeile aus der Tabelle wird mit einer @for-Schleife auf der Webseite gedruckt, einschließlich Bootstrap-Formatierung zur Dekoration.

Bootstrap bietet responsive Tabellendesigns, die sich automatisch an unterschiedliche Bildschirmgrößen anpassen - ein entscheidender Faktor für moderne Webanwendungen. Die Klasse table-dark erzeugt eine attraktive, leicht zu lesende Tabelle mit dunklem Thema. Für fortgeschrittene Excel-Formatierungen wie Zellenränder und -ausrichtung oder Hintergrundmuster und -farben bietet IronXL zusätzliche Methoden zum direkten Zugriff auf strukturierte Daten.

Wie sieht die endgültige Ausgabe aus?

Die Ausführung des Projekts führt zu den unten gezeigten Ergebnissen:

Bootstrap-Tabelle

Wie kann ich Kopfzeilen in die Tabelle einfügen?

Um Spaltenüberschriften aus Ihrer Excel-Datei anzuzeigen, ändern Sie den Ansichtscode so, dass er einen Abschnitt für Tabellenüberschriften enthält. Beim Aufruf von ToDataTable(true), verwendet IronXL automatisch die erste Zeile als Spaltennamen:

@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>
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

Diese Erweiterung zeigt korrekte Spaltenüberschriften wie "Kundenname", "Versandkosten" und "Stückpreis" in Ihrer Excel-Datei an. Für komplexere Szenarien mit benannten Bereichen oder benannten Tabellen bietet IronXL zusätzliche Methoden für den direkten Zugriff auf strukturierte Daten.