Lo strumento di reportistica .NET per C#
sgcReports è uno strumento di reportistica .NET e un generatore di report C#: costruisci report in codice, mostrali in WinForms, WPF e Avalonia, esporta PDF ed Excel.
sgcReports è uno strumento di reportistica .NET e un generatore di report C#: costruisci report in codice, mostrali in WinForms, WPF e Avalonia, esporta PDF ed Excel.
Elenchi raggruppati, fatture, tabelle e cataloghi, preparati una sola volta dall'engine di report e mostrati in un'anteprima o scritti in PDF, Excel, CSV e immagini.
La demo ReportTables in .NET WinForms: l'anteprima con navigazione tra le pagine, zoom, stampa, PDF, ricerca, miniature ed esportazione, più i pulsanti per il designer e l'editor di tabelle.
Un report raggruppato con un'intestazione per gruppo, subtotali e numeri di pagina.
Una fattura da dati master e detail, con le sue righe, i totali e un codice QR.
Una definizione di report JSON e la pagina che genera. Cambia un layout senza ricompilare la tua applicazione.
Un report preparato, scritto in PDF, in una cartella di lavoro Excel, in un file CSV e in un PNG per pagina.
L'editor di tabelle del designer di report: righe di intestazione, dati e piè di pagina, celle unite, stili ed evidenziazioni.
Fornisci al report i dati con un TsgcReportDataTableSource su un DataTable, descrivi il layout con il TsgcReportBuilder fluent e salvalo. Il builder crea e possiede il proprio report e il proprio engine di report. Ogni tipo è nel namespace esegece.sgcReports, con gli stessi nomi di classe dell'edizione 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;
}
}
Riempi un DataTable dal tuo database o dai tuoi oggetti, passalo all'origine dati e salva il report. L'output PDF è per impostazione predefinita PDF/UA con tag, e le stesse pagine preparate vanno in Excel e 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");
}
}
Il builder aggiunge anche intestazioni e piè di pagina, intestazioni di colonna, bande di dettaglio, tabelle, caselle di controllo, codici a barre, parametri del report e segnalibri. Vedi l'argomento della guida su TsgcReportBuilder e la guida introduttiva.
Ogni pacchetto UI ha un'anteprima dei report e un designer di report per l'utente finale già pronto, così i tuoi utenti possono aprire, modificare e salvare i layout dei report dentro la tua applicazione. I designer hanno una barra degli strumenti, le schede Design e Preview, gli alberi Toolbox, Outline e Data, un property inspector, righelli, annulla e ripeti, e un editor di script. I tre host condividono un unico modello di designer indipendente dalla piattaforma.
Il pacchetto esegece.sgcReports.WinForms: il controllo di anteprima dei report, TsgcWinFormsReportDesigner (uno UserControl), il modale TsgcWinFormsReportDesignerForm e sgcReports_Designer_WinForms.sgcShowReportDesigner.
Il pacchetto esegece.sgcReports.Wpf: TsgcWpfReportPreview con navigazione tra le pagine, zoom, stampa e salvataggio in PDF, TsgcWpfReportDesigner (un DockPanel) e il modale TsgcWpfReportDesignerWindow.
Il pacchetto esegece.sgcReports.Avalonia: TsgcAvaloniaReportPreview con navigazione tra le pagine, zoom e salvataggio in PDF, TsgcAvaloniaReportDesigner e sgcShowReportDesignerAsync con selettori di file asincroni.
Le anteprime hanno una barra di ricerca, miniature delle pagine, la struttura del PDF, un menu Export con undici formati, un pulsante Annulla mentre viene preparato un report lungo e una richiesta per i parametri del report. Le anteprime sono in ogni edizione, le classi designer sono nell'edizione Registered. I designer importano inoltre i modelli .rtm di ReportBuilder come nuovi report. Vedi la guida dei designer .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 è un generatore di report C# a bande: le pagine contengono bande, le bande contengono elementi, e l'engine stampa ogni banda al momento giusto per i tuoi dati.
Bande di titolo e riepilogo del report, intestazione e piè di pagina, intestazione di colonna, intestazione e piè di gruppo, dati master e dati di dettaglio, ciascuna con la propria altezza, il proprio stile e i propri elementi.
Un'intestazione di gruppo avvia un nuovo gruppo ogni volta che la sua espressione cambia, e un piè di gruppo stampa subtotali con funzioni di aggregazione come Sum e Count.
Collega un'origine di dettaglio al suo master con MasterSource, MasterFields e DetailFields, come una fattura collega le proprie righe alla fattura.
Campi e funzioni tra parentesi quadre negli elementi di testo, come [Sales.Customer] o [FormatFloat('#,0.00', Sum(Sales.Amount))], più evidenziazioni che cambiano lo stile di un elemento quando una condizione è vera.
Elementi tabella con righe di intestazione, dati e piè di pagina, celle unite e righe che crescono con il loro testo, e tabelle crosstab con più misure e totali.
Parametri del report tipizzati con una richiesta, un piccolo linguaggio di script memorizzato nel report, e report che ereditano da un layout di base come una carta intestata.
I dati arrivano da un TsgcReportDataTableSource su un DataTable, oppure da un TsgcReportJSONSource su un array JSON di oggetti. Rich text, filigrane, codici a barre, caselle di controllo e segnalibri sono in ogni edizione. Gli elementi grafico, sparkline, gauge e tabella pivot arrivano con i pacchetti ponte Registered sgcCharts, sgcGauges e sgcPivotGrid. Vedi la matrice delle funzionalità di sgcReports.
L'engine prepara le pagine una sola volta, e ogni esportazione le scrive nel proprio formato. L'output PDF usa l'engine sgcPDF, quindi sgcPDF è necessario in ogni configurazione.
| Formato | Dettagli | .NET Community (gratuita) |
|---|---|---|
| PDF/UA | PDF/UA-1 con tag per impostazione predefinita, con ordine di lettura, testo alternativo per le immagini e intestazioni contrassegnate. PDF/UA-2 su richiesta. | ✓ |
| PDF/A | PDF/A-3 (rpaA3b, rpaA3a) per archivi e fatture elettroniche con l'XML della fattura incorporato, e PDF/A-4. | ✓ |
| XLSX e CSV | Cartelle di lavoro Excel e file CSV dalle stesse pagine preparate. | ✓ |
| PNG, SVG, ODS, HTML e testo | Un'immagine per pagina, fogli di calcolo OpenDocument, HTML e testo semplice. | ✓ |
| DOCX, ODT e RTF | Documenti Word, testo OpenDocument e Rich Text Format. | − |
| PDF firmato | Il pacchetto ponte sgcSign firma le esportazioni PDF (PAdES). | ✓ |
L'engine e le esportazioni non richiedono interfaccia, quindi lo stesso report funziona in un servizio Windows, in un'API web o in un daemon Linux. Carica una definizione di report JSON salvata dal tuo codice o dal designer, collega i dati e scrivi il file.
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 serve i report registrati (RegisterReport) come PDF, XLSX, CSV, HTML e altri file, e i pacchetti esegece.sgcReports.HTML ed esegece.sgcReports.AspNetCore ospitano le sue route in ASP.NET Core.
Un server prepara report concorrenti con un engine e un insieme di origini dati per thread. Le demo .NET includono un progetto LinuxDaemon e uno HTTPServer.
esegece.sgcReports contiene il builder, le origini dati, l'engine e le esportazioni. Aggiungi il pacchetto del tuo framework UI per l'anteprima e il designer, e i pacchetti HTML e ASP.NET Core per servire i report sul 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
Per l'edizione Community gratuita, usa gli stessi id di pacchetto con il suffisso .Community, per esempio dotnet add package esegece.sgcReports.Community. L'elenco completo dei pacchetti è nella pagina di download di sgcReports, e la panoramica .NET spiega i componenti. Le demo .NET sono Invoice, Groups, JSONDefinition, PDFUA, Exports, Fluent, HTTPServer, LinuxDaemon, DatabaseSQL e MobileMAUI.
I pacchetti Community gratuiti includono l'engine, le esportazioni e le anteprime. L'edizione Registered aggiunge i designer per l'utente finale, le esportazioni DOCX, ODT e RTF e i ponti per grafici, gauge e tabelle pivot.
| Funzionalità | .NET Community (gratuita) | Registered |
|---|---|---|
| Builder fluent, modello di report e definizioni JSON | ✓ | ✓ |
| Bande, gruppi, master detail ed espressioni | ✓ | ✓ |
| Esportazione PDF/UA e PDF/A-3 | ✓ | ✓ |
| Esportazione XLSX, CSV, PNG, ODS, SVG, HTML e testo semplice | ✓ | ✓ |
| Anteprime WinForms, WPF e Avalonia | ✓ | ✓ |
| Engine headless per servizi e Linux | ✓ | ✓ |
| Designer di report per l'utente finale per WinForms, WPF e Avalonia | − | ✓ |
| Esportazione DOCX, ODT e RTF | − | ✓ |
| Elementi grafico, sparkline, gauge e tabella pivot | − | ✓ |
I pacchetti .Community sono gratuiti per privati e organizzazioni con ricavi lordi annui inferiori a 1 milione di EUR e non più di 5 sviluppatori. Le organizzazioni che raggiungono o superano una delle due soglie hanno bisogno di una licenza Registered.
Ogni funzionalità e la licenza commerciale. Licenze Single, Team e Site, ciascuna con codice sorgente completo, 1 anno di aggiornamenti e uno sconto di rinnovo dal 50% al 70%.
Prezzi di sgcReports .NET →€199
Licenze Single, Team e Site disponibili.
Sì. sgcReports ha un'anteprima dei report e un designer di report per l'utente finale per WinForms (esegece.sgcReports.WinForms), WPF (esegece.sgcReports.Wpf) e Avalonia (esegece.sgcReports.Avalonia). Le anteprime mostrano le pagine con navigazione, zoom, ricerca, miniature ed esportazione. L'engine e le esportazioni sono nel pacchetto core esegece.sgcReports e funzionano senza alcuna interfaccia.
Aggiungi il pacchetto NuGet esegece.sgcReports (o esegece.sgcReports.Community), racchiudi il tuo DataTable in un TsgcReportDataTableSource, descrivi pagine, bande ed elementi con il TsgcReportBuilder fluent e chiama SaveToPDF, SaveToXLSX o SaveToCSV, come nell'esempio di creazione di un report. Puoi anche caricare il layout da una definizione di report JSON.
Sì, con l'edizione Registered. TsgcWinFormsReportDesigner, TsgcWpfReportDesigner e TsgcAvaloniaReportDesigner sono designer che inserisci nella tua finestra, e sgcShowReportDesigner ne apre uno come finestra modale. Gli utenti trascinano elementi e campi sulle bande, modificano proprietà, tabelle e script, visualizzano l'anteprima del risultato e salvano il layout come definizione JSON che il tuo server può eseguire headless.
Sì. SaveToPDF scrive PDF/UA con tag per impostazione predefinita, PDFExport.PDFA passa a PDF/A-3, e SaveToXLSX scrive una cartella di lavoro Excel dalle stesse pagine preparate. CSV, PNG, SVG, ODS, HTML e testo semplice sono in ogni edizione, e DOCX, ODT e RTF nell'edizione Registered.
Sì. L'engine headless e le esportazioni funzionano su Windows e su Linux, in servizi e daemon, e le demo .NET includono un progetto LinuxDaemon. Per il web, il pacchetto esegece.sgcReports.AspNetCore integra l'endpoint dei report con ASP.NET Core, che serve i report come PDF, XLSX, CSV, HTML e altri file.
Sì. Ogni pacchetto NuGet di sgcReports è disponibile anche come edizione Community gratuita con il suffisso .Community, con l'engine, le esportazioni e le anteprime. È gratuita per privati e organizzazioni con ricavi lordi annui inferiori a 1 milione di EUR e non più di 5 sviluppatori. I designer per l'utente finale e le esportazioni DOCX, ODT e RTF richiedono una licenza Registered, vedi i prezzi di sgcReports.