C# per .NET XLSX, ODS e CSV Non serve Office

La libreria Excel C# per file XLSX

sgcDocs è una libreria Excel C# che crea e legge file XLSX con formule, stili e formati numerici, senza Office installato, su Windows, Linux e macOS.

320 funzioni Excel calcolate Font, riempimenti, bordi, formati numerici ASP.NET Core, servizi, Linux DOCX e PDF nella stessa API

Incluso in sgcUI .NET Enterprise. Vedi i prezzi →

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

Come creare un file Excel in C#

Per creare un file Excel in C# senza Excel, crea un TsgcDocsSpreadsheet, chiama New, scrivi valori e formule per indirizzo di cella, formatta le celle e chiama SaveToFile. Il formato deriva dall'estensione del file, quindi la stessa cartella di lavoro si salva anche come ODS o 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");
        }
    }
}

Il file conserva le formule e i loro valori calcolati. Text restituisce una cella com'è stampata, con il suo formato numerico applicato. La classe C# mantiene i nomi dell'edizione Delphi: una proprietà indicizzata come Values['A1'] diventa la coppia di metodi Values e SetValues, e lo stesso vale per Formulas, ColumnWidths e RowHeights.

Leggi e aggiorna un file XLSX in C#

LoadFromFile e LoadFromStream caricano XLSX, ODS e CSV con valori, formule, stili, celle unite, layout, impostazione di pagina, protezione, grafici e formati condizionali dei file XLSX. Modifica ciò che ti serve, ricalcola e salva.

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 restituisce un object: null per una cella vuota, un DateTime per una data e il testo dell'errore, come #DIV/0!, per un errore. Evaluate esegue qualsiasi formula sulla cartella di lavoro senza scriverla in una cella.

Formule, stili e dati nei tuoi file XLSX

L'engine delle cartelle di lavoro dietro TsgcDocsSpreadsheet è codice C# gestito. Non richiede Excel, interoperabilità COM né librerie native sulla macchina che lo esegue.

320 funzioni Excel

Un testo che inizia con = è una formula. L'engine calcola 320 funzioni Excel, comprese LET, LAMBDA e funzioni LAMBDA con nome, e DefineName aggiunge nomi di cartella di lavoro come VAT o una LAMBDA riutilizzabile.

Stili e formati numerici

SetFormat imposta dimensione del font, grassetto, corsivo, colori, riempimento, allineamento, a capo automatico, formato numerico, bordi, rientro e rotazione di un intervallo. MergeCells unisce un intervallo.

Layout e fogli

Larghezze delle colonne e altezze delle righe, AddSheet, RenameSheet, che riscrive le formule che si riferiscono al foglio, DeleteSheet, e protezione di fogli e cartelle di lavoro.

Dati dal tuo database

ImportDataSet copia un DataTable o un IDataReader in un foglio, con le didascalie delle colonne o i nomi dei campi come riga di intestazione, e restituisce il numero di righe.

Grafici conservati

Formati, celle unite, grafici e formati condizionali vengono conservati quando un file XLSX viene caricato e salvato di nuovo, e i grafici di un foglio vengono stampati insieme ad esso.

Output PDF, HTML e PNG

ExportToPDFFile stampa un foglio o ogni foglio visibile con l'impostazione di pagina della cartella di lavoro, ExportToHTML scrive una tabella HTML per foglio, e ExportSheetPageToPNG renderizza una pagina stampata.

File Excel in ASP.NET Core e su Linux

Il pacchetto funziona in programmi console, servizi, ASP.NET Core e applicazioni desktop su Windows, Linux e macOS. SaveToStream scrive la cartella di lavoro su qualsiasi stream, così un'API web restituisce un file XLSX senza file temporaneo.

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

I componenti non sono thread safe: crea quelli che servono a una richiesta nel thread che la gestisce, e istanze separate funzionano in parallelo. Su Linux e nei container, installa i font TrueType usati dai tuoi documenti, oppure aggiungi una cartella di font con AddFontFolder. Le demo .NET includono ConversionServer, una minimal API ASP.NET Core che converte documenti su un server.

Anche una libreria DOCX C#: file Word e PDF

Lo stesso pacchetto crea e legge documenti Word. TsgcDocsWordProcessor legge e scrive DOCX, RTF, HTML, Markdown e testo, esegue stampe unione da un DataTable, CSV o JSON, ed esporta in PDF. TsgcDocsConverter converte tra documenti, fogli di calcolo, file PDF e immagini in una sola chiamata.

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

Documenti Word

Compila un modello DOCX creato in Word con ReplaceAll, oppure uniscilo ai tuoi dati, e salva il risultato come DOCX o PDF.

Elaborazione PDF

