C# pour .NET XLSX, ODS et CSV Sans Office

La bibliothèque Excel C# pour les fichiers XLSX

sgcDocs est une bibliothèque Excel C# qui crée et lit des fichiers XLSX avec formules, styles et formats numériques, sans Office installé, sous Windows, Linux et macOS.

320 fonctions Excel calculées Polices, remplissages, bordures, formats numériques ASP.NET Core, services, Linux DOCX et PDF dans la même API

Inclus dans sgcUI .NET Enterprise. Voir les tarifs →

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

Comment créer un fichier Excel en C#

Pour créer un fichier Excel en C# sans Excel, crée un TsgcDocsSpreadsheet, appelle New, écris des valeurs et des formules par adresse de cellule, mets en forme les cellules et appelle SaveToFile. Le format vient de l'extension du fichier, donc le même classeur s'enregistre aussi en ODS ou en 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");
        }
    }
}

Le fichier conserve les formules et leurs valeurs calculées. Text renvoie une cellule telle qu'elle est imprimée, avec son format numérique appliqué. La classe C# garde les noms de l'édition Delphi : une propriété indexée telle que Values['A1'] devient la paire de méthodes Values et SetValues, et il en va de même pour Formulas, ColumnWidths et RowHeights.

Lis et mets à jour un fichier XLSX en C#

LoadFromFile et LoadFromStream chargent du XLSX, de l'ODS et du CSV avec les valeurs, formules, styles, cellules fusionnées, mise en page, mise en page d'impression, protection, graphiques et formats conditionnels des fichiers XLSX. Modifie ce dont tu as besoin, recalcule et enregistre.

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 renvoie un object : null pour une cellule vide, un DateTime pour une date et le texte de l'erreur, tel que #DIV/0!, pour une erreur. Evaluate exécute n'importe quelle formule sur le classeur sans l'écrire dans une cellule.

Formules, styles et données dans tes fichiers XLSX

Le moteur de classeur derrière TsgcDocsSpreadsheet est du code C# managé. Il n'a besoin ni d'Excel, ni d'interopérabilité COM, ni de bibliothèque native sur la machine qui l'exécute.

320 fonctions Excel

Un texte qui commence par = est une formule. Le moteur calcule 320 fonctions Excel, dont LET, LAMBDA et les fonctions LAMBDA nommées, et DefineName ajoute des noms de classeur tels que VAT ou une LAMBDA réutilisable.

Styles et formats numériques

SetFormat règle la taille de police, le gras, l'italique, les couleurs, le remplissage, l'alignement, le retour à la ligne, le format numérique, les bordures, le retrait et la rotation d'une plage. MergeCells fusionne une plage.

Mise en page et feuilles

Largeurs de colonne et hauteurs de ligne, AddSheet, RenameSheet, qui réécrit les formules faisant référence à la feuille, DeleteSheet, et protection des feuilles et du classeur.

Des données issues de ta base de données

ImportDataSet copie un DataTable ou un IDataReader dans une feuille, avec les titres de colonnes ou les noms de champs comme ligne d'en-tête, et renvoie le nombre de lignes.

Graphiques conservés

Les formats, les cellules fusionnées, les graphiques et les formats conditionnels sont conservés quand un fichier XLSX est chargé puis enregistré de nouveau, et les graphiques d'une feuille sont imprimés avec elle.

Sortie PDF, HTML et PNG

ExportToPDFFile imprime une feuille ou toutes les feuilles visibles avec la mise en page d'impression du classeur, ExportToHTML écrit un tableau HTML par feuille, et ExportSheetPageToPNG rend une page imprimée.

Des fichiers Excel dans ASP.NET Core et sous Linux

Le package s'exécute dans des programmes console, des services, ASP.NET Core et des applications de bureau sous Windows, Linux et macOS. SaveToStream écrit le classeur dans n'importe quel flux, donc une API web renvoie un fichier XLSX sans fichier temporaire.

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

Les composants ne sont pas thread-safe : crée ceux dont une requête a besoin dans le thread qui la sert, et des instances séparées s'exécutent en parallèle. Sous Linux et dans les conteneurs, installe les polices TrueType que tes documents utilisent, ou ajoute un dossier de polices avec AddFontFolder. Les démos .NET incluent ConversionServer, une minimal API ASP.NET Core qui convertit des documents sur un serveur.

Aussi une bibliothèque DOCX C# : fichiers Word et PDF

Le même package crée et lit des documents Word. TsgcDocsWordProcessor lit et écrit du DOCX, du RTF, du HTML, du Markdown et du texte, exécute des publipostages depuis un DataTable, un CSV ou du JSON, et exporte en PDF. TsgcDocsConverter convertit entre documents, feuilles de calcul, fichiers PDF et images en un seul appel.

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

Documents Word

Remplis un modèle DOCX créé dans Word avec ReplaceAll, ou fusionne-le avec tes données, et enregistre le résultat en DOCX ou en PDF.

