C# voor .NET NuGet Gratis Community-editie

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.

Fluent C#-builder en JSON-indelingen Ontwerper voor WinForms, WPF, Avalonia PDF/UA, PDF/A-3, XLSX en CSV Headless in services en op Linux

Bekijk de prijzen →   .NET-downloads en demo's →

Ploegenrapport gebouwd met sgcReports en getoond in het rapportvoorbeeld: een A4-pagina met vakken voor OEE, beschikbaarheid, prestaties en kwaliteit, een productiediagram per uur, staven voor stilstand per oorzaak en een batchbarcode

Rapporten gebouwd met sgcReports

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.

Een rapport maken in C#

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.

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

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.

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

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.

Rapportontwerper en viewer voor WinForms, WPF en Avalonia

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.

WinForms

Het package esegece.sgcReports.WinForms: het besturingselement voor het rapportvoorbeeld, TsgcWinFormsReportDesigner (een UserControl), het modale TsgcWinFormsReportDesignerForm en sgcReports_Designer_WinForms.sgcShowReportDesigner.

WPF

Het package esegece.sgcReports.Wpf: TsgcWpfReportPreview met paginanavigatie, zoomen, afdrukken en PDF opslaan, TsgcWpfReportDesigner (een DockPanel) en het modale TsgcWpfReportDesignerWindow.

Avalonia

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.

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

Banden, groepen, master-detail en expressies

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

Banden voor rapporttitel en samenvatting, paginakop en voettekst, kolomkop, groepskop en voettekst, masterdata en detaildata, elk met zijn eigen hoogte, stijl en items.

Groepen en totalen

Een groepskop begint een nieuwe groep telkens wanneer zijn expressie verandert, en een groepsvoettekst drukt subtotalen af met aggregatiefuncties zoals Sum en Count.

Master-detail

Koppel een detailbron aan zijn master met MasterSource, MasterFields en DetailFields, zoals een factuur zijn regels aan de factuur koppelt.

Expressies

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.

Tabellen en kruistabellen

Tabelitems met kop-, gegevens- en voettekstrijen, samengevoegde cellen en rijen die met hun tekst meegroeien, en kruistabellen met meerdere maten en totalen.

Parameters, scripts en overerving

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.

Een rapport exporteren naar PDF en Excel in C#

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.

FormaatDetails.NET Community (gratis)
PDF/UAStandaard getagde PDF/UA-1, met een leesvolgorde, alternatieve tekst voor afbeeldingen en gemarkeerde koppen. PDF/UA-2 op verzoek.✓
PDF/APDF/A-3 (rpaA3b, rpaA3a) voor archieven en e-facturen met de factuur-XML ingesloten, en PDF/A-4.✓
XLSX en CSVExcel-werkmappen en CSV-bestanden uit dezelfde voorbereide pagina's.✓
PNG, SVG, ODS, HTML en tekstEén afbeelding per pagina, OpenDocument-werkbladen, HTML en platte tekst.✓
DOCX, ODT en RTFWord-documenten, OpenDocument-tekst en Rich Text Format.−
Ondertekende PDFHet bridgepackage van sgcSign ondertekent de PDF-exports (PAdES).✓

Genereer rapporten in services, ASP.NET Core en op Linux

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.

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

Rapporten via HTTP

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.

Eén engine per thread

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.

Installeer de .NET-rapportagetool vanuit NuGet

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.

Community- en Registered-edities

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

Community, gratis

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.

esegece.sgcReports.Community op NuGet →

Registered

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 →

sgcReports .NET

€199

Single-, Team- en Site-licenties beschikbaar.

  • Engine, exports en de packages voor WinForms, WPF en Avalonia
  • Packages voor HTML en ASP.NET Core
  • Volledige broncode
  • 1 jaar updates

Vragen over .NET-rapportage

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.

De beste deal: All-AccessElk eSeGeCe-product, inclusief Premium-ondersteuning, vanaf €1,059 per jaar.
Bekijk de All-Access-prijzen

Voeg rapporten toe aan je .NET-toepassing

Bouw rapporten in C#, toon ze in WinForms, WPF en Avalonia, en exporteer PDF en Excel met één NuGet-package.