Wie man OpenOffice Excel-Dateien in C# liest, ohne dass Excel installiert ist

Wie installiert man IronXL in einem .NET -Projekt?

Install-Package IronXL
dotnet add package IronXL

Install-Package IronXL
dotnet add package IronXL

Wie lädt man eine OpenOffice- oder Excel-Datei in C#?

IronXL behandelt ODS-, XLS-, XLSX- und CSV-Dateien mit Hilfe der WorkBook.Load-Methode identisch. Sie übergeben einen absoluten oder relativen Dateipfad, und die Bibliothek erkennt das Format anhand des Dateikopfes – nicht nur anhand der Dateiendung. Das bedeutet, dass eine Datei, die von .ods in .xlsx umbenannt wurde, immer noch korrekt gelesen wird.

using IronXL;

// Load an OpenDocument Spreadsheet (.ods) produced by LibreOffice Calc or OpenOffice
WorkBook workbook = WorkBook.Load("quarterly_report.ods");

// Access the first worksheet by index
WorkSheet sheet = workbook.WorkSheets[0];

// Read a cell value
string companyName = sheet["A1"].StringValue;
int recordCount   = sheet["B1"].IntValue;

Console.WriteLine($"Company : {companyName}");
Console.WriteLine($"Records : {recordCount}");

using IronXL;

// Load an OpenDocument Spreadsheet (.ods) produced by LibreOffice Calc or OpenOffice
WorkBook workbook = WorkBook.Load("quarterly_report.ods");

// Access the first worksheet by index
WorkSheet sheet = workbook.WorkSheets[0];

// Read a cell value
string companyName = sheet["A1"].StringValue;
int recordCount   = sheet["B1"].IntValue;

Console.WriteLine($"Company : {companyName}");
Console.WriteLine($"Records : {recordCount}");

Imports IronXL

' Load an OpenDocument Spreadsheet (.ods) produced by LibreOffice Calc or OpenOffice
Dim workbook As WorkBook = WorkBook.Load("quarterly_report.ods")

' Access the first worksheet by index
Dim sheet As WorkSheet = workbook.WorkSheets(0)

' Read a cell value
Dim companyName As String = sheet("A1").StringValue
Dim recordCount As Integer = sheet("B1").IntValue

Console.WriteLine($"Company : {companyName}")
Console.WriteLine($"Records : {recordCount}")

Der gleiche Aufruf funktioniert sowohl für XLSX- als auch für XLS-Dateien – Sie müssen lediglich den Pfad ändern. WorkBook.Load gibt unabhängig vom Quellformat dasselbe stark typisierte Objekt zurück, so dass der Rest Ihres Codes identisch bleibt, egal ob die Datei aus Microsoft Excel, LibreOffice oder einer anderen ODF-kompatiblen Anwendung stammt.

Wie liest man jede Zeile und Zelle in einem Arbeitsblatt?

using IronXL;

WorkBook workbook  = WorkBook.Load("customers.xlsx");
WorkSheet worksheet = workbook.WorkSheets[0];

Console.WriteLine($"Total rows    : {worksheet.RowCount}");
Console.WriteLine($"Total columns : {worksheet.ColumnCount}");
Console.WriteLine();

foreach (var row in worksheet.Rows)
{
    foreach (var cell in row)
    {
        if (!cell.IsEmpty)
            Console.Write($"{cell.StringValue,-20}");
    }
    Console.WriteLine();
}

using IronXL;

WorkBook workbook  = WorkBook.Load("customers.xlsx");
WorkSheet worksheet = workbook.WorkSheets[0];

Console.WriteLine($"Total rows    : {worksheet.RowCount}");
Console.WriteLine($"Total columns : {worksheet.ColumnCount}");
Console.WriteLine();

foreach (var row in worksheet.Rows)
{
    foreach (var cell in row)
    {
        if (!cell.IsEmpty)
            Console.Write($"{cell.StringValue,-20}");
    }
    Console.WriteLine();
}

