C# für .NET XLSX, ODS und CSV Kein Office nötig

Die C#-Excel-Bibliothek für XLSX-Dateien

sgcDocs ist eine C#-Excel-Bibliothek, die XLSX-Dateien mit Formeln, Stilen und Zahlenformaten erstellt und liest, ohne installiertes Office, unter Windows, Linux und macOS.

320 berechnete Excel-Funktionen Schriften, Füllungen, Rahmen, Zahlenformate ASP.NET Core, Dienste, Linux DOCX und PDF in derselben API

Enthalten in sgcUI .NET Enterprise. Preise ansehen →

using esegece.sgcDocs;

using (var sheet = new TsgcDocsSpreadsheet())
{
    sheet.New();
    sheet.SetValues("A1", "Units");
    sheet.SetValues("A2", 12);
    sheet.SetValues("A3", 30);
    sheet.SetFormulas("A4", "=SUM(A2:A3)");
    sheet.Calculate();
    sheet.SaveToFile("units.xlsx");
    sheet.ExportToPDFFile("units.pdf");
}

So erstellst du eine Excel-Datei in C#

Um in C# ohne Excel eine Excel-Datei zu erstellen, erstelle ein TsgcDocsSpreadsheet, rufe New auf, schreibe Werte und Formeln per Zelladresse, formatiere die Zellen und rufe SaveToFile auf. Das Format ergibt sich aus der Dateiendung, sodass dieselbe Arbeitsmappe auch als ODS oder CSV gespeichert wird.

using System;
using esegece.sgcDocs;
using esegece.sgcGrid;

static class SalesReport
{
    public static void Create()
    {
        using (var sheet = new TsgcDocsSpreadsheet())
        {
            sheet.New();
            sheet.RenameSheet(0, "Sales");

            // a header row and three data rows, from one and two dimensional arrays
            sheet.SetRange("A1", new object[] { "Product", "Units", "Price", "Total" });
            sheet.SetRange("A2", new object[,]
            {
                { "Paper", 12, 4.5 },
                { "Toner", 3, 39.9 },
                { "Labels", 20, 2.75 }
            });

            // formulas, calculated by the engine and saved with the file
            sheet.SetFormulas("D2", "=B2*C2");
            sheet.SetFormulas("D3", "=B3*C3");
            sheet.SetFormulas("D4", "=B4*C4");
            sheet.SetValues("A5", "Total");
            sheet.SetFormulas("D5", "=SUM(D2:D4)");

            // a bold, centred header with a fill colour (ARGB)
            TsgcGridCellFormat header = sgcGrid_CellFormat.sgcGridCellFormatEmpty();
            header.Bold = true;
            header.Alignment = TsgcGridAlignment.gaCenter;
            header.FillColor = 0xFFDDEBF7;
            sheet.SetFormat("A1:D1", header);

            // a number format for the money columns
            TsgcGridCellFormat money = sgcGrid_CellFormat.sgcGridCellFormatEmpty();
            money.NumberFormat = "#,##0.00";
            sheet.SetFormat("C2:D5", money);

            // column widths in DIPs
            sheet.SetColumnWidths("A", 140);
            sheet.SetColumnWidths("D", 90);

            sheet.Calculate();
            Console.WriteLine("Total: " + sheet.Text("D5"));
            sheet.SaveToFile("sales.xlsx");
        }
    }
}

Die Datei behält die Formeln und ihre berechneten Werte. Text gibt eine Zelle so zurück, wie sie gedruckt wird, mit angewendetem Zahlenformat. Die C#-Klasse behält die Namen der Delphi-Edition: Eine indizierte Eigenschaft wie Values['A1'] wird zum Methodenpaar Values und SetValues, und dasselbe gilt für Formulas, ColumnWidths und RowHeights.

Eine XLSX-Datei in C# lesen und aktualisieren

