C# für .NET NuGet Kostenlose Community-Edition

Das .NET-Reporting-Tool für C#

sgcReports ist ein .NET-Reporting-Tool und C#-Berichtsgenerator: Berichte im Code bauen, in WinForms, WPF und Avalonia anzeigen, PDF und Excel exportieren.

Fluent-C#-Builder und JSON-Layouts Designer für WinForms, WPF, Avalonia PDF/UA, PDF/A-3, XLSX und CSV Headless in Diensten und unter Linux

Preise ansehen →   .NET-Downloads und Demos →

Mit sgcReports erstellter Schichtbericht in der Berichtsvorschau: eine A4-Seite mit Boxen für OEE, Verfügbarkeit, Leistung und Qualität, einem Diagramm zur Produktion pro Stunde, Balken für Stillstände nach Ursache und einem Chargen-Barcode

Mit sgcReports erstellte Berichte

Gruppierte Listen, Rechnungen, Tabellen und Kataloge, einmal von der Berichts-Engine aufbereitet und in einer Vorschau angezeigt oder als PDF, Excel, CSV und Bilder geschrieben.

So erstellst du einen Bericht in C#

Gib dem Bericht seine Daten mit einer TsgcReportDataTableSource über einer DataTable, beschreibe das Layout mit dem Fluent-TsgcReportBuilder und speichere es. Der Builder erstellt seinen eigenen Bericht und seine eigene Berichts-Engine und besitzt sie. Jeder Typ liegt im Namespace esegece.sgcReports, mit denselben Klassennamen wie in der Delphi-Edition.

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

Fülle eine DataTable aus deiner Datenbank oder deinen Objekten, übergib sie der Datenquelle und speichere den Bericht. Die PDF-Ausgabe ist standardmäßig getaggtes PDF/UA, und dieselben aufbereiteten Seiten gehen auch nach Excel und 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");
    }
}

Der Builder fügt außerdem Seitenköpfe und -füße, Spaltenköpfe, Detailbänder, Tabellen, Kontrollkästchen, Barcodes, Berichtsparameter und Lesezeichen hinzu. Siehe das Hilfethema zu TsgcReportBuilder und die Anleitung für den Einstieg.

Berichtsdesigner und Viewer für WinForms, WPF und Avalonia

Jedes UI-Paket hat eine Berichtsvorschau und einen fertigen Endbenutzer-Berichtsdesigner, sodass deine Benutzer Berichtslayouts in deiner Anwendung öffnen, ändern und speichern können. Die Designer haben eine Symbolleiste, die Register Design und Preview, die Bäume Toolbox, Outline und Data, einen Eigenschaftsinspektor, Lineale, Rückgängig und Wiederholen sowie einen Skripteditor. Die drei Hosts teilen sich ein plattformneutrales Designermodell.

WinForms

Das Paket esegece.sgcReports.WinForms: das Control für die Berichtsvorschau, TsgcWinFormsReportDesigner (ein UserControl), das modale TsgcWinFormsReportDesignerForm und sgcReports_Designer_WinForms.sgcShowReportDesigner.

WPF

Das Paket esegece.sgcReports.Wpf: TsgcWpfReportPreview mit Seitennavigation, Zoom, Druck und PDF-Speicherung, TsgcWpfReportDesigner (ein DockPanel) und das modale TsgcWpfReportDesignerWindow.

Avalonia

Das Paket esegece.sgcReports.Avalonia: TsgcAvaloniaReportPreview mit Seitennavigation, Zoom und PDF-Speicherung, TsgcAvaloniaReportDesigner und sgcShowReportDesignerAsync mit asynchronen Dateiauswahldialogen.

Die Vorschauen haben eine Suchleiste, Seitenminiaturen, die PDF-Gliederung, ein Export-Menü mit elf Formaten, eine Schaltfläche Abbrechen, während ein langer Bericht aufbereitet wird, und eine Abfrage der Berichtsparameter. Die Vorschauen sind in jeder Edition enthalten, die Designer-Klassen in der Registered-Edition. Die Designer importieren außerdem ReportBuilder-.rtm-Vorlagen als neue Berichte. Siehe die Hilfe zu den .NET-Designern.

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

Bänder, Gruppen, Master-Detail und Ausdrücke

sgcReports ist ein bandbasierter C#-Berichtsgenerator: Seiten enthalten Bänder, Bänder enthalten Elemente, und die Engine druckt jedes Band zum richtigen Zeitpunkt für deine Daten.

Bänder

Berichtstitel und Zusammenfassung, Seitenkopf und -fuß, Spaltenkopf, Gruppenkopf und -fuß, Master-Daten- und Detaildatenbänder, jeweils mit eigener Höhe, eigenem Stil und eigenen Elementen.

Gruppen und Summen

Ein Gruppenkopf beginnt jedes Mal eine neue Gruppe, wenn sich sein Ausdruck ändert, und ein Gruppenfuß druckt Zwischensummen mit Aggregatfunktionen wie Sum und Count.

