C# per .NET NuGet Edizione Community gratuita

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.

Builder C# fluent e layout JSON Designer per WinForms, WPF, Avalonia PDF/UA, PDF/A-3, XLSX e CSV Headless in servizi e su Linux

Vedi i prezzi →   Download e demo .NET →

Report di turno costruito con sgcReports e mostrato nell'anteprima report: una pagina A4 con riquadri OEE, disponibilità, prestazioni e qualità, un grafico della produzione per ora, barre dei fermi per causa e un codice a barre del lotto

Report costruiti con sgcReports

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.

Come creare un report in C#

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.

SalesReport.cs
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.

Program.cs
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.

Designer e visualizzatore di report per WinForms, WPF e Avalonia

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.

WinForms

Il pacchetto esegece.sgcReports.WinForms: il controllo di anteprima dei report, TsgcWinFormsReportDesigner (uno UserControl), il modale TsgcWinFormsReportDesignerForm e sgcReports_Designer_WinForms.sgcShowReportDesigner.

WPF

Il pacchetto esegece.sgcReports.Wpf: TsgcWpfReportPreview con navigazione tra le pagine, zoom, stampa e salvataggio in PDF, TsgcWpfReportDesigner (un DockPanel) e il modale TsgcWpfReportDesignerWindow.

Avalonia

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.

SalesForm.cs
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();
    }
}
DesignerWindow.cs
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();
    }
}

Bande, gruppi, master detail ed espressioni

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

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.

Gruppi e totali

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.

Master detail

Collega un'origine di dettaglio al suo master con MasterSource, MasterFields e DetailFields, come una fattura collega le proprie righe alla fattura.

Espressioni

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.

Tabelle e crosstab

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, script ed ereditarietà

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.

Esporta un report in PDF ed Excel in C#

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.

FormatoDettagli.NET Community (gratuita)
PDF/UAPDF/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/APDF/A-3 (rpaA3b, rpaA3a) per archivi e fatture elettroniche con l'XML della fattura incorporato, e PDF/A-4.✓
XLSX e CSVCartelle di lavoro Excel e file CSV dalle stesse pagine preparate.✓
PNG, SVG, ODS, HTML e testoUn'immagine per pagina, fogli di calcolo OpenDocument, HTML e testo semplice.✓
DOCX, ODT e RTFDocumenti Word, testo OpenDocument e Rich Text Format.−
PDF firmatoIl pacchetto ponte sgcSign firma le esportazioni PDF (PAdES).✓

Genera report in servizi, ASP.NET Core e su Linux

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.

ReportJob.cs
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);
        }
    }
}

Report via HTTP

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 engine per thread

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.

Installa lo strumento di reportistica .NET da NuGet

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.

Edizioni Community e Registered

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−✓

Community, gratuita

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.

esegece.sgcReports.Community su NuGet →

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 →

sgcReports .NET

€199

Licenze Single, Team e Site disponibili.

  • Engine, esportazioni e pacchetti WinForms, WPF e Avalonia
  • Pacchetti HTML e ASP.NET Core
  • Codice sorgente completo
  • 1 anno di aggiornamenti

Domande sulla reportistica .NET

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.

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

Aggiungi i report alla tua applicazione .NET

Costruisci report in C#, mostrali in WinForms, WPF e Avalonia, ed esporta PDF ed Excel con un solo pacchetto NuGet.