LoadFromFile und LoadFromStream laden XLSX, ODS und CSV mit Werten, Formeln, Stilen, verbundenen Zellen, Layout, Seiteneinrichtung, Schutz, Diagrammen und den bedingten Formaten von XLSX-Dateien. Ändere, was du brauchst, berechne neu und speichere.

using (var sheet = new TsgcDocsSpreadsheet())
{
    sheet.LoadFromFile("sales.xlsx");
    Console.WriteLine(sheet.SheetNames(0) + ": " + sheet.UsedRange());
    Console.WriteLine("D2 formula: " + sheet.Formulas("D2"));
    Console.WriteLine("Units of B3: " + sheet.Values("B3"));

    // change a value, calculate again, save and print to PDF
    sheet.SetValues("B3", 5);
    sheet.Calculate();
    Console.WriteLine("New total: " + sheet.Text("D5"));
    sheet.SaveToFile("sales_updated.xlsx");
    Console.WriteLine(sheet.ExportToPDFFile("sales.pdf") + " PDF page(s)");
}

Values gibt ein object zurück: null für eine leere Zelle, ein DateTime für ein Datum und den Fehlertext, etwa #DIV/0!, für einen Fehler. Evaluate führt eine beliebige Formel gegen die Arbeitsmappe aus, ohne sie in eine Zelle zu schreiben.

Formeln, Stile und Daten in deinen XLSX-Dateien

Die Arbeitsmappen-Engine hinter TsgcDocsSpreadsheet ist verwalteter C#-Code. Sie braucht auf dem Rechner, der sie ausführt, weder Excel noch COM-Interop noch eine native Bibliothek.

320 Excel-Funktionen

Ein Text, der mit = beginnt, ist eine Formel. Die Engine berechnet 320 Excel-Funktionen, darunter LET, LAMBDA und benannte LAMBDA-Funktionen, und DefineName fügt Namen für die Arbeitsmappe wie VAT oder ein wiederverwendbares LAMBDA hinzu.

Stile und Zahlenformate

SetFormat setzt Schriftgröße, Fett, Kursiv, Farben, Füllung, Ausrichtung, Textumbruch, Zahlenformat, Rahmen, Einzug und Drehung eines Bereichs. MergeCells verbindet einen Bereich.

Layout und Tabellenblätter

Spaltenbreiten und Zeilenhöhen, AddSheet, RenameSheet, das die Formeln umschreibt, die auf das Blatt verweisen, DeleteSheet sowie Blatt- und Arbeitsmappenschutz.

Daten aus deiner Datenbank

ImportDataSet kopiert eine DataTable oder einen IDataReader in ein Tabellenblatt, mit den Spaltenüberschriften oder Feldnamen als Kopfzeile, und gibt die Anzahl der Zeilen zurück.

Diagramme bleiben erhalten

Formate, verbundene Zellen, Diagramme und bedingte Formate bleiben erhalten, wenn eine XLSX-Datei geladen und wieder gespeichert wird, und die Diagramme eines Blatts werden mit ihm gedruckt.

PDF-, HTML- und PNG-Ausgabe

ExportToPDFFile druckt ein Blatt oder jedes sichtbare Blatt mit der Seiteneinrichtung der Arbeitsmappe, ExportToHTML schreibt eine HTML-Tabelle pro Blatt, und ExportSheetPageToPNG rendert eine gedruckte Seite.

Excel-Dateien in ASP.NET Core und unter Linux

Das Paket läuft in Konsolenprogrammen, Diensten, ASP.NET Core und Desktopanwendungen unter Windows, Linux und macOS. SaveToStream schreibt die Arbeitsmappe in einen beliebigen Stream, sodass eine Web-API eine XLSX-Datei ohne temporäre Datei zurückgibt.

using esegece.sgcDocs;

var app = WebApplication.CreateBuilder(args).Build();