Master-Detail

Verknüpfe eine Detailquelle mit MasterSource, MasterFields und DetailFields mit ihrem Master, so wie eine Rechnung ihre Zeilen mit der Rechnung verknüpft.

Ausdrücke

Felder und Funktionen in eckigen Klammern in Textelementen, etwa [Sales.Customer] oder [FormatFloat('#,0.00', Sum(Sales.Amount))], sowie Highlights, die den Stil eines Elements ändern, wenn eine Bedingung zutrifft.

Tabellen und Kreuztabellen

Tabellenelemente mit Kopf-, Daten- und Fußzeilen, verbundenen Zellen und Zeilen, die mit ihrem Text wachsen, sowie Kreuztabellen mit mehreren Kennzahlen und Summen.

Parameter, Skripte und Vererbung

Typisierte Berichtsparameter mit Abfrage, eine kleine im Bericht gespeicherte Skriptsprache und Berichte, die von einem Basislayout wie einem Briefkopf erben.

Die Daten kommen aus einer TsgcReportDataTableSource über einer DataTable oder aus einer TsgcReportJSONSource über einem JSON-Array von Objekten. Rich Text, Wasserzeichen, Barcodes, Kontrollkästchen und Lesezeichen sind in jeder Edition enthalten. Elemente für Diagramme, Sparklines, Gauges und Pivot-Tabellen kommen mit den Registered-Brückenpaketen sgcCharts, sgcGauges und sgcPivotGrid. Siehe die sgcReports-Funktionsmatrix.

Einen Bericht in C# nach PDF und Excel exportieren

Die Engine bereitet die Seiten einmal auf, und jeder Export schreibt sie in seinem eigenen Format. Die PDF-Ausgabe nutzt die sgcPDF-Engine, daher ist sgcPDF in jeder Konfiguration erforderlich.

FormatDetails.NET Community (kostenlos)
PDF/UAStandardmäßig getaggtes PDF/UA-1, mit Lesereihenfolge, Alternativtext für Bilder und markierten Überschriften. PDF/UA-2 auf Wunsch.✓
PDF/APDF/A-3 (rpaA3b, rpaA3a) für Archive und E-Rechnungen mit eingebettetem Rechnungs-XML sowie PDF/A-4.✓
XLSX und CSVExcel-Arbeitsmappen und CSV-Dateien aus denselben aufbereiteten Seiten.✓
PNG, SVG, ODS, HTML und TextEin Bild pro Seite, OpenDocument-Tabellen, HTML und Klartext.✓
DOCX, ODT und RTFWord-Dokumente, OpenDocument-Text und Rich Text Format.−
Signiertes PDFDas sgcSign-Brückenpaket signiert die PDF-Exporte (PAdES).✓

Berichte in Diensten, ASP.NET Core und unter Linux erzeugen

Die Engine und die Exports brauchen keine Benutzeroberfläche, sodass derselbe Bericht in einem Windows-Dienst, einer Web-API oder einem Linux-Daemon läuft. Lade eine JSON-Berichtsdefinition, die dein Code oder der Designer gespeichert hat, hänge die Daten an und schreibe die Datei.

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

Berichte über HTTP

TsgcReportHTTPEndpoint liefert registrierte Berichte (RegisterReport) als PDF, XLSX, CSV, HTML und andere Dateien aus, und die Pakete esegece.sgcReports.HTML und esegece.sgcReports.AspNetCore hosten seine Routen in ASP.NET Core.

Eine Engine pro Thread

Ein Server bereitet gleichzeitige Berichte mit einer Engine und einem Satz Datenquellen pro Thread auf. Die .NET-Demos enthalten ein LinuxDaemon- und ein HTTPServer-Projekt.

Das .NET-Reporting-Tool über NuGet installieren

esegece.sgcReports enthält den Builder, die Datenquellen, die Engine und die Exports. Füge das Paket deines UI-Frameworks für Vorschau und Designer hinzu sowie die Pakete HTML und ASP.NET Core, um Berichte im Web auszuliefern.

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

Für die kostenlose Community-Edition verwendest du dieselben Paket-IDs mit dem Suffix .Community, zum Beispiel dotnet add package esegece.sgcReports.Community. Die vollständige Paketliste steht auf der sgcReports-Downloadseite, und die .NET-Übersicht erklärt die Komponenten. Die .NET-Demos sind Invoice, Groups, JSONDefinition, PDFUA, Exports, Fluent, HTTPServer, LinuxDaemon, DatabaseSQL und MobileMAUI.

Community- und Registered-Edition

Die kostenlosen Community-Pakete enthalten die Engine, die Exports und die Vorschauen. Die Registered-Edition ergänzt die Endbenutzer-Designer, die Exports nach DOCX, ODT und RTF sowie die Brücken für Diagramme, Gauges und Pivot-Tabellen.