Imports IronXL

Dim workbook As WorkBook = WorkBook.Load("customers.xlsx")
Dim worksheet As WorkSheet = workbook.WorkSheets(0)

Console.WriteLine($"Total rows    : {worksheet.RowCount}")
Console.WriteLine($"Total columns : {worksheet.ColumnCount}")
Console.WriteLine()

For Each row In worksheet.Rows
    For Each cell In row
        If Not cell.IsEmpty Then
            Console.Write($"{cell.StringValue,-20}")
        End If
    Next
    Console.WriteLine()
Next

Wie extrahiert man typisierte Werte aus Zellen?

using IronXL;

WorkBook workbook = WorkBook.Load("inventory.xlsx");
WorkSheet sheet   = workbook.GetWorkSheet("Products");

// Typed accessors handle conversion automatically
string  productName = sheet["A2"].StringValue;
int     quantity    = sheet["B2"].IntValue;
decimal unitPrice   = sheet["C2"].DecimalValue;
bool    inStock     = sheet["D2"].BoolValue;
DateTime? lastAudit = sheet["E2"].DateTimeValue;

Console.WriteLine($"Product  : {productName}");
Console.WriteLine($"Qty      : {quantity}");
Console.WriteLine($"Price    : {unitPrice:C}");
Console.WriteLine($"In Stock : {inStock}");
Console.WriteLine($"Audited  : {lastAudit?.ToString("d") ?? "Never"}");

using IronXL;

WorkBook workbook = WorkBook.Load("inventory.xlsx");
WorkSheet sheet   = workbook.GetWorkSheet("Products");

// Typed accessors handle conversion automatically
string  productName = sheet["A2"].StringValue;
int     quantity    = sheet["B2"].IntValue;
decimal unitPrice   = sheet["C2"].DecimalValue;
bool    inStock     = sheet["D2"].BoolValue;
DateTime? lastAudit = sheet["E2"].DateTimeValue;

Console.WriteLine($"Product  : {productName}");
Console.WriteLine($"Qty      : {quantity}");
Console.WriteLine($"Price    : {unitPrice:C}");
Console.WriteLine($"In Stock : {inStock}");
Console.WriteLine($"Audited  : {lastAudit?.ToString("d") ?? "Never"}");

Imports IronXL

Dim workbook As WorkBook = WorkBook.Load("inventory.xlsx")
Dim sheet As WorkSheet = workbook.GetWorkSheet("Products")

' Typed accessors handle conversion automatically
Dim productName As String = sheet("A2").StringValue
Dim quantity As Integer = sheet("B2").IntValue
Dim unitPrice As Decimal = sheet("C2").DecimalValue
Dim inStock As Boolean = sheet("D2").BoolValue
Dim lastAudit As DateTime? = sheet("E2").DateTimeValue

Console.WriteLine($"Product  : {productName}")
Console.WriteLine($"Qty      : {quantity}")
Console.WriteLine($"Price    : {unitPrice:C}")
Console.WriteLine($"In Stock : {inStock}")
Console.WriteLine($"Audited  : {If(lastAudit?.ToString("d"), "Never")}")

Wie arbeitet man mit mehreren benannten Arbeitsblättern?

using IronXL;

WorkBook workbook = WorkBook.Load("annual_sales.xlsx");

// Option 1: access by name (throws if the sheet does not exist)
WorkSheet januarySheet = workbook.GetWorkSheet("January");

// Option 2: iterate all sheets in the workbook
foreach (WorkSheet ws in workbook.WorkSheets)
{
    Console.WriteLine($"Sheet: {ws.Name}  |  Rows: {ws.RowCount}");

    // Read the header row from each sheet
    string header = ws["A1"].StringValue;
    Console.WriteLine($"  Header: {header}");
}

// Option 3: access by zero-based index
WorkSheet lastSheet = workbook.WorkSheets[workbook.WorkSheets.Count - 1];
Console.WriteLine($"Last sheet: {lastSheet.Name}");

