De .NET-rapportagetool voor C#
sgcReports is een .NET-rapportagetool en C#-rapportgenerator: bouw rapporten in code, toon ze in WinForms, WPF en Avalonia, exporteer PDF en Excel.
sgcReports is een .NET-rapportagetool en C#-rapportgenerator: bouw rapporten in code, toon ze in WinForms, WPF en Avalonia, exporteer PDF en Excel.
Gegroepeerde lijsten, facturen, tabellen en catalogi, één keer voorbereid door de rapportengine en getoond in een voorbeeld of geschreven naar PDF, Excel, CSV en afbeeldingen.
De ReportTables-demo in .NET WinForms: het voorbeeld met paginanavigatie, zoomen, afdrukken, PDF, zoeken, miniaturen en export, plus knoppen voor de ontwerper en de tabeleditor.
Een gegroepeerd rapport met een kop per groep, subtotalen en paginanummers.
Een factuur uit master- en detailgegevens, met zijn regels, de totalen en een QR-code.
Een JSON-rapportdefinitie en de pagina die ze weergeeft. Wijzig een indeling zonder je toepassing opnieuw te compileren.
Eén voorbereid rapport, geschreven naar PDF, een Excel-werkmap, een CSV-bestand en één PNG per pagina.
De tabeleditor van de rapportontwerper: kop-, gegevens- en voettekstrijen, samengevoegde cellen, stijlen en markeringen.
Geef het rapport zijn gegevens met een TsgcReportDataTableSource over een DataTable, beschrijf de indeling met de fluent TsgcReportBuilder en sla het op. De builder maakt zijn eigen rapport en rapportengine aan en beheert ze. Elk type staat in de namespace esegece.sgcReports, met dezelfde klassenamen als de Delphi-editie.
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;
}
}
Vul een DataTable vanuit je database of je objecten, geef hem aan de gegevensbron en sla het rapport op. PDF-uitvoer is standaard getagde PDF/UA, en dezelfde voorbereide pagina's gaan naar Excel en 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");
}
}
De builder voegt ook paginakoppen en voetteksten, kolomkoppen, detailbanden, tabellen, selectievakjes, barcodes, rapportparameters en bladwijzers toe. Zie het Help-onderwerp TsgcReportBuilder en de handleiding Aan de slag.
Elk UI-package heeft een rapportvoorbeeld en een kant-en-klare rapportontwerper voor eindgebruikers, zodat je gebruikers rapportindelingen in je toepassing kunnen openen, wijzigen en opslaan. De ontwerpers hebben een werkbalk, de tabbladen Design en Preview, de bomen Toolbox, Outline en Data, een eigenschappeninspector, linialen, ongedaan maken en opnieuw uitvoeren, en een scripteditor. De drie hosts delen één platformneutraal ontwerpermodel.
Het package esegece.sgcReports.WinForms: het besturingselement voor het rapportvoorbeeld, TsgcWinFormsReportDesigner (een UserControl), het modale TsgcWinFormsReportDesignerForm en sgcReports_Designer_WinForms.sgcShowReportDesigner.
Het package esegece.sgcReports.Wpf: TsgcWpfReportPreview met paginanavigatie, zoomen, afdrukken en PDF opslaan, TsgcWpfReportDesigner (een DockPanel) en het modale TsgcWpfReportDesignerWindow.
Het package esegece.sgcReports.Avalonia: TsgcAvaloniaReportPreview met paginanavigatie, zoomen en PDF opslaan, TsgcAvaloniaReportDesigner en sgcShowReportDesignerAsync met asynchrone bestandskiezers.
De voorbeelden hebben een zoekbalk, paginaminiaturen, de PDF-structuur, een menu Export met elf formaten, een knop Annuleren terwijl een lang rapport wordt voorbereid en een invoervenster voor de rapportparameters. De voorbeelden zitten in elke editie, de ontwerperklassen in de Registered-editie. De ontwerpers importeren ook ReportBuilder-.rtm-sjablonen als nieuwe rapporten. Zie de Help voor de .NET-ontwerper.
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 is een C#-rapportgenerator met banden: pagina's bevatten banden, banden bevatten items, en de engine drukt elke band op het juiste moment af voor je gegevens.
Banden voor rapporttitel en samenvatting, paginakop en voettekst, kolomkop, groepskop en voettekst, masterdata en detaildata, elk met zijn eigen hoogte, stijl en items.
Een groepskop begint een nieuwe groep telkens wanneer zijn expressie verandert, en een groepsvoettekst drukt subtotalen af met aggregatiefuncties zoals Sum en Count.
Koppel een detailbron aan zijn master met MasterSource, MasterFields en DetailFields, zoals een factuur zijn regels aan de factuur koppelt.
Velden en functies tussen vierkante haken in tekstitems, zoals [Sales.Customer] of [FormatFloat('#,0.00', Sum(Sales.Amount))], plus markeringen die de stijl van een item wijzigen wanneer een voorwaarde waar is.
Tabelitems met kop-, gegevens- en voettekstrijen, samengevoegde cellen en rijen die met hun tekst meegroeien, en kruistabellen met meerdere maten en totalen.
Getypeerde rapportparameters met een invoervenster, een kleine scripttaal die in het rapport wordt opgeslagen, en rapporten die erven van een basisindeling zoals een briefhoofd.
Gegevens komen uit een TsgcReportDataTableSource over een DataTable, of uit een TsgcReportJSONSource over een JSON-array van objecten. Opgemaakte tekst, watermerken, barcodes, selectievakjes en bladwijzers zitten in elke editie. Items voor diagrammen, sparklines, metertjes en draaitabellen komen met de Registered-bridgepackages sgcCharts, sgcGauges en sgcPivotGrid. Zie de functiematrix van sgcReports.
De engine bereidt de pagina's één keer voor en elke export schrijft ze in zijn eigen formaat. PDF-uitvoer gebruikt de sgcPDF-engine, dus sgcPDF is in elke configuratie vereist.
| Formaat | Details | .NET Community (gratis) |
|---|---|---|
| PDF/UA | Standaard getagde PDF/UA-1, met een leesvolgorde, alternatieve tekst voor afbeeldingen en gemarkeerde koppen. PDF/UA-2 op verzoek. | ✓ |
| PDF/A | PDF/A-3 (rpaA3b, rpaA3a) voor archieven en e-facturen met de factuur-XML ingesloten, en PDF/A-4. | ✓ |
| XLSX en CSV | Excel-werkmappen en CSV-bestanden uit dezelfde voorbereide pagina's. | ✓ |
| PNG, SVG, ODS, HTML en tekst | Eén afbeelding per pagina, OpenDocument-werkbladen, HTML en platte tekst. | ✓ |
| DOCX, ODT en RTF | Word-documenten, OpenDocument-tekst en Rich Text Format. | − |
| Ondertekende PDF | Het bridgepackage van sgcSign ondertekent de PDF-exports (PAdES). | ✓ |
De engine en de exports hebben geen UI nodig, dus hetzelfde rapport draait in een Windows-service, een web-API of een Linux-daemon. Laad een JSON-rapportdefinitie die door je code of de ontwerper is opgeslagen, voeg de gegevens toe en schrijf het bestand.
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 serveert geregistreerde rapporten (RegisterReport) als PDF, XLSX, CSV, HTML en andere bestanden, en de packages esegece.sgcReports.HTML en esegece.sgcReports.AspNetCore hosten zijn routes in ASP.NET Core.
Een server bereidt gelijktijdige rapporten voor met één engine en één set gegevensbronnen per thread. De .NET-demo's bevatten een LinuxDaemon- en een HTTPServer-project.
esegece.sgcReports bevat de builder, de gegevensbronnen, de engine en de exports. Voeg het package van je UI-framework toe voor het voorbeeld en de ontwerper, en de packages voor HTML en ASP.NET Core om rapporten op het web te serveren.
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
Gebruik voor de gratis Community-editie dezelfde package-id's met het achtervoegsel .Community, bijvoorbeeld dotnet add package esegece.sgcReports.Community. De volledige lijst met packages staat op de downloadpagina van sgcReports, en het .NET-overzicht legt de componenten uit. De .NET-demo's zijn Invoice, Groups, JSONDefinition, PDFUA, Exports, Fluent, HTTPServer, LinuxDaemon, DatabaseSQL en MobileMAUI.
De gratis Community-packages bevatten de engine, de exports en de voorbeelden. De Registered-editie voegt de ontwerpers voor eindgebruikers, de exports naar DOCX, ODT en RTF en de bridges voor diagrammen, metertjes en draaitabellen toe.
| Functie | .NET Community (gratis) | Registered |
|---|---|---|
| Fluent builder, rapportmodel en JSON-definities | ✓ | ✓ |
| Banden, groepen, master-detail en expressies | ✓ | ✓ |
| PDF/UA- en PDF/A-3-export | ✓ | ✓ |
| Export naar XLSX, CSV, PNG, ODS, SVG, HTML en platte tekst | ✓ | ✓ |
| Voorbeelden voor WinForms, WPF en Avalonia | ✓ | ✓ |
| Headless engine voor services en Linux | ✓ | ✓ |
| Rapportontwerper voor eindgebruikers voor WinForms, WPF en Avalonia | − | ✓ |
| Export naar DOCX, ODT en RTF | − | ✓ |
| Items voor diagrammen, sparklines, metertjes en draaitabellen | − | ✓ |
De .Community-packages zijn gratis voor particulieren en organisaties met minder dan EUR 1 mln jaarlijkse bruto-omzet en niet meer dan 5 ontwikkelaars. Organisaties die een van beide drempels bereiken of overschrijden hebben een Registered-licentie nodig.
Elke functie en de commerciële licentie. Single-, Team- en Site-licenties, elk met volledige broncode, 1 jaar updates en een verlengingskorting van 50% tot 70%.
Prijzen van sgcReports .NET →€199
Single-, Team- en Site-licenties beschikbaar.
Ja. sgcReports heeft een rapportvoorbeeld en een rapportontwerper voor eindgebruikers voor WinForms (esegece.sgcReports.WinForms), WPF (esegece.sgcReports.Wpf) en Avalonia (esegece.sgcReports.Avalonia). De voorbeelden tonen de pagina's met navigatie, zoomen, zoeken, miniaturen en export. De engine en de exports zitten in het kernpackage esegece.sgcReports en werken zonder enige UI.
Voeg het NuGet-package esegece.sgcReports toe (of esegece.sgcReports.Community), verpak je DataTable in een TsgcReportDataTableSource, beschrijf pagina's, banden en items met de fluent TsgcReportBuilder en roep SaveToPDF, SaveToXLSX of SaveToCSV aan, zoals in het voorbeeld Een rapport maken. Je kunt de indeling ook laden uit een JSON-rapportdefinitie.
Ja, met de Registered-editie. TsgcWinFormsReportDesigner, TsgcWpfReportDesigner en TsgcAvaloniaReportDesigner zijn ontwerpers die je in je eigen venster plaatst, en sgcShowReportDesigner opent er een als modaal venster. Gebruikers slepen items en velden naar banden, bewerken eigenschappen, tabellen en scripts, bekijken het resultaat en slaan de indeling op als JSON-definitie die je server headless kan uitvoeren.
Ja. SaveToPDF schrijft standaard getagde PDF/UA, PDFExport.PDFA schakelt over naar PDF/A-3, en SaveToXLSX schrijft een Excel-werkmap uit dezelfde voorbereide pagina's. CSV, PNG, SVG, ODS, HTML en platte tekst zitten in elke editie, en DOCX, ODT en RTF in de Registered-editie.
Ja. De headless engine en de exports draaien op Windows en op Linux, in services en daemons, en de .NET-demo's bevatten een LinuxDaemon-project. Voor het web integreert het package esegece.sgcReports.AspNetCore het rapporteindpunt met ASP.NET Core, dat rapporten serveert als PDF, XLSX, CSV, HTML en andere bestanden.
Ja. Elk sgcReports NuGet-package wordt ook geleverd als gratis Community-editie met het achtervoegsel .Community, met de engine, de exports en de voorbeelden. Het is gratis voor particulieren en organisaties met minder dan EUR 1 mln jaarlijkse bruto-omzet en niet meer dan 5 ontwikkelaars. De ontwerpers voor eindgebruikers en de exports naar DOCX, ODT en RTF vereisen een Registered-licentie, zie de prijzen van sgcReports.