Funktion.NET Community (kostenlos)Registered
Fluent-Builder, Berichtsmodell und JSON-Definitionen✓✓
Bänder, Gruppen, Master-Detail und Ausdrücke✓✓
PDF/UA- und PDF/A-3-Export✓✓
Export nach XLSX, CSV, PNG, ODS, SVG, HTML und Klartext✓✓
Vorschauen für WinForms, WPF und Avalonia✓✓
Headless-Engine für Dienste und Linux✓✓
Endbenutzer-Berichtsdesigner für WinForms, WPF und Avalonia−✓
Export nach DOCX, ODT und RTF−✓
Elemente für Diagramme, Sparklines, Gauges und Pivot-Tabellen−✓

Community, kostenlos

Die .Community-Pakete sind kostenlos für Einzelpersonen und Organisationen mit weniger als 1 Mio. EUR Jahresumsatz und höchstens 5 Entwicklern. Organisationen, die eine dieser Schwellen erreichen oder überschreiten, brauchen eine Registered-Lizenz.

esegece.sgcReports.Community auf NuGet →

Registered

Jede Funktion und die kommerzielle Lizenz. Single-, Team- und Site-Lizenzen, jeweils mit vollständigem Quellcode, 1 Jahr Updates und einem Verlängerungsrabatt von 50 % bis 70 %.

sgcReports-.NET-Preise →

sgcReports .NET

€199

Single-, Team- und Site-Lizenzen verfügbar.

  • Engine, Exports und die Pakete für WinForms, WPF und Avalonia
  • Pakete für HTML und ASP.NET Core
  • Vollständiger Quellcode
  • 1 Jahr Updates

Fragen zum .NET-Reporting

Ja. sgcReports hat eine Berichtsvorschau und einen Endbenutzer-Berichtsdesigner für WinForms (esegece.sgcReports.WinForms), WPF (esegece.sgcReports.Wpf) und Avalonia (esegece.sgcReports.Avalonia). Die Vorschauen zeigen die Seiten mit Navigation, Zoom, Suche, Miniaturen und Export. Die Engine und die Exports stecken im Kernpaket esegece.sgcReports und funktionieren ohne jede Benutzeroberfläche.

Füge das NuGet-Paket esegece.sgcReports (oder esegece.sgcReports.Community) hinzu, verpacke deine DataTable in eine TsgcReportDataTableSource, beschreibe Seiten, Bänder und Elemente mit dem Fluent-TsgcReportBuilder und rufe SaveToPDF, SaveToXLSX oder SaveToCSV auf, wie im Beispiel zum Erstellen eines Berichts. Du kannst das Layout auch aus einer JSON-Berichtsdefinition laden.

Ja, mit der Registered-Edition. TsgcWinFormsReportDesigner, TsgcWpfReportDesigner und TsgcAvaloniaReportDesigner sind Designer, die du in dein eigenes Fenster setzt, und sgcShowReportDesigner öffnet einen als modales Fenster. Benutzer ziehen Elemente und Felder auf Bänder, bearbeiten Eigenschaften, Tabellen und Skripte, sehen das Ergebnis in der Vorschau und speichern das Layout als JSON-Definition, die dein Server headless ausführen kann.

Ja. SaveToPDF schreibt standardmäßig getaggtes PDF/UA, PDFExport.PDFA wechselt zu PDF/A-3, und SaveToXLSX schreibt eine Excel-Arbeitsmappe aus denselben aufbereiteten Seiten. CSV, PNG, SVG, ODS, HTML und Klartext sind in jeder Edition enthalten, DOCX, ODT und RTF in der Registered-Edition.

Ja. Die Headless-Engine und die Exports laufen unter Windows und unter Linux, in Diensten und Daemons, und die .NET-Demos enthalten ein LinuxDaemon-Projekt. Für das Web integriert das Paket esegece.sgcReports.AspNetCore den Berichtsendpunkt in ASP.NET Core, der Berichte als PDF, XLSX, CSV, HTML und andere Dateien ausliefert.

Ja. Jedes sgcReports-NuGet-Paket gibt es auch als kostenlose Community-Edition mit dem Suffix .Community, mit der Engine, den Exports und den Vorschauen. Sie ist kostenlos für Einzelpersonen und Organisationen mit weniger als 1 Mio. EUR Jahresumsatz und höchstens 5 Entwicklern. Die Endbenutzer-Designer und die Exports nach DOCX, ODT und RTF brauchen eine Registered-Lizenz, siehe sgcReports-Preise.

Bestes Preis-Leistungs-Verhältnis: All-AccessAlle eSeGeCe-Produkte, inklusive Premium-Support, ab €1,059 pro Jahr.
All-Access-Preise ansehen

Füge deiner .NET-Anwendung Berichte hinzu

Baue Berichte in C#, zeige sie in WinForms, WPF und Avalonia an und exportiere PDF und Excel mit einem NuGet-Paket.