using IronXL;

WorkBook workbook = WorkBook.Load("annual_sales.xlsx");

// Option 1: access by name (throws if the sheet does not exist)
WorkSheet januarySheet = workbook.GetWorkSheet("January");

// Option 2: iterate all sheets in the workbook
foreach (WorkSheet ws in workbook.WorkSheets)
{
    Console.WriteLine($"Sheet: {ws.Name}  |  Rows: {ws.RowCount}");

    // Read the header row from each sheet
    string header = ws["A1"].StringValue;
    Console.WriteLine($"  Header: {header}");
}

// Option 3: access by zero-based index
WorkSheet lastSheet = workbook.WorkSheets[workbook.WorkSheets.Count - 1];
Console.WriteLine($"Last sheet: {lastSheet.Name}");

Imports IronXL

Dim workbook As WorkBook = WorkBook.Load("annual_sales.xlsx")

' Option 1: access by name (throws if the sheet does not exist)
Dim januarySheet As WorkSheet = workbook.GetWorkSheet("January")

' Option 2: iterate all sheets in the workbook
For Each ws As WorkSheet In workbook.WorkSheets
    Console.WriteLine($"Sheet: {ws.Name}  |  Rows: {ws.RowCount}")

    ' Read the header row from each sheet
    Dim header As String = ws("A1").StringValue
    Console.WriteLine($"  Header: {header}")
Next

' Option 3: access by zero-based index
Dim lastSheet As WorkSheet = workbook.WorkSheets(workbook.WorkSheets.Count - 1)
Console.WriteLine($"Last sheet: {lastSheet.Name}")

Wie geht man mit verbundenen Zellen und formatierten Bereichen um?

In Berichten und Dashboards werden häufig verbundene Zellen für Überschriften, gruppierte Beschriftungen und Zusammenfassungszeilen verwendet. IronXL liest den Wert aus der Zelle oben links eines zusammengeführten Bereichs genau so, wie er in Excel angezeigt wird:

using IronXL;

WorkBook workbook = WorkBook.Load("report_with_merges.xlsx");
WorkSheet sheet   = workbook.DefaultWorkSheet;

// The merged region A1:D1 stores its value in cell A1
string reportTitle = sheet["A1"].StringValue;
Console.WriteLine($"Report title : {reportTitle}");

// Read cell formatting metadata
var titleCell = sheet["A1"];
Console.WriteLine($"Bold         : {titleCell.Style.Font.Bold}");
Console.WriteLine($"Font size    : {titleCell.Style.Font.Height}");

// Scan an entire column for non-empty section headers
foreach (var cell in sheet["A1:A100"])
{
    if (!cell.IsEmpty && cell.Style.Font.Bold)
        Console.WriteLine($"Section header at {cell.AddressString}: {cell.StringValue}");
}

using IronXL;

WorkBook workbook = WorkBook.Load("report_with_merges.xlsx");
WorkSheet sheet   = workbook.DefaultWorkSheet;

// The merged region A1:D1 stores its value in cell A1
string reportTitle = sheet["A1"].StringValue;
Console.WriteLine($"Report title : {reportTitle}");

// Read cell formatting metadata
var titleCell = sheet["A1"];
Console.WriteLine($"Bold         : {titleCell.Style.Font.Bold}");
Console.WriteLine($"Font size    : {titleCell.Style.Font.Height}");

// Scan an entire column for non-empty section headers
foreach (var cell in sheet["A1:A100"])
{
    if (!cell.IsEmpty && cell.Style.Font.Bold)
        Console.WriteLine($"Section header at {cell.AddressString}: {cell.StringValue}");
}

Imports IronXL

Dim workbook As WorkBook = WorkBook.Load("report_with_merges.xlsx")
Dim sheet As WorkSheet = workbook.DefaultWorkSheet

' The merged region A1:D1 stores its value in cell A1
Dim reportTitle As String = sheet("A1").StringValue
Console.WriteLine($"Report title : {reportTitle}")

