C# dla .NET XLSX, ODS i CSV Bez Office

Biblioteka Excel dla C# do plików XLSX

sgcDocs to biblioteka Excel dla C#, która tworzy i czyta pliki XLSX z formułami, stylami i formatami liczb, bez zainstalowanego Office, w systemach Windows, Linux i macOS.

320 obliczanych funkcji Excela Czcionki, wypełnienia, obramowania, formaty liczb ASP.NET Core, usługi, Linux DOCX i PDF w tym samym API

Zawarty w sgcUI .NET Enterprise. Zobacz cennik →

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

Jak utworzyć plik Excel w C#

Aby utworzyć plik Excel w C# bez Excela, utwórz TsgcDocsSpreadsheet, wywołaj New, zapisz wartości i formuły według adresu komórki, sformatuj komórki i wywołaj SaveToFile. Format wynika z rozszerzenia pliku, więc ten sam skoroszyt zapisuje się też jako ODS lub CSV.

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

Plik zachowuje formuły i ich obliczone wartości. Text zwraca komórkę tak, jak jest drukowana, z zastosowanym formatem liczby. Klasa C# zachowuje nazwy z edycji Delphi: indeksowana właściwość, taka jak Values['A1'], staje się parą metod Values i SetValues, to samo dotyczy Formulas, ColumnWidths i RowHeights.

Odczytaj i zaktualizuj plik XLSX w C#

LoadFromFile i LoadFromStream wczytują XLSX, ODS i CSV z wartościami, formułami, stylami, scalonymi komórkami, układem, ustawieniami strony, ochroną, wykresami i formatami warunkowymi plików XLSX. Zmień, co potrzebujesz, oblicz ponownie i zapisz.

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 zwraca object: null dla pustej komórki, DateTime dla daty i tekst błędu, taki jak #DIV/0!, dla błędu. Evaluate uruchamia dowolną formułę względem skoroszytu bez zapisywania jej w komórce.

Formuły, style i dane w plikach XLSX

Silnik skoroszytów stojący za TsgcDocsSpreadsheet to zarządzany kod C#. Nie potrzebuje Excela, współpracy COM ani natywnej biblioteki na maszynie, na której działa.

320 funkcji Excela

Tekst zaczynający się od = to formuła. Silnik oblicza 320 funkcji Excela, w tym LET, LAMBDA i nazwane funkcje LAMBDA, a DefineName dodaje nazwy skoroszytu, takie jak VAT lub wielokrotnego użytku LAMBDA.

Style i formaty liczb

SetFormat ustawia rozmiar czcionki, pogrubienie, kursywę, kolory, wypełnienie, wyrównanie, zawijanie, format liczby, obramowania, wcięcie i obrót zakresu. MergeCells scala zakres.

Układ i arkusze

Szerokości kolumn i wysokości wierszy, AddSheet, RenameSheet, który przepisuje formuły odwołujące się do arkusza, DeleteSheet oraz ochrona arkusza i skoroszytu.

Dane z Twojej bazy danych

ImportDataSet kopiuje DataTable lub IDataReader do arkusza, z nagłówkami kolumn lub nazwami pól jako wierszem nagłówka, i zwraca liczbę wierszy.

Wykresy zachowane

Formaty, scalone komórki, wykresy i formaty warunkowe są zachowywane, gdy plik XLSX jest wczytywany i zapisywany ponownie, a wykresy arkusza są drukowane razem z nim.

Wyjście PDF, HTML i PNG

ExportToPDFFile drukuje jeden arkusz lub każdy widoczny arkusz z ustawieniami strony skoroszytu, ExportToHTML zapisuje tabelę HTML dla każdego arkusza, a ExportSheetPageToPNG renderuje jedną wydrukowaną stronę.

Pliki Excel w ASP.NET Core i w systemie Linux

Pakiet działa w programach konsolowych, usługach, ASP.NET Core i aplikacjach desktopowych w systemach Windows, Linux i macOS. SaveToStream zapisuje skoroszyt do dowolnego strumienia, więc web API zwraca plik XLSX bez pliku tymczasowego.

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

Komponenty nie są bezpieczne wątkowo: twórz te, których potrzebuje żądanie, w wątku, który je obsługuje, a osobne instancje działają równolegle. W systemie Linux i w kontenerach zainstaluj czcionki TrueType używane przez Twoje dokumenty lub dodaj folder czcionek przez AddFontFolder. Dema .NET zawierają ConversionServer, minimalne API ASP.NET Core, które konwertuje dokumenty na serwerze.

Także biblioteka DOCX dla C#: pliki Word i PDF

Ten sam pakiet tworzy i czyta dokumenty Word. TsgcDocsWordProcessor czyta i zapisuje DOCX, RTF, HTML, Markdown i tekst, uruchamia korespondencję seryjną z DataTable, CSV lub JSON i eksportuje do PDF. TsgcDocsConverter konwertuje między dokumentami, arkuszami, plikami PDF i obrazami jednym wywołaniem.

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

Dokumenty Word

Wypełnij szablon DOCX utworzony w Wordzie przez ReplaceAll lub połącz go z danymi i zapisz wynik jako DOCX lub PDF.

Przetwarzanie PDF

TsgcDocsPDFProcessor łączy, dzieli i obraca strony, wyodrębnia tekst, wypełnia formularze, szyfruje AES-256, konwertuje do PDF/A i podpisuje.

Kody kreskowe i ZIP

TsgcDocsBarcode zapisuje QR Code, Data Matrix, Code 128 i inne jako PNG, SVG lub na stronie PDF, a TsgcDocsZipArchive buduje archiwa ZIP64.

Zainstaluj bibliotekę Excel dla C# z NuGet

Dodaj do projektu pakiet esegece.sgcDocs. NuGet dodaje silniki, na których się opiera: esegece.sgcUICore, esegece.sgcPDF, esegece.sgcRichEdit, esegece.sgcGrid, esegece.sgcSpreadsheet i esegece.sgcCharts.

dotnet add package esegece.sgcDocs

esegece.sgcDocs to pakiet Registered, zawarty w sgcUI .NET Enterprise i All-Access, i nie jest publikowany na nuget.org. Strony dokumentów i arkuszy w PNG i SVG wymagają jeszcze jednego pakietu, esegece.sgcUICore.Rendering, więc serwery, które zapisują tylko pliki XLSX, DOCX i PDF, nie niosą natywnych bibliotek renderowania.

PakietDocelowe frameworkiDziała na
esegece.sgcDocs.NET Standard 2.0, .NET Framework 4.7.2, .NET 6, 8, 9 i 10Windows, Linux i macOS, w programach konsolowych, usługach, ASP.NET Core i aplikacjach desktopowych
esegece.sgcUICore.RenderingDodawany tylko w razie potrzebyStrony dokumentów i arkuszy w PNG i SVG

Gdzie jest zawarta biblioteka Excel dla C#

sgcDocs nie jest sprzedawany osobno i nie ma bezpłatnej edycji Community. sgcUI .NET Enterprise zawiera pełny kod źródłowy C# i 1 rok aktualizacji.

sgcUI .NET Enterprise

Każdy produkt sgcUI dla .NET, w tym sgcDocs, z pełnym kodem źródłowym C# dla WinForms, WPF i Avalonia, od €699 za programistę.

All-Access

Każdy produkt eSeGeCe, w tym sgcUI Enterprise i sgcDocs.

Zobacz All-Access →

Także dla Delphi i C++ Builder

To samo API z tymi samymi nazwami klas dla Delphi 7 do 13 i C++ Builder 2007 do 13, w systemach Win32, Win64 i Linux64.

sgcDocs dla Delphi →

Najczęściej zadawane pytania

Dodaj pakiet esegece.sgcDocs, utwórz TsgcDocsSpreadsheet, wywołaj New, zapisz komórki przez SetValues i SetFormulas i wywołaj SaveToFile("report.xlsx"). Skoroszyt jest zapisywany przez zarządzany kod C#, więc na maszynie nie musi być zainstalowany ani Excel, ani Office.

Tak. Tekst zaczynający się od = to formuła, a silnik oblicza 320 funkcji Excela przed zapisem pliku, więc XLSX zawiera zarówno formuły, jak i ich wartości. SetFormat ustawia czcionki, kolory, wypełnienia, wyrównanie, zawijanie, obramowania i formaty liczb w zakresie, a SetColumnWidths i SetRowHeights ustalają rozmiary układu.

Tak, pliki XLSX, ODS i CSV. LoadFromFile lub LoadFromStream wczytuje wartości, formuły, style, scalone komórki, ustawienia strony, ochronę i wykresy, a Values, Formulas i Text odczytują dowolną komórkę. Binarny format XLS nie jest obsługiwany.

Tak. Pakiet obsługuje .NET Standard 2.0, .NET Framework 4.7.2 i .NET 6 do 10 i działa w programach konsolowych, usługach, ASP.NET Core i aplikacjach desktopowych w systemach Windows, Linux i macOS. Twórz jeden komponent na żądanie, ponieważ komponenty nie są bezpieczne wątkowo, i zainstaluj na serwerze czcionki TrueType używane przez Twoje dokumenty.

Tak. TsgcDocsWordProcessor w tym samym pakiecie tworzy, czyta i edytuje dokumenty DOCX, RTF, HTML i Markdown, wypełnia szablony, uruchamia korespondencję seryjną i eksportuje do PDF. TsgcDocsPDFProcessor łączy, szyfruje, konwertuje do PDF/A i podpisuje pliki PDF.

Nie. sgcDocs nie ma bezpłatnej edycji Community. Pakiet .NET jest tylko w edycji Registered, jest zawarty w sgcUI .NET Enterprise i All-Access i nie jest publikowany na nuget.org. Aby uzyskać wersję ewaluacyjną .NET, skontaktuj się z nami.

Tak. Licencja sgcUI .NET Enterprise zawiera pełny kod źródłowy C# i 1 rok aktualizacji. Zobacz stronę cennika sgcUI.

Najkorzystniejsza oferta: All-AccessWszystkie produkty eSeGeCe, ze wsparciem Premium w cenie, już od €1,059 rocznie.
Zobacz cennik All-Access

Twórz pliki Excel z kodu C#

XLSX, DOCX i PDF z jednego pakietu .NET, bez Office na maszynie.