Wie man Excel-Daten in C# importiert, liest und manipuliert

Warum kann StreamReader keine Excel-Dateien lesen?

StreamReader ist für reine Textdateien konzipiert und liest Zeichendaten Zeile für Zeile in einer bestimmten Kodierung. Excel-Dateien sehen zwar wie Tabellenkalkulationen aus, sind aber eigentlich komplexe binäre oder ZIP-komprimierte XML-Strukturen, die StreamReader nicht interpretieren kann. Moderne XLSX-Dateien folgen dem Office Open XML-Standard, während ältere XLS-Dateien ein proprietäres Binärformat verwenden.

static void Main(string[] args)
{
 // This code will NOT work - demonstrates the problem
 using (StreamReader reader = new StreamReader("ProductData.xlsx"))
 {
    string content = reader.ReadLine(); // Attempts to read Excel as text
    Console.WriteLine(content); // Outputs garbled binary data
 }
}

static void Main(string[] args)
{
 // This code will NOT work - demonstrates the problem
 using (StreamReader reader = new StreamReader("ProductData.xlsx"))
 {
    string content = reader.ReadLine(); // Attempts to read Excel as text
    Console.WriteLine(content); // Outputs garbled binary data
 }
}

Wenn Sie diesen Codeausschnitt ausführen, werden Ihnen anstelle Ihrer Tabellendaten Binärdaten wie "PK♥♦" oder ähnliche Zeichen angezeigt. Dies geschieht, weil XLSX-Dateien ZIP-Archive sind, die mehrere XML-Dateien enthalten, während XLS-Dateien ein proprietäres binäres Format verwenden. StreamReader erwartet einfachen Text und versucht, diese komplexen Strukturen als Zeichen zu interpretieren, was zu einer sinnlosen Ausgabe führt. Bei containerisierten Anwendungen würde der Versuch, native Excel-Bibliotheken oder COM Interop zu verwenden, die Installation von Microsoft Office im Container erfordern, was die Imagegröße und -komplexität drastisch erhöhen würde.

Wie liest man Excel-Dateien mit IronXL?

IronXL bietet eine unkomplizierte Lösung zum Lesen von Excel-Dateien in C#. Anders als StreamReader versteht IronXL die interne Struktur von Excel und bietet intuitive Methoden für den Zugriff auf Ihre Daten. Die Bibliothek unterstützt Windows, Linux, macOS und Docker-Container und eignet sich daher perfekt für moderne, plattformübergreifende Anwendungen. Für DevOps Teams bedeutet die Zero-Dependency-Architektur von IronXL, dass während der Bereitstellung keine nativen Bibliotheken oder COM-Komponenten verwaltet werden müssen.

! Diagramm zur plattformübergreifenden Unterstützung, das die .NET-Kompatibilität über verschiedene Versionen, Betriebssysteme, Entwicklungsumgebungen und Cloud-Plattformen hinweg zeigt, darunter Windows, Linux, macOS, Docker, Azure und AWS.

Zuerst installieren Sie IronXL über den NuGet-Paketmanager:

Install-Package IronXL.Excel

Terminalausgabe, die die erfolgreiche Installation des IronXL.Excel-Pakets und seiner Abhängigkeiten über die Paket-Manager-Konsole in Visual Studio anzeigt.

So lesen Sie eine Excel-Datei richtig:

using IronXL;
// Load the Excel file
WorkBook workbook = WorkBook.Load("sample.xlsx");
WorkSheet worksheet = workbook.DefaultWorkSheet;
// Read specific cell values
string cellValue = worksheet["A1"].StringValue;
Console.WriteLine($"Cell A1 contains: {cellValue}");
// Read a range of cells
foreach (var cell in worksheet["A1:C5"])
{
    Console.WriteLine($"{cell.AddressString}: {cell.Text}");
}

using IronXL;
// Load the Excel file
WorkBook workbook = WorkBook.Load("sample.xlsx");
WorkSheet worksheet = workbook.DefaultWorkSheet;
// Read specific cell values
string cellValue = worksheet["A1"].StringValue;
Console.WriteLine($"Cell A1 contains: {cellValue}");
// Read a range of cells
foreach (var cell in worksheet["A1:C5"])
{
    Console.WriteLine($"{cell.AddressString}: {cell.Text}");
}

