C# voor .NET XLSX, ODS en CSV Geen Office nodig

De C# Excel-bibliotheek voor XLSX-bestanden

sgcDocs is een C# Excel-bibliotheek die XLSX-bestanden met formules, stijlen en getalnotaties maakt en leest, zonder Office, op Windows, Linux en macOS.

320 Excel-functies berekend Lettertypen, vulkleuren, randen, getalnotaties ASP.NET Core, services, Linux DOCX en PDF in dezelfde API

Inbegrepen in sgcUI .NET Enterprise. Bekijk de prijzen →

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

Een Excel-bestand maken in C#

Om in C# een Excel-bestand te maken zonder Excel, maak je een TsgcDocsSpreadsheet aan, roep je New aan, schrijf je waarden en formules per celadres, maak je de cellen op en roep je SaveToFile aan. Het formaat komt van de bestandsextensie, dus dezelfde werkmap wordt ook als ODS of CSV opgeslagen.

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

Het bestand behoudt de formules en hun berekende waarden. Text geeft een cel terug zoals hij wordt afgedrukt, met zijn getalnotatie toegepast. De C#-klasse behoudt de namen van de Delphi-editie: een geïndexeerde eigenschap zoals Values['A1'] wordt het methodepaar Values en SetValues, en hetzelfde geldt voor Formulas, ColumnWidths en RowHeights.

Een XLSX-bestand lezen en bijwerken in C#

LoadFromFile en LoadFromStream laden XLSX, ODS en CSV met waarden, formules, stijlen, samengevoegde cellen, indeling, pagina-instelling, beveiliging, diagrammen en de voorwaardelijke opmaak van XLSX-bestanden. Wijzig wat je nodig hebt, bereken opnieuw en sla op.

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 geeft een object terug: null voor een lege cel, een DateTime voor een datum en de fouttekst, zoals #DIV/0!, voor een fout. Evaluate voert een willekeurige formule uit op de werkmap zonder haar in een cel te schrijven.

Formules, stijlen en gegevens in je XLSX-bestanden

De werkmapengine achter TsgcDocsSpreadsheet is beheerde C#-code. Hij heeft geen Excel, geen COM-interop en geen native bibliotheek nodig op de machine waarop hij draait.

320 Excel-functies

Een tekst die met = begint is een formule. De engine berekent 320 Excel-functies, inclusief LET, LAMBDA en benoemde LAMBDA-functies, en DefineName voegt werkmapnamen toe, zoals VAT of een herbruikbare LAMBDA.

Stijlen en getalnotaties

SetFormat stelt het lettertype, vet, cursief, kleuren, vulling, uitlijning, tekstterugloop, getalnotatie, randen, inspringing en rotatie van een bereik in. MergeCells voegt een bereik samen.

Indeling en werkbladen

Kolombreedtes en rijhoogtes, AddSheet, RenameSheet, dat de formules herschrijft die naar het werkblad verwijzen, DeleteSheet, en beveiliging van werkblad en werkmap.

Gegevens uit je database

ImportDataSet kopieert een DataTable of een IDataReader naar een werkblad, met de kolomtitels of veldnamen als koprij, en geeft het aantal rijen terug.

Diagrammen behouden

Opmaak, samengevoegde cellen, diagrammen en voorwaardelijke opmaak blijven behouden wanneer een XLSX-bestand wordt geladen en opnieuw opgeslagen, en de diagrammen van een werkblad worden ermee afgedrukt.

PDF-, HTML- en PNG-uitvoer

ExportToPDFFile drukt één werkblad of elk zichtbaar werkblad af met de pagina-instelling van de werkmap, ExportToHTML schrijft een HTML-tabel per werkblad, en ExportSheetPageToPNG rendert één afgedrukte pagina.

Excel-bestanden in ASP.NET Core en op Linux

Het package draait in consoleprogramma's, services, ASP.NET Core en desktoptoepassingen op Windows, Linux en macOS. SaveToStream schrijft de werkmap naar elke stream, zodat een web-API een XLSX-bestand teruggeeft zonder tijdelijk bestand.

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

De componenten zijn niet thread-safe: maak degene die een verzoek nodig heeft aan in de thread die het afhandelt, en afzonderlijke instanties draaien parallel. Installeer op Linux en in containers de TrueType-lettertypen die je documenten gebruiken, of voeg een lettertypemap toe met AddFontFolder. De .NET-demo's bevatten ConversionServer, een minimale ASP.NET Core-API die documenten op een server converteert.

Ook een C# DOCX-bibliotheek: Word- en PDF-bestanden

Hetzelfde package maakt en leest Word-documenten. TsgcDocsWordProcessor leest en schrijft DOCX, RTF, HTML, Markdown en tekst, voert mailmerges uit vanuit een DataTable, CSV of JSON, en exporteert naar PDF. TsgcDocsConverter converteert in één aanroep tussen documenten, werkmappen, PDF-bestanden en afbeeldingen.

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

Vul een in Word gemaakt DOCX-sjabloon met ReplaceAll, of voeg het samen met je gegevens, en sla het resultaat op als DOCX of PDF.

PDF-verwerking

