L'outil de reporting .NET pour C#
sgcReports est un outil de reporting .NET et un générateur d'états C# : construis des états en code, affiche-les dans WinForms, WPF et Avalonia, exporte en PDF et Excel.
sgcReports est un outil de reporting .NET et un générateur d'états C# : construis des états en code, affiche-les dans WinForms, WPF et Avalonia, exporte en PDF et Excel.
Listes regroupées, factures, tableaux et catalogues, préparés une seule fois par le moteur d'états puis affichés dans un aperçu ou écrits en PDF, Excel, CSV et images.
La démo ReportTables dans .NET WinForms : l'aperçu avec navigation entre les pages, zoom, impression, PDF, recherche, miniatures et export, plus les boutons du concepteur et de l'éditeur de tableaux.
Un état regroupé avec un en-tête par groupe, des sous-totaux et des numéros de page.
Une facture à partir de données maître et détail, avec ses lignes, les totaux et un code QR.
Une définition d'état JSON et la page qu'elle produit. Change une mise en page sans recompiler ton application.
Un seul état préparé, écrit en PDF, en classeur Excel, en fichier CSV et en un PNG par page.
L'éditeur de tableaux du concepteur d'états : lignes d'en-tête, de données et de pied, cellules fusionnées, styles et surlignages.
Donne ses données à l'état avec un TsgcReportDataTableSource sur un DataTable, décris la mise en page avec le TsgcReportBuilder fluent, et enregistre-le. Le builder crée et possède son propre état et son propre moteur d'états. Chaque type est dans l'espace de noms esegece.sgcReports, avec les mêmes noms de classe que l'édition Delphi.
using esegece.sgcReports;
public static class SalesReport
{
// aSales: a TsgcReportDataTableSource named "Sales" over a DataTable
// with the columns Region, Customer and Amount, sorted by Region
public static TsgcReportBuilder Build(TsgcReportDataSource aSales)
{
TsgcReportBuilder oBuilder = new TsgcReportBuilder();
oBuilder.Title("Sales by region").Units(TsgcReportUnits.ruMillimeters)
.Style("Group").Font("Arial", 11).Bold().BackColor(0xEEEEEE).EndStyle()
.Page().Paper(TsgcReportPaperSize.rpsA4).Margins(15)
.ReportTitle(14)
.Text("Sales by region", 0, 0, 180, 10).Bold().EndBand()
// one header per region, one line per sale, a total per region
.GroupHeader("Sales.Region", 9).Style("Group")
.Text("Region: [Sales.Region]", 0, 1, 180, 7).EndBand()
.MasterData("Sales", 6)
.Text("[Sales.Customer]", 2, 0, 120, 6)
.Text("[Sales.Amount]", 130, 0, 50, 6).AlignRight().Format("#,0.00").EndBand()
.GroupFooter(9)
.Text("Region total [FormatFloat('#,0.00', Sum(Sales.Amount))]", 80, 1, 100, 6)
.AlignRight().Bold().EndBand()
.EndPage().Data(aSales);
return oBuilder;
}
}
Remplis un DataTable depuis ta base de données ou tes objets, transmets-le à la source de données et enregistre l'état. La sortie PDF est du PDF/UA balisé par défaut, et les mêmes pages préparées vont vers Excel et CSV.
using System.Data;
using esegece.sgcReports;
DataTable oTable = new DataTable("Sales");
oTable.Columns.Add("Region", typeof(string));
oTable.Columns.Add("Customer", typeof(string));
oTable.Columns.Add("Amount", typeof(double));
oTable.Rows.Add("East", "Acme Corp", 1450.00);
oTable.Rows.Add("East", "Blue Harbor", 600.00);
oTable.Rows.Add("North", "Nordic Labs", 2100.75);
using (TsgcReportDataTableSource oSales = new TsgcReportDataTableSource())
{
oSales.SourceName = "Sales";
oSales.DataTable = oTable;
using (TsgcReportBuilder oBuilder = SalesReport.Build(oSales))
{
// tagged PDF/UA by default, the same pages as an Excel workbook and a CSV file
oBuilder.SaveToPDF("sales.pdf");
oBuilder.SaveToXLSX("sales.xlsx");
oBuilder.SaveToCSV("sales.csv");
// PDF/A-3 on request, for archiving
oBuilder.PDFExport.PDFA = TsgcReportPDFAMode.rpaA3b;
oBuilder.SaveToPDF("sales-archive.pdf");
// keep the layout as a JSON report definition
sgcReports_Definition.sgcReportSaveToJSONFile(oBuilder.Report, "sales.json");
}
}
Le builder ajoute aussi des en-têtes et pieds de page, des en-têtes de colonne, des bandes de détail, des tableaux, des cases à cocher, des codes-barres, des paramètres d'état et des signets. Voir la rubrique d'aide TsgcReportBuilder et le guide de prise en main.
Chaque package d'interface a un aperçu d'état et un concepteur d'états prêt à l'emploi pour utilisateurs finaux, pour que tes utilisateurs puissent ouvrir, modifier et enregistrer des mises en page d'états dans ton application. Les concepteurs ont une barre d'outils, des onglets Design et Preview, les arbres Toolbox, Outline et Data, un inspecteur de propriétés, des règles, annuler et rétablir, et un éditeur de script. Les trois hôtes partagent un seul modèle de concepteur indépendant de la plateforme.
Le package esegece.sgcReports.WinForms : le contrôle d'aperçu d'état, TsgcWinFormsReportDesigner (un UserControl), le TsgcWinFormsReportDesignerForm modal et sgcReports_Designer_WinForms.sgcShowReportDesigner.
Le package esegece.sgcReports.Wpf : TsgcWpfReportPreview avec navigation entre les pages, zoom, impression et enregistrement PDF, TsgcWpfReportDesigner (un DockPanel) et le TsgcWpfReportDesignerWindow modal.
Le package esegece.sgcReports.Avalonia : TsgcAvaloniaReportPreview avec navigation entre les pages, zoom et enregistrement PDF, TsgcAvaloniaReportDesigner et sgcShowReportDesignerAsync avec des sélecteurs de fichiers asynchrones.
Les aperçus ont une barre de recherche, des miniatures de pages, le plan du PDF, un menu Export avec onze formats, un bouton Cancel pendant la préparation d'un long état et une invite pour les paramètres de l'état. Les aperçus sont dans toutes les éditions, les classes de concepteur sont dans l'édition Registered. Les concepteurs importent aussi les modèles ReportBuilder .rtm comme nouveaux états. Voir l'aide du concepteur .NET.
using System.Data;
using System.Windows.Forms;
using esegece.sgcReports;
public class SalesForm : Form
{
TsgcReportDataTableSource FSales;
TsgcReportBuilder FBuilder;
TsgcReportPreviewVCL FPreview;
public SalesForm(DataTable aSales)
{
Width = 1000;
Height = 760;
FSales = new TsgcReportDataTableSource();
FSales.SourceName = "Sales";
FSales.DataTable = aSales;
FBuilder = SalesReport.Build(FSales);
// the preview: page navigation, zoom, find, thumbnails, print and export
FPreview = new TsgcReportPreviewVCL();
FPreview.Dock = DockStyle.Fill;
Controls.Add(FPreview);
Button oDesign = new Button();
oDesign.Text = "Design...";
oDesign.Dock = DockStyle.Top;
oDesign.Click += (s, e) =>
{
// the end-user designer (Registered edition) as a modal window
if (sgcReports_Designer_WinForms.sgcShowReportDesigner(FBuilder.Engine, FSales))
{
sgcReports_Definition.sgcReportSaveToJSONFile(FBuilder.Engine.Report, "sales.json");
FPreview.Prepare();
}
};
Controls.Add(oDesign);
FPreview.Engine = FBuilder.Engine;
FPreview.Prepare();
}
}
using System.Windows;
using esegece.sgcReports;
public class DesignerWindow : Window
{
public DesignerWindow(TsgcReportEngine aEngine, TsgcReportDataSource aSales)
{
Title = "Report designer";
TsgcWpfReportDesigner oDesigner = new TsgcWpfReportDesigner();
Content = oDesigner;
oDesigner.Engine = aEngine;
oDesigner.AddDataSource(aSales);
oDesigner.LoadFromFile("sales.json");
Closed += (s, e) => oDesigner.Dispose();
}
}
public class PreviewWindow : Window
{
public PreviewWindow(TsgcReportEngine aEngine)
{
TsgcWpfReportPreview oPreview = new TsgcWpfReportPreview();
Content = oPreview;
oPreview.Engine = aEngine;
oPreview.Prepare();
}
}
sgcReports est un générateur d'états C# par bandes : les pages contiennent des bandes, les bandes contiennent des éléments, et le moteur imprime chaque bande au bon moment pour tes données.
Bandes de titre et de synthèse de l'état, d'en-tête et de pied de page, d'en-tête de colonne, d'en-tête et de pied de groupe, de données maîtres et de données de détail, chacune avec sa propre hauteur, son style et ses éléments.
Un en-tête de groupe commence un nouveau groupe à chaque changement de son expression, et un pied de groupe imprime des sous-totaux avec des fonctions d'agrégation telles que Sum et Count.
Relie une source de détail à son maître avec MasterSource, MasterFields et DetailFields, comme une facture relie ses lignes à la facture.
Des champs et des fonctions entre crochets dans les éléments de texte, comme [Sales.Customer] ou [FormatFloat('#,0.00', Sum(Sales.Amount))], plus des surlignages qui changent le style d'un élément quand une condition est vraie.
Des éléments tableau avec lignes d'en-tête, de données et de pied, cellules fusionnées et lignes qui s'agrandissent avec leur texte, et des tableaux croisés avec plusieurs mesures et totaux.
Des paramètres d'état typés avec une invite, un petit langage de script stocké dans l'état, et des états qui héritent d'une mise en page de base comme un papier à en-tête.
Les données viennent d'un TsgcReportDataTableSource sur un DataTable, ou d'un TsgcReportJSONSource sur un tableau JSON d'objets. Le texte enrichi, les filigranes, les codes-barres, les cases à cocher et les signets sont dans toutes les éditions. Les éléments graphique, sparkline, jauge et tableau croisé dynamique viennent avec les packages passerelles Registered sgcCharts, sgcGauges et sgcPivotGrid. Voir la matrice des fonctionnalités de sgcReports.
Le moteur prépare les pages une seule fois, et chaque export les écrit dans son propre format. La sortie PDF utilise le moteur sgcPDF, donc sgcPDF est requis dans toutes les configurations.
| Format | Détails | .NET Community (gratuit) |
|---|---|---|
| PDF/UA | PDF/UA-1 balisé par défaut, avec un ordre de lecture, un texte alternatif pour les images et des titres marqués. PDF/UA-2 sur demande. | ✓ |
| PDF/A | PDF/A-3 (rpaA3b, rpaA3a) pour les archives et les factures électroniques avec le XML de la facture intégré, et PDF/A-4. | ✓ |
| XLSX et CSV | Classeurs Excel et fichiers CSV à partir des mêmes pages préparées. | ✓ |
| PNG, SVG, ODS, HTML et texte | Une image par page, des feuilles de calcul OpenDocument, du HTML et du texte brut. | ✓ |
| DOCX, ODT et RTF | Documents Word, texte OpenDocument et Rich Text Format. | − |
| PDF signé | Le package passerelle sgcSign signe les exports PDF (PAdES). | ✓ |
Le moteur et les exports n'ont besoin d'aucune interface, donc le même état s'exécute dans un service Windows, une API web ou un daemon Linux. Charge une définition d'état JSON enregistrée par ton code ou par le concepteur, attache les données et écris le fichier.
using System.Data;
using esegece.sgcReports;
public static class ReportJob
{
public static void Run(DataTable aSales, string aFileName)
{
using (TsgcReport oReport = new TsgcReport())
using (TsgcReportEngine oEngine = new TsgcReportEngine())
using (TsgcReportDataTableSource oSales = new TsgcReportDataTableSource())
using (TsgcReportPDFExport oPDF = new TsgcReportPDFExport())
{
// the layout comes from a JSON definition, the data from your code
sgcReports_Definition.sgcReportLoadFromJSONFile(oReport, "sales.json");
oSales.SourceName = "Sales";
oSales.DataTable = aSales;
oEngine.Report = oReport;
oEngine.AddDataSource(oSales);
TsgcReportPreparedPages oPages = oEngine.Prepare();
oPDF.SaveToFile(oPages, aFileName);
}
}
}
TsgcReportHTTPEndpoint sert les états enregistrés (RegisterReport) en PDF, XLSX, CSV, HTML et autres fichiers, et les packages esegece.sgcReports.HTML et esegece.sgcReports.AspNetCore hébergent ses routes dans ASP.NET Core.
Un serveur prépare des états concurrents avec un moteur et un jeu de sources de données par thread. Les démos .NET incluent un projet LinuxDaemon et un projet HTTPServer.
esegece.sgcReports contient le builder, les sources de données, le moteur et les exports. Ajoute le package de ton framework d'interface pour l'aperçu et le concepteur, et les packages HTML et ASP.NET Core pour servir des états sur le web.
dotnet add package esegece.sgcReports
dotnet add package esegece.sgcReports.WinForms
dotnet add package esegece.sgcReports.Wpf
dotnet add package esegece.sgcReports.Avalonia
dotnet add package esegece.sgcReports.AspNetCore
Pour l'édition Community gratuite, utilise les mêmes identifiants de package avec le suffixe .Community, par exemple dotnet add package esegece.sgcReports.Community. La liste complète des packages est sur la page de téléchargement de sgcReports, et l'aperçu .NET explique les composants. Les démos .NET sont Invoice, Groups, JSONDefinition, PDFUA, Exports, Fluent, HTTPServer, LinuxDaemon, DatabaseSQL et MobileMAUI.
Les packages Community gratuits incluent le moteur, les exports et les aperçus. L'édition Registered ajoute les concepteurs pour utilisateurs finaux, les exports DOCX, ODT et RTF et les passerelles graphique, jauge et tableau croisé dynamique.
| Fonctionnalité | .NET Community (gratuit) | Registered |
|---|---|---|
| Builder fluent, modèle d'état et définitions JSON | ✓ | ✓ |
| Bandes, groupes, maître-détail et expressions | ✓ | ✓ |
| Export PDF/UA et PDF/A-3 | ✓ | ✓ |
| Export XLSX, CSV, PNG, ODS, SVG, HTML et texte brut | ✓ | ✓ |
| Aperçus WinForms, WPF et Avalonia | ✓ | ✓ |
| Moteur headless pour les services et Linux | ✓ | ✓ |
| Concepteur d'états pour utilisateurs finaux pour WinForms, WPF et Avalonia | − | ✓ |
| Export DOCX, ODT et RTF | − | ✓ |
| Éléments graphique, sparkline, jauge et tableau croisé dynamique | − | ✓ |
Les packages .Community sont gratuits pour les particuliers et les organisations sous 1 M EUR de chiffre d'affaires annuel brut, avec 5 développeurs au plus. Les organisations qui atteignent ou dépassent l'un de ces seuils ont besoin d'une licence Registered.
Toutes les fonctionnalités et la licence commerciale. Licences Single, Team et Site, chacune avec le code source complet, 1 an de mises à jour et une remise de renouvellement de 50 % à 70 %.
Tarifs de sgcReports .NET →€199
Licences Single, Team et Site disponibles.
Oui. sgcReports a un aperçu d'état et un concepteur d'états pour utilisateurs finaux pour WinForms (esegece.sgcReports.WinForms), WPF (esegece.sgcReports.Wpf) et Avalonia (esegece.sgcReports.Avalonia). Les aperçus affichent les pages avec navigation, zoom, recherche, miniatures et export. Le moteur et les exports sont dans le package noyau esegece.sgcReports et fonctionnent sans aucune interface.
Ajoute le package NuGet esegece.sgcReports (ou esegece.sgcReports.Community), enveloppe ton DataTable dans un TsgcReportDataTableSource, décris les pages, les bandes et les éléments avec le TsgcReportBuilder fluent et appelle SaveToPDF, SaveToXLSX ou SaveToCSV, comme dans l'exemple de création d'un état. Tu peux aussi charger la mise en page depuis une définition d'état JSON.
Oui, avec l'édition Registered. TsgcWinFormsReportDesigner, TsgcWpfReportDesigner et TsgcAvaloniaReportDesigner sont des concepteurs que tu places dans ta propre fenêtre, et sgcShowReportDesigner en ouvre un comme fenêtre modale. Les utilisateurs font glisser des éléments et des champs sur les bandes, modifient les propriétés, les tableaux et les scripts, prévisualisent le résultat et enregistrent la mise en page comme définition JSON que ton serveur peut exécuter en mode headless.
Oui. SaveToPDF écrit par défaut du PDF/UA balisé, PDFExport.PDFA passe en PDF/A-3, et SaveToXLSX écrit un classeur Excel à partir des mêmes pages préparées. CSV, PNG, SVG, ODS, HTML et texte brut sont dans toutes les éditions, et DOCX, ODT et RTF dans l'édition Registered.
Oui. Le moteur headless et les exports s'exécutent sous Windows et sous Linux, dans des services et des daemons, et les démos .NET incluent un projet LinuxDaemon. Pour le web, le package esegece.sgcReports.AspNetCore intègre le point de terminaison d'états à ASP.NET Core, qui sert les états en PDF, XLSX, CSV, HTML et autres fichiers.
Oui. Chaque package NuGet sgcReports est aussi fourni en édition Community gratuite avec le suffixe .Community, avec le moteur, les exports et les aperçus. Elle est gratuite pour les particuliers et les organisations sous 1 M EUR de chiffre d'affaires annuel brut, avec 5 développeurs au plus. Les concepteurs pour utilisateurs finaux et les exports DOCX, ODT et RTF nécessitent une licence Registered, voir les tarifs de sgcReports.