Dieser Code lädt Ihre Excel-Datei erfolgreich und ermöglicht einen einfachen Zugriff auf die Zellwerte . Die WorkBook.Load-Methode erkennt automatisch das Dateiformat ( XLSX , XLS , XLSM, CSV ) und übernimmt die gesamte komplexe Datenanalyse intern. Sie können auf Zellen mit der gewohnten Excel-Notation wie "A1" oder auf Bereiche wie "A1:C5" zugreifen, wodurch der Code für jeden, der mit Excel vertraut ist, intuitiv verständlich wird.

Bei containerisierten Bereitstellungen können Sie problemlos Integritätsprüfungs-Endpunkte einbinden, die die Excel-Verarbeitungsfähigkeiten überprüfen:

// Health check endpoint for containerized apps
public async Task<IActionResult> HealthCheck()
{
    try
    {
        // Test Excel functionality
        using var workbook = WorkBook.Create(ExcelFileFormat.XLSX);
        var sheet = workbook.CreateWorkSheet("HealthCheck");
        sheet["A1"].Value = DateTime.UtcNow;

        // Convert to byte array for validation
        var bytes = workbook.ToByteArray();
        return Ok(new { 
            status = "healthy", 
            excelSupport = true,
            timestamp = DateTime.UtcNow 
        });
    }
    catch (Exception ex)
    {
        return StatusCode(503, new { 
            status = "unhealthy", 
            error = ex.Message 
        });
    }
}

// Health check endpoint for containerized apps
public async Task<IActionResult> HealthCheck()
{
    try
    {
        // Test Excel functionality
        using var workbook = WorkBook.Create(ExcelFileFormat.XLSX);
        var sheet = workbook.CreateWorkSheet("HealthCheck");
        sheet["A1"].Value = DateTime.UtcNow;

        // Convert to byte array for validation
        var bytes = workbook.ToByteArray();
        return Ok(new { 
            status = "healthy", 
            excelSupport = true,
            timestamp = DateTime.UtcNow 
        });
    }
    catch (Exception ex)
    {
        return StatusCode(503, new { 
            status = "unhealthy", 
            error = ex.Message 
        });
    }
}

Wie liest man Excel aus Memory Streams?

In realen Anwendungen müssen Excel-Dateien oft aus Streams und nicht von Datenträgern verarbeitet werden. Typische Anwendungsfälle sind beispielsweise das Hochladen von Webseiten, das Abrufen von Dateien aus Datenbanken oder die Verarbeitung von Daten aus Cloud-Speichern wie AWS S3 oder Azure Blob Storage . IronXL bewältigt diese Situationen reibungslos:

using IronXL;
using System.IO;
// Read Excel from a memory stream
byte[] fileBytes = File.ReadAllBytes("ProductData.xlsx");
using (MemoryStream stream = new MemoryStream(fileBytes))
{
    WorkBook workbook = WorkBook.FromStream(stream);
    WorkSheet worksheet = workbook.DefaultWorkSheet;
    // Process the data
    int rowCount = worksheet.RowCount;
    Console.WriteLine($"The worksheet has {rowCount} rows");
    // Read all data into a DataTable
    var dataTable = worksheet.ToDataTable(false);
    // Display DataTable row count 
    Console.WriteLine($"Loaded {dataTable.Rows.Count} data rows");
}

using IronXL;
using System.IO;
// Read Excel from a memory stream
byte[] fileBytes = File.ReadAllBytes("ProductData.xlsx");
using (MemoryStream stream = new MemoryStream(fileBytes))
{
    WorkBook workbook = WorkBook.FromStream(stream);
    WorkSheet worksheet = workbook.DefaultWorkSheet;
    // Process the data
    int rowCount = worksheet.RowCount;
    Console.WriteLine($"The worksheet has {rowCount} rows");
    // Read all data into a DataTable
    var dataTable = worksheet.ToDataTable(false);
    // Display DataTable row count 
    Console.WriteLine($"Loaded {dataTable.Rows.Count} data rows");
}