// GET /report.xlsx returns a workbook built for the request
app.MapGet("/report.xlsx", () =>
{
    var stream = new MemoryStream();
    using (var sheet = new TsgcDocsSpreadsheet())
    {
        sheet.New();
        sheet.SetValues("A1", "Generated");
        sheet.SetValues("B1", DateTime.Now);
        sheet.SaveToStream(stream, TsgcDocsFormat.dfXLSX);
    }
    stream.Position = 0;
    return Results.File(stream,
        "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
        "report.xlsx");
});

app.Run();

Die Komponenten sind nicht threadsicher: Erstelle die, die eine Anfrage braucht, in dem Thread, der sie bedient, und getrennte Instanzen laufen parallel. Installiere unter Linux und in Containern die TrueType-Schriften, die deine Dokumente nutzen, oder füge mit AddFontFolder einen Schriftordner hinzu. Die .NET-Demos enthalten ConversionServer, eine minimale ASP.NET-Core-API, die Dokumente auf einem Server konvertiert.

Auch eine C#-DOCX-Bibliothek: Word- und PDF-Dateien

Dasselbe Paket erstellt und liest Word-Dokumente. TsgcDocsWordProcessor liest und schreibt DOCX, RTF, HTML, Markdown und Text, führt Serienbriefe aus einer DataTable, CSV oder JSON aus und exportiert nach PDF. TsgcDocsConverter konvertiert in einem Aufruf zwischen Dokumenten, Tabellen, PDF-Dateien und Bildern.

// a Word document saved as DOCX and PDF
using (var word = new TsgcDocsWordProcessor())
{
    word.New();
    word.Title = "Quarterly report";
    word.AppendParagraph("Quarterly report", "Heading 1");
    word.AppendParagraph("Sales grew 12% in the third quarter.");
    word.SaveToFile("report.docx");
    word.ExportToPDFFile("report.pdf");
    Console.WriteLine("Pages: " + word.PageCount);
}

// one call conversions, the formats come from the file extensions
using (var converter = new TsgcDocsConverter())
{
    converter.Convert("sales.xlsx", "sales.csv");
    converter.Convert("report.docx", "report.html");
}

Word-Dokumente

Fülle eine in Word erstellte DOCX-Vorlage mit ReplaceAll oder führe sie mit deinen Daten zusammen und speichere das Ergebnis als DOCX oder PDF.

PDF-Verarbeitung

TsgcDocsPDFProcessor führt Seiten zusammen, teilt und dreht sie, extrahiert Text, füllt Formulare aus, verschlüsselt mit AES-256, konvertiert nach PDF/A und signiert.

Barcodes und ZIP

TsgcDocsBarcode schreibt QR Code, Data Matrix, Code 128 und mehr als PNG, SVG oder auf eine PDF-Seite, und TsgcDocsZipArchive baut ZIP64-Archive.

Die C#-Excel-Bibliothek über NuGet installieren

Füge dem Projekt das Paket esegece.sgcDocs hinzu. NuGet fügt die Engines hinzu, auf denen es aufbaut: esegece.sgcUICore, esegece.sgcPDF, esegece.sgcRichEdit, esegece.sgcGrid, esegece.sgcSpreadsheet und esegece.sgcCharts.

dotnet add package esegece.sgcDocs

esegece.sgcDocs ist ein Registered-Paket, in sgcUI .NET Enterprise und All-Access enthalten, und wird nicht auf nuget.org veröffentlicht. PNG- und SVG-Seiten von Dokumenten und Tabellenblättern brauchen ein weiteres Paket, esegece.sgcUICore.Rendering, damit Server, die nur XLSX-, DOCX- und PDF-Dateien schreiben, keine nativen Rendering-Bibliotheken mitführen.

PaketZielframeworksLäuft auf
esegece.sgcDocs.NET Standard 2.0, .NET Framework 4.7.2, .NET 6, 8, 9 und 10Windows, Linux und macOS, in Konsolenprogrammen, Diensten, ASP.NET Core und Desktopanwendungen
esegece.sgcUICore.RenderingNur bei Bedarf hinzugefügtPNG- und SVG-Seiten von Dokumenten und Tabellenblättern