Traitement de PDF

TsgcDocsPDFProcessor fusionne, scinde et fait pivoter des pages, extrait du texte, remplit des formulaires, chiffre en AES-256, convertit en PDF/A et signe.

Codes-barres et ZIP

TsgcDocsBarcode écrit des QR Code, Data Matrix, Code 128 et plus en PNG, SVG ou sur une page PDF, et TsgcDocsZipArchive construit des archives ZIP64.

Installe la bibliothèque Excel C# depuis NuGet

Ajoute le package esegece.sgcDocs au projet. NuGet ajoute les moteurs sur lesquels il repose : esegece.sgcUICore, esegece.sgcPDF, esegece.sgcRichEdit, esegece.sgcGrid, esegece.sgcSpreadsheet et esegece.sgcCharts.

dotnet add package esegece.sgcDocs

esegece.sgcDocs est un package Registered, inclus dans sgcUI .NET Enterprise et All-Access, et il n'est pas publié sur nuget.org. Les pages PNG et SVG de documents et de feuilles nécessitent un package de plus, esegece.sgcUICore.Rendering, pour que les serveurs qui n'écrivent que des fichiers XLSX, DOCX et PDF ne portent pas de bibliothèques de rendu natives.

PackageFrameworks ciblesS'exécute sur
esegece.sgcDocs.NET Standard 2.0, .NET Framework 4.7.2, .NET 6, 8, 9 et 10Windows, Linux et macOS, dans des programmes console, des services, ASP.NET Core et des applications de bureau
esegece.sgcUICore.RenderingAjouté seulement si nécessairePages PNG et SVG de documents et de feuilles

Où la bibliothèque Excel C# est incluse

sgcDocs ne se vend pas seul et n'a pas d'édition Community gratuite. sgcUI .NET Enterprise inclut le code source C# complet et 1 an de mises à jour.

sgcUI .NET Enterprise

Tous les produits sgcUI pour .NET, sgcDocs compris, avec le code source C# complet pour WinForms, WPF et Avalonia, à partir de €699 par développeur.

All-Access

Tous les produits eSeGeCe, sgcUI Enterprise et sgcDocs compris.

Voir All-Access →

Aussi pour Delphi et C++ Builder

La même API avec les mêmes noms de classe pour Delphi 7 à 13 et C++ Builder 2007 à 13, sous Win32, Win64 et Linux64.

sgcDocs pour Delphi →

Foire aux questions

Ajoute le package esegece.sgcDocs, crée un TsgcDocsSpreadsheet, appelle New, écris les cellules avec SetValues et SetFormulas, et appelle SaveToFile("report.xlsx"). Le classeur est écrit par du code C# managé, donc ni Excel ni Office n'ont besoin d'être installés sur la machine.

Oui. Un texte qui commence par = est une formule, et le moteur calcule 320 fonctions Excel avant l'enregistrement du fichier, donc le XLSX contient à la fois les formules et leurs valeurs. SetFormat règle les polices, les couleurs, les remplissages, l'alignement, le retour à la ligne, les bordures et les formats numériques d'une plage, et SetColumnWidths et SetRowHeights dimensionnent la mise en page.

Oui, les fichiers XLSX, ODS et CSV. LoadFromFile ou LoadFromStream charge les valeurs, les formules, les styles, les cellules fusionnées, la mise en page d'impression, la protection et les graphiques, et Values, Formulas et Text lisent n'importe quelle cellule. Le format binaire XLS n'est pas pris en charge.

Oui. Le package cible .NET Standard 2.0, .NET Framework 4.7.2 et .NET 6 à 10, et s'exécute dans des programmes console, des services, ASP.NET Core et des applications de bureau sous Windows, Linux et macOS. Crée un composant par requête, car les composants ne sont pas thread-safe, et installe sur le serveur les polices TrueType que tes documents utilisent.

Oui. TsgcDocsWordProcessor dans le même package crée, lit et modifie des documents DOCX, RTF, HTML et Markdown, remplit des modèles, exécute des publipostages et exporte en PDF. TsgcDocsPDFProcessor fusionne, chiffre, convertit en PDF/A et signe des fichiers PDF.

Non. sgcDocs n'a pas d'édition Community gratuite. Le package .NET est Registered uniquement, il est inclus dans sgcUI .NET Enterprise et All-Access, et il n'est pas publié sur nuget.org. Pour une évaluation .NET, contacte-nous.

Oui. La licence sgcUI .NET Enterprise inclut le code source C# complet et 1 an de mises à jour. Voir la page des tarifs de sgcUI.

Meilleur rapport qualité-prix : All-AccessTous les produits eSeGeCe, Support Premium inclus, à partir de €1,059/an.
Voir les tarifs All-Access

Crée des fichiers Excel depuis ton code C#

XLSX, DOCX et PDF avec un seul package .NET, sans Office sur la machine.