TsgcDocsPDFProcessor voegt pagina's samen, splitst en roteert ze, haalt tekst eruit, vult formulieren in, versleutelt met AES-256, converteert naar PDF/A en ondertekent.

Barcodes en ZIP

TsgcDocsBarcode schrijft QR Code, Data Matrix, Code 128 en meer als PNG, SVG of op een PDF-pagina, en TsgcDocsZipArchive bouwt ZIP64-archieven.

Installeer de C# Excel-bibliotheek vanuit NuGet

Voeg het package esegece.sgcDocs toe aan het project. NuGet voegt de engines toe waarop het is gebouwd: esegece.sgcUICore, esegece.sgcPDF, esegece.sgcRichEdit, esegece.sgcGrid, esegece.sgcSpreadsheet en esegece.sgcCharts.

dotnet add package esegece.sgcDocs

esegece.sgcDocs is een Registered-package, inbegrepen in sgcUI .NET Enterprise en All-Access, en het wordt niet gepubliceerd op nuget.org. PNG- en SVG-pagina's van documenten en werkbladen hebben nog één package nodig, esegece.sgcUICore.Rendering, zodat servers die alleen XLSX-, DOCX- en PDF-bestanden schrijven geen native renderbibliotheken meedragen.

PackageDoelframeworksDraait op
esegece.sgcDocs.NET Standard 2.0, .NET Framework 4.7.2, .NET 6, 8, 9 en 10Windows, Linux en macOS, in consoleprogramma's, services, ASP.NET Core en desktoptoepassingen
esegece.sgcUICore.RenderingAlleen toegevoegd wanneer nodigPNG- en SVG-pagina's van documenten en werkbladen

Waar de C# Excel-bibliotheek in zit

sgcDocs wordt niet los verkocht en heeft geen gratis Community-editie. sgcUI .NET Enterprise bevat de volledige C#-broncode en 1 jaar updates.

sgcUI .NET Enterprise

Elk sgcUI-product voor .NET, sgcDocs inbegrepen, met volledige C#-broncode voor WinForms, WPF en Avalonia, vanaf €699 per ontwikkelaar.

All-Access

Elk eSeGeCe-product, sgcUI Enterprise en sgcDocs inbegrepen.

Bekijk All-Access →

Ook voor Delphi en C++ Builder

Dezelfde API met dezelfde klassenamen voor Delphi 7 tot 13 en C++ Builder 2007 tot 13, op Win32, Win64 en Linux64.

sgcDocs voor Delphi →

Veelgestelde vragen

Voeg het package esegece.sgcDocs toe, maak een TsgcDocsSpreadsheet, roep New aan, schrijf cellen met SetValues en SetFormulas, en roep SaveToFile("report.xlsx") aan. De werkmap wordt geschreven door beheerde C#-code, dus er hoeft op de machine noch Excel noch Office te zijn geïnstalleerd.

Ja. Een tekst die met = begint is een formule, en de engine berekent 320 Excel-functies voordat het bestand wordt opgeslagen, zodat het XLSX-bestand zowel de formules als hun waarden bevat. SetFormat stelt lettertypen, kleuren, vulkleuren, uitlijning, tekstterugloop, randen en getalnotaties van een bereik in, en SetColumnWidths en SetRowHeights bepalen de indeling.

Ja, XLSX-, ODS- en CSV-bestanden. LoadFromFile of LoadFromStream laadt de waarden, formules, stijlen, samengevoegde cellen, pagina-instelling, beveiliging en diagrammen, en Values, Formulas en Text lezen elke cel. Het binaire XLS-formaat wordt niet ondersteund.

Ja. Het package richt zich op .NET Standard 2.0, .NET Framework 4.7.2 en .NET 6 tot 10, en draait in consoleprogramma's, services, ASP.NET Core en desktoptoepassingen op Windows, Linux en macOS. Maak één component per verzoek aan, omdat de componenten niet thread-safe zijn, en installeer de TrueType-lettertypen die je documenten gebruiken op de server.

Ja. TsgcDocsWordProcessor in hetzelfde package maakt, leest en bewerkt DOCX-, RTF-, HTML- en Markdown-documenten, vult sjablonen in, voert mailmerges uit en exporteert naar PDF. TsgcDocsPDFProcessor voegt PDF-bestanden samen, versleutelt ze, converteert naar PDF/A en ondertekent ze.

Nee. sgcDocs heeft geen gratis Community-editie. Het .NET-package is alleen Registered, het is inbegrepen in sgcUI .NET Enterprise en All-Access, en het wordt niet gepubliceerd op nuget.org. Voor een .NET-evaluatie kun je contact met ons opnemen.

Ja. De sgcUI .NET Enterprise-licentie bevat de volledige C#-broncode en 1 jaar updates. Zie de prijspagina van sgcUI.

De beste deal: All-AccessElk eSeGeCe-product, inclusief Premium-ondersteuning, vanaf €1,059 per jaar.
Bekijk de All-Access-prijzen

Maak Excel-bestanden vanuit je C#-code

XLSX, DOCX en PDF uit één .NET-package, zonder Office op de machine.