Wo die C#-Excel-Bibliothek enthalten ist

sgcDocs wird nicht einzeln verkauft und hat keine kostenlose Community-Edition. sgcUI .NET Enterprise enthält den vollständigen C#-Quellcode und 1 Jahr Updates.

sgcUI .NET Enterprise

Jedes sgcUI-Produkt für .NET, sgcDocs inklusive, mit vollständigem C#-Quellcode für WinForms, WPF und Avalonia, ab €699 pro Entwickler.

All-Access

Jedes Produkt von eSeGeCe, sgcUI Enterprise und sgcDocs inklusive.

All-Access ansehen →

Auch für Delphi und C++ Builder

Dieselbe API mit denselben Klassennamen für Delphi 7 bis 13 und C++ Builder 2007 bis 13, unter Win32, Win64 und Linux64.

sgcDocs für Delphi →

Häufig gestellte Fragen

Füge das Paket esegece.sgcDocs hinzu, erstelle ein TsgcDocsSpreadsheet, rufe New auf, schreibe Zellen mit SetValues und SetFormulas und rufe SaveToFile("report.xlsx") auf. Die Arbeitsmappe wird von verwaltetem C#-Code geschrieben, sodass auf dem Rechner weder Excel noch Office installiert sein muss.

Ja. Ein Text, der mit = beginnt, ist eine Formel, und die Engine berechnet 320 Excel-Funktionen, bevor die Datei gespeichert wird, sodass die XLSX sowohl die Formeln als auch ihre Werte enthält. SetFormat setzt Schriften, Farben, Füllungen, Ausrichtung, Textumbruch, Rahmen und Zahlenformate eines Bereichs, und SetColumnWidths und SetRowHeights legen das Layout fest.

Ja, XLSX-, ODS- und CSV-Dateien. LoadFromFile oder LoadFromStream lädt die Werte, Formeln, Stile, verbundenen Zellen, die Seiteneinrichtung, den Schutz und die Diagramme, und Values, Formulas und Text lesen jede Zelle. Das binäre XLS-Format wird nicht unterstützt.

Ja. Das Paket zielt auf .NET Standard 2.0, .NET Framework 4.7.2 und .NET 6 bis 10 und läuft in Konsolenprogrammen, Diensten, ASP.NET Core und Desktopanwendungen unter Windows, Linux und macOS. Erstelle eine Komponente pro Anfrage, weil die Komponenten nicht threadsicher sind, und installiere auf dem Server die TrueType-Schriften, die deine Dokumente nutzen.

Ja. TsgcDocsWordProcessor im selben Paket erstellt, liest und bearbeitet DOCX-, RTF-, HTML- und Markdown-Dokumente, füllt Vorlagen, führt Serienbriefe aus und exportiert nach PDF. TsgcDocsPDFProcessor führt PDF-Dateien zusammen, verschlüsselt sie, konvertiert nach PDF/A und signiert sie.

Nein. sgcDocs hat keine kostenlose Community-Edition. Das .NET-Paket gibt es nur als Registered, es ist in sgcUI .NET Enterprise und All-Access enthalten und wird nicht auf nuget.org veröffentlicht. Für eine .NET-Evaluierung nimm Kontakt mit uns auf.

Ja. Die Lizenz sgcUI .NET Enterprise enthält den vollständigen C#-Quellcode und 1 Jahr Updates. Siehe die sgcUI-Preisseite.

Bestes Preis-Leistungs-Verhältnis: All-AccessAlle eSeGeCe-Produkte, inklusive Premium-Support, ab €1,059 pro Jahr.
All-Access-Preise ansehen

Excel-Dateien aus deinem C#-Code erstellen

XLSX, DOCX und PDF aus einem .NET-Paket, ohne Office auf dem Rechner.