FromStream Methode WorkBook akzeptiert jeden Stream-Typ, egal ob MemoryStream , FileStream oder Netzwerkstream. Diese Flexibilität ermöglicht die Verarbeitung von Excel-Dateien aus verschiedenen Quellen, ohne sie vorher auf der Festplatte speichern zu müssen. Das Beispiel zeigt außerdem die Konvertierung von Tabellenblattdaten in eine DataTable , die sich nahtlos in Datenbanken und Datenbindungsszenarien integrieren lässt. Bei Microservices-Architekturen minimiert dieser stream-basierte Ansatz die Festplatten-E/A und verbessert die Leistung.

[HttpPost("upload")]
public async Task<IActionResult> ProcessExcelUpload(IFormFile file)
{
    if (file == null || file.Length == 0)
        return BadRequest("No file uploaded");

    using var stream = new MemoryStream();
    await file.CopyToAsync(stream);
    stream.Position = 0;

    var workbook = WorkBook.FromStream(stream);
    var worksheet = workbook.DefaultWorkSheet;

    // Process and return results
    var data = worksheet.ToDataSet();
    return Ok(new { 
        sheets = workbook.WorkSheets.Count,
        rows = worksheet.RowCount,
        processed = DateTime.UtcNow
    });
}

[HttpPost("upload")]
public async Task<IActionResult> ProcessExcelUpload(IFormFile file)
{
    if (file == null || file.Length == 0)
        return BadRequest("No file uploaded");

    using var stream = new MemoryStream();
    await file.CopyToAsync(stream);
    stream.Position = 0;

    var workbook = WorkBook.FromStream(stream);
    var worksheet = workbook.DefaultWorkSheet;

    // Process and return results
    var data = worksheet.ToDataSet();
    return Ok(new { 
        sheets = workbook.WorkSheets.Count,
        rows = worksheet.RowCount,
        processed = DateTime.UtcNow
    });
}

Wie konvertiert man zwischen Excel und CSV?

StreamReader kann zwar CSV-Dateien verarbeiten, aber oft ist eine Konvertierung zwischen Excel- und CSV-Formaten erforderlich. IronXL vereinfacht diese Konvertierung, was insbesondere für ETL-Pipelines und Datenintegrationsszenarien, wie sie in DevOps Workflows üblich sind, von Vorteil ist:

using IronXL;
// Load an Excel file and save as CSV
WorkBook workbook = WorkBook.Load("data.xlsx");
workbook.SaveAsCsv("output.csv");
// Load a CSV file and save as Excel
WorkBook csvWorkbook = WorkBook.LoadCSV("input.csv");
csvWorkbook.SaveAs("output.xlsx");
// Export specific worksheet to CSV
WorkSheet worksheet = workbook.WorkSheets[0];
worksheet.SaveAsCsv("worksheet1.csv");

using IronXL;
// Load an Excel file and save as CSV
WorkBook workbook = WorkBook.Load("data.xlsx");
workbook.SaveAsCsv("output.csv");
// Load a CSV file and save as Excel
WorkBook csvWorkbook = WorkBook.LoadCSV("input.csv");
csvWorkbook.SaveAs("output.xlsx");
// Export specific worksheet to CSV
WorkSheet worksheet = workbook.WorkSheets[0];
worksheet.SaveAsCsv("worksheet1.csv");

Diese Konvertierungen erhalten Ihre Daten bei gleichzeitiger Änderung des Dateiformats. Beim Konvertieren von Excel in CSV reduziert IronXL standardmäßig die erste Tabellenblattstruktur. Sie können jedoch angeben, welches Tabellenblatt exportiert werden soll. Die Konvertierung von CSV nach Excel erzeugt eine korrekt formatierte Tabelle, die die Datentypen beibehält und zukünftige Formatierungen und Formelergänzungen ermöglicht.

Für automatisierte Datenpipelines können Sie auch in die Formate JSON oder XML exportieren:

// Export Excel to multiple formats for data pipelines
var workbook = WorkBook.Load("report.xlsx");

// Export to JSON for API responses
string jsonData = workbook.ToJson();

// Export to HTML for web display
workbook.SaveAsHtml("report.html");

// Export to XML for integration systems
workbook.SaveAsXml("report.xml");

// Export specific range to DataTable for database insertion
var dataTable = workbook.DefaultWorkSheet["A1:D10"].ToDataTable();

// Export Excel to multiple formats for data pipelines
var workbook = WorkBook.Load("report.xlsx");

// Export to JSON for API responses
string jsonData = workbook.ToJson();

// Export to HTML for web display
workbook.SaveAsHtml("report.html");

// Export to XML for integration systems
workbook.SaveAsXml("report.xml");

// Export specific range to DataTable for database insertion
var dataTable = workbook.DefaultWorkSheet["A1:D10"].ToDataTable();

Bewährte Verfahren für die Containerbereitstellung

Für DevOps Ingenieure, die Excel-Verarbeitungsanwendungen bereitstellen, bietet IronXL mehrere Vorteile. Hier ist ein produktionsreifes Dockerfile, optimiert für die Excel-Verarbeitung:

FROM mcr.microsoft.com/dotnet/aspnet:8.0 AS base
WORKDIR /app
EXPOSE 80
EXPOSE 443

# Install any required system fonts for Excel rendering
RUN apt-get update && apt-get install -y \
    fontconfig \
    libfreetype6 \
    && rm -rf /var/lib/apt/lists/*

FROM mcr.microsoft.com/dotnet/sdk:8.0 AS build
WORKDIR /src
COPY ["YourApp.csproj", "."]
RUN dotnet restore
COPY . .
RUN dotnet build -c Release -o /app/build

FROM build AS publish
RUN dotnet publish -c Release -o /app/publish

FROM base AS final
WORKDIR /app
COPY --from=publish /app/publish .

# Set environment variables for IronXL
ENV IRONXL_LICENSE_KEY=${IRONXL_LICENSE_KEY}
ENV DOTNET_SYSTEM_GLOBALIZATION_INVARIANT=false

ENTRYPOINT ["dotnet", "YourApp.dll"]

Dieses Dockerfile stellt sicher, dass Ihre Excel-Verarbeitungsanwendung reibungslos in Containern mit minimalen Abhängigkeiten läuft. Die Lizenzierung erfolgt über Umgebungsvariablen, was die Verwaltung in verschiedenen Bereitstellungsumgebungen vereinfacht.

Was sind die nächsten Schritte für die Excel-Verarbeitung in C#?

die Unfähigkeit von StreamReader, Excel-Dateien zu verarbeiten, rührt von dem grundlegenden Unterschied zwischen einfachem Text und der komplexen Dateistruktur von Excel her. Während StreamReader perfekt für CSV- und andere Textformate funktioniert, erfordern echte Excel-Dateien eine spezielle Bibliothek wie IronXL, die die binären und XML-Strukturen darin versteht.

IronXL bietet mit seiner intuitiven API, der umfassenden Formatunterstützung und den nahtlosen Stream-Verarbeitungsfunktionen eine Komplettlösung. Egal ob Sie Webanwendungen , Desktop-Software oder Cloud-Dienste entwickeln, IronXL verarbeitet Excel-Dateien zuverlässig auf allen Plattformen. Die Unterstützung der Bibliothek für bedingte Formatierung , Diagramme , Formeln und erweiterte Excel-Funktionen macht sie zu einer Komplettlösung für Unternehmensanwendungen.

Für DevOps Teams machen die containerfreundliche Architektur, die minimalen Systemabhängigkeiten und die soliden Leistungseigenschaften von IronXL es zur idealen Wahl für moderne Cloud-native Anwendungen. Die Bibliothek unterstützt horizontale Skalierung , funktioniert nahtlos in Kubernetes-Pods und lässt sich gut in CI/CD-Pipelines integrieren.

Die IronXL-Lizenzseite zeigt vier Preisstufen (Lite, Plus, Professional und Unlimited) mit einem Schalter zwischen IronXL- und Iron Suite-Optionen und zeigt Preise für unbefristete Lizenzen von 749 $ bis 3.999 $ an.

Bereit, um mit Excel-Dateien richtig zu arbeiten? Laden Sie die kostenlose Testversion von IronXL herunter , die am besten zu den Anforderungen Ihres Projekts passt. Die Bibliothek bietet flexible Lizenzierungsoptionen, darunter Entwicklungs-, Staging- und Produktionsbereitstellungen, mit Optionen für containerisierte Umgebungen und Cloud-native Anwendungen.