' Read cell formatting metadata
Dim titleCell = sheet("A1")
Console.WriteLine($"Bold         : {titleCell.Style.Font.Bold}")
Console.WriteLine($"Font size    : {titleCell.Style.Font.Height}")

' Scan an entire column for non-empty section headers
For Each cell In sheet("A1:A100")
    If Not cell.IsEmpty AndAlso cell.Style.Font.Bold Then
        Console.WriteLine($"Section header at {cell.AddressString}: {cell.StringValue}")
    End If
Next

Der Style Eigenschaftsbaum spiegelt die Struktur der OOXML SpreadsheetML-Spezifikation wider, so dass Ihnen die Eigenschaftsnamen vertraut vorkommen, wenn Sie bereits mit dem Open XML SDK gearbeitet haben. IronXL verpackt diese ganze Komplexität jedoch in eine übersichtliche API, die keinerlei XML-Manipulation Ihrerseits erfordert.

Wie importiert man CSV-Dateien mit der gleichen API?

CSV-Dateien, die von Datenbankexporten, CRM-Systemen und Legacy-Anwendungen erzeugt werden, können über denselben WorkBook.Load-Aufruf gelesen werden. IronXL leitet das Trennzeichen aus dem Dateiinhalt ab:

using IronXL;

// Load a comma-separated values file -- same method, same API
WorkBook csvWorkbook  = WorkBook.Load("export.csv");
WorkSheet csvSheet    = csvWorkbook.DefaultWorkSheet;

Console.WriteLine($"CSV rows loaded: {csvSheet.RowCount}");

// Process rows exactly like any other worksheet
foreach (var row in csvSheet.Rows)
{
    string id   = row[0].StringValue;
    string name = row[1].StringValue;
    Console.WriteLine($"{id,-10} {name}");
}

using IronXL;

// Load a comma-separated values file -- same method, same API
WorkBook csvWorkbook  = WorkBook.Load("export.csv");
WorkSheet csvSheet    = csvWorkbook.DefaultWorkSheet;

Console.WriteLine($"CSV rows loaded: {csvSheet.RowCount}");

// Process rows exactly like any other worksheet
foreach (var row in csvSheet.Rows)
{
    string id   = row[0].StringValue;
    string name = row[1].StringValue;
    Console.WriteLine($"{id,-10} {name}");
}

Imports IronXL

' Load a comma-separated values file -- same method, same API
Dim csvWorkbook As WorkBook = WorkBook.Load("export.csv")
Dim csvSheet As WorkSheet = csvWorkbook.DefaultWorkSheet

Console.WriteLine($"CSV rows loaded: {csvSheet.RowCount}")

' Process rows exactly like any other worksheet
For Each row In csvSheet.Rows
    Dim id As String = row(0).StringValue
    Dim name As String = row(1).StringValue
    Console.WriteLine($"{id,-10} {name}")
Next

Nach dem Laden können Sie die Daten mit csvWorkbook.SaveAs("output.xlsx") als XLSX speichern. Dies ist ein gängiges Muster für CSV-zu-Excel-Konvertierungspipelines – eine CSV-Datei empfangen, sie mit berechneten Spalten oder Formatierungen anreichern und dem Benutzer einen formatierten XLSX-Bericht zurückgeben.

Für tabulatorgetrennte Dateien oder benutzerdefinierte Trennzeichen verwenden Sie WorkBook.LoadCSV("file.tsv", fileFormat: ExcelFileFormat.TSV), um das Format explizit anzugeben.

Wie schneidet IronXL im Vergleich zu Microsoft.Office.Interop.Excel ab?

Wie implementiert man die Excel-Verarbeitung unter Linux und Docker?

Bei Server-Implementierungen erweist sich die Unabhängigkeit von IronXL von Excel als besonders wertvoll. Derselbe Code, den Sie unter Windows schreiben, läuft unverändert unter Ubuntu, Alpine Linux oder macOS. Für containerisierte Bereitstellungen ist in Ihrer Dockerfile keine spezielle Konfiguration erforderlich:

# Standard .NET runtime image -- no Office packages needed
FROM mcr.microsoft.com/dotnet/runtime:10.0
WORKDIR /app
COPY --from=build /app/publish .
ENTRYPOINT ["dotnet", "ExcelProcessor.dll"]

# Standard .NET runtime image -- no Office packages needed
FROM mcr.microsoft.com/dotnet/runtime:10.0
WORKDIR /app
COPY --from=build /app/publish .
ENTRYPOINT ["dotnet", "ExcelProcessor.dll"]

Für Azure Functions und AWS Lambda funktioniert IronXL innerhalb der verwalteten Laufzeitumgebung ohne zusätzliche Konfiguration. Der Aufwand beim Kaltstart ist minimal, da kein COM-Initialisierungsschritt erforderlich ist.

Thread-Sicherheit ist eingebaut: mehrere Threads können verschiedene WorkBook Instanzen gleichzeitig ohne Koordination öffnen. Wenn Sie Tausende von Dateien parallel verarbeiten müssen - zum Beispiel in einem Hintergrundjob, der vom Benutzer hochgeladene Tabellen einliest - können Sie Parallel.ForEach oder Task.WhenAll in einem Pool von WorkBook Instanzen verwenden, ohne dass die Gefahr einer Beschädigung besteht.

Der Speicherverbrauch bleibt vorhersehbar, da IronXL bei der Initialisierung nur das angeforderte Arbeitsblatt in den Speicher lädt und nicht die gesamte Arbeitsmappe. Bei sehr großen Dateien ist dieser Unterschied wichtig: Eine Arbeitsmappe mit zehn 50-MB-Blättern benötigt nicht 500 MB RAM, nur um ein einziges Blatt zu lesen. Die IronXL Leistungsdokumentation enthält zusätzliche Strategien für den Umgang mit Szenarien der Verarbeitung großer Dateimengen.

Was sind Ihre nächsten Schritte?

Der schnellste Weg, IronXL in Ihrem Projekt zu validieren, besteht darin, das NuGet Paket zu installieren und die Beispiele in diesem Leitfaden mit einer echten Datei aus Ihrer Umgebung auszuführen. Mit einer kostenlosen Testlizenz werden alle Funktionen freigeschaltet, ohne dass Codeänderungen erforderlich sind, wenn Sie bereit für den Produktiveinsatz sind.

Entdecken Sie verwandte IronXL -Funktionen, die das Lesen von Dateien ergänzen:

• Excel-Dateien in C# schreiben und erstellen - Berichte und Datenexporte programmgesteuert erstellen
• Zellen, Zeilen und Spalten formatieren – Farben, Schriftarten und Rahmen im Code anwenden
• Arbeiten mit Excel-Formeln in C# -- Formelzellen lesen und schreiben
• Excel-Daten in .NET in PDF konvertieren – PDF-Berichte aus Tabellendaten generieren
• IronXL API-Dokumentation – vollständige Referenz aller Klassen und Methoden
• IronXL Lizenzierung und Preisgestaltung – Optionen für einzelne Entwickler und Enterprise
• IronXL NuGet-Seite – Installationsanleitung für alle Projekttypen
• IronXL Tutorials – Schritt-für-Schritt-Anleitungen für gängige Anwendungsfälle
• IronXL im Vergleich mit EPPlus – Funktionen und Lizenzvergleich im direkten Vergleich
• IronXL Produktseite – Funktionsübersicht und erste Schritte

Bei Fragen zur Lizenzierung, zur plattformübergreifenden Unterstützung oder zu spezifischen Dateiformatanforderungen steht Ihnen das IronXL Supportteam per Live-Chat und E-Mail zur Verfügung.

Starten Sie jetzt mit IronXL.

Jetzt kostenlos starten