TsgcDocsPDFProcessor unisce, divide e ruota pagine, estrae testo, compila moduli, crittografa con AES-256, converte in PDF/A e firma.

Codici a barre e ZIP

TsgcDocsBarcode scrive QR Code, Data Matrix, Code 128 e altri come PNG, SVG o su una pagina PDF, e TsgcDocsZipArchive costruisce archivi ZIP64.

Installa la libreria Excel C# da NuGet

Aggiungi il pacchetto esegece.sgcDocs al progetto. NuGet aggiunge gli engine su cui si basa: esegece.sgcUICore, esegece.sgcPDF, esegece.sgcRichEdit, esegece.sgcGrid, esegece.sgcSpreadsheet e esegece.sgcCharts.

dotnet add package esegece.sgcDocs

esegece.sgcDocs è un pacchetto Registered, incluso in sgcUI .NET Enterprise e All-Access, e non è pubblicato su nuget.org. Le pagine PNG e SVG di documenti e fogli richiedono un pacchetto in più, esegece.sgcUICore.Rendering, così i server che scrivono solo file XLSX, DOCX e PDF non si portano dietro librerie di rendering native.

PacchettoFramework di destinazioneFunziona su
esegece.sgcDocs.NET Standard 2.0, .NET Framework 4.7.2, .NET 6, 8, 9 e 10Windows, Linux e macOS, in programmi console, servizi, ASP.NET Core e applicazioni desktop
esegece.sgcUICore.RenderingAggiunto solo quando servePagine PNG e SVG di documenti e fogli

Dove è inclusa la libreria Excel C#

sgcDocs non si vende da solo e non ha un'edizione Community gratuita. sgcUI .NET Enterprise include il codice sorgente C# completo e 1 anno di aggiornamenti.

sgcUI .NET Enterprise

Ogni prodotto sgcUI per .NET, sgcDocs incluso, con codice sorgente C# completo per WinForms, WPF e Avalonia, da €699 per sviluppatore.

All-Access

Ogni prodotto eSeGeCe, sgcUI Enterprise e sgcDocs inclusi.

Vedi All-Access →

Anche per Delphi e C++ Builder

La stessa API con gli stessi nomi di classe per Delphi da 7 a 13 e C++ Builder da 2007 a 13, su Win32, Win64 e Linux64.

sgcDocs per Delphi →

Domande frequenti

Aggiungi il pacchetto esegece.sgcDocs, crea un TsgcDocsSpreadsheet, chiama New, scrivi le celle con SetValues e SetFormulas, e chiama SaveToFile("report.xlsx"). La cartella di lavoro viene scritta da codice C# gestito, quindi sulla macchina non è necessario installare né Excel né Office.

Sì. Un testo che inizia con = è una formula, e l'engine calcola 320 funzioni Excel prima del salvataggio del file, così l'XLSX contiene sia le formule sia i loro valori. SetFormat imposta font, colori, riempimenti, allineamento, a capo automatico, bordi e formati numerici su un intervallo, e SetColumnWidths e SetRowHeights dimensionano il layout.

Sì, file XLSX, ODS e CSV. LoadFromFile o LoadFromStream carica valori, formule, stili, celle unite, impostazione di pagina, protezione e grafici, e Values, Formulas e Text leggono qualsiasi cella. Il formato binario XLS non è supportato.

Sì. Il pacchetto è destinato a .NET Standard 2.0, .NET Framework 4.7.2 e da .NET 6 a 10, e funziona in programmi console, servizi, ASP.NET Core e applicazioni desktop su Windows, Linux e macOS. Crea un componente per richiesta, perché i componenti non sono thread safe, e installa sul server i font TrueType usati dai tuoi documenti.

Sì. TsgcDocsWordProcessor nello stesso pacchetto crea, legge e modifica documenti DOCX, RTF, HTML e Markdown, compila modelli, esegue stampe unione ed esporta in PDF. TsgcDocsPDFProcessor unisce, crittografa, converte in PDF/A e firma file PDF.

No. sgcDocs non ha un'edizione Community gratuita. Il pacchetto .NET è solo Registered, è incluso in sgcUI .NET Enterprise e All-Access, e non è pubblicato su nuget.org. Per una valutazione .NET, contattaci.

Sì. La licenza sgcUI .NET Enterprise include il codice sorgente C# completo e 1 anno di aggiornamenti. Vedi la pagina dei prezzi di sgcUI.

La scelta più conveniente: All-AccessTutti i prodotti eSeGeCe, con Supporto Premium incluso, a partire da €1,059/anno.
Vedi i prezzi All-Access

Crea file Excel dal tuo codice C#

XLSX, DOCX e PDF da un unico pacchetto .NET, senza Office sulla macchina.