C# dla .NET NuGet Bezpłatna edycja Community

Narzędzie raportowe .NET dla C#

sgcReports to narzędzie raportowe .NET i generator raportów C#: buduj raporty w kodzie, pokazuj je w WinForms, WPF i Avalonia, eksportuj do PDF i Excela.

Płynny builder C# i układy JSON Projektant dla WinForms, WPF, Avalonia PDF/UA, PDF/A-3, XLSX i CSV Bez okna w usługach i w systemie Linux

Zobacz cennik →   Pliki do pobrania i dema .NET →

Raport zmianowy zbudowany z sgcReports i pokazany w podglądzie raportu: strona A4 z polami OEE, dostępności, wydajności i jakości, wykresem produkcji na godzinę, słupkami przestojów według przyczyny i kodem kreskowym partii

Raporty zbudowane z sgcReports

Listy zgrupowane, faktury, tabele i katalogi, przygotowane raz przez silnik raportów i pokazane w podglądzie lub zapisane do PDF, Excela, CSV i obrazów.

Jak utworzyć raport w C#

Dostarcz raportowi dane przez TsgcReportDataTableSource nad DataTable, opisz układ płynnym TsgcReportBuilder i zapisz go. Builder tworzy i posiada własny raport i silnik raportów. Każdy typ znajduje się w przestrzeni nazw esegece.sgcReports, z tymi samymi nazwami klas co w edycji 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;
    }
}

Wypełnij DataTable z bazy danych lub z własnych obiektów, przekaż go źródłu danych i zapisz raport. Wyjście PDF jest domyślnie tagowanym PDF/UA, a te same przygotowane strony trafiają do Excela i 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");
    }
}

Builder dodaje także nagłówki i stopki stron, nagłówki kolumn, pasma szczegółów, tabele, pola wyboru, kody kreskowe, parametry raportu i zakładki. Zobacz temat pomocy TsgcReportBuilder i przewodnik wprowadzający.

Projektant i przeglądarka raportów dla WinForms, WPF i Avalonia

Każdy pakiet UI ma podgląd raportu i gotowy projektant raportów dla użytkowników końcowych, więc Twoi użytkownicy mogą otwierać, zmieniać i zapisywać układy raportów w Twojej aplikacji. Projektanci mają pasek narzędzi, zakładki Design i Preview, drzewa Toolbox, Outline i Data, inspektor właściwości, liniały, cofanie i ponawianie oraz edytor skryptów. Trzy hosty współdzielą jeden model projektanta niezależny od platformy.

WinForms

Pakiet esegece.sgcReports.WinForms: kontrolka podglądu raportu, TsgcWinFormsReportDesigner (UserControl), modalny TsgcWinFormsReportDesignerForm i sgcReports_Designer_WinForms.sgcShowReportDesigner.

WPF

Pakiet esegece.sgcReports.Wpf: TsgcWpfReportPreview z nawigacją po stronach, powiększeniem, drukowaniem i zapisem do PDF, TsgcWpfReportDesigner (DockPanel) i modalne TsgcWpfReportDesignerWindow.

Avalonia

Pakiet esegece.sgcReports.Avalonia: TsgcAvaloniaReportPreview z nawigacją po stronach, powiększeniem i zapisem do PDF, TsgcAvaloniaReportDesigner i sgcShowReportDesignerAsync z asynchronicznymi selektorami plików.

Podglądy mają pasek wyszukiwania, miniatury stron, konspekt PDF, menu Export z jedenastoma formatami, przycisk Cancel podczas przygotowywania długiego raportu i monit o parametry raportu. Podglądy są w każdej edycji, klasy projektanta w edycji Registered. Projektanci importują też szablony ReportBuilder .rtm jako nowe raporty. Zobacz pomoc projektanta .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();
    }
}

Pasma, grupy, master detail i wyrażenia

sgcReports to pasmowy generator raportów C#: strony zawierają pasma, pasma zawierają elementy, a silnik drukuje każde pasmo w odpowiednim momencie dla Twoich danych.

Pasma

Tytuł i podsumowanie raportu, nagłówek i stopka strony, nagłówek kolumny, nagłówek i stopka grupy oraz pasma master data i detail data, każde z własną wysokością, stylem i elementami.

Grupy i sumy

Nagłówek grupy rozpoczyna nową grupę za każdym razem, gdy zmienia się jego wyrażenie, a stopka grupy drukuje sumy częściowe za pomocą funkcji agregujących, takich jak Sum i Count.

Master detail

Połącz źródło detail z jego master przez MasterSource, MasterFields i DetailFields, tak jak faktura łączy swoje pozycje z fakturą.

Wyrażenia

Pola i funkcje w nawiasach kwadratowych wewnątrz elementów tekstowych, takie jak [Sales.Customer] lub [FormatFloat('#,0.00', Sum(Sales.Amount))], oraz podświetlenia, które zmieniają styl elementu, gdy warunek jest spełniony.

Tabele i tabele krzyżowe

Elementy tabeli z wierszami nagłówka, danych i stopki, scalonymi komórkami i wierszami rosnącymi wraz z tekstem oraz tabele krzyżowe z kilkoma miarami i sumami.

Parametry, skrypty i dziedziczenie

Typowane parametry raportu z monitem, mały język skryptowy przechowywany w raporcie oraz raporty dziedziczące po układzie bazowym, takim jak papier firmowy.

Dane pochodzą z TsgcReportDataTableSource nad DataTable lub z TsgcReportJSONSource nad tablicą obiektów JSON. Tekst sformatowany, znaki wodne, kody kreskowe, pola wyboru i zakładki są w każdej edycji. Elementy wykresu, sparkline, wskaźnika i tabeli przestawnej pochodzą z pakietów mostkowych Registered sgcCharts, sgcGauges i sgcPivotGrid. Zobacz macierz funkcji sgcReports.

Eksportuj raport do PDF i Excela w C#

Silnik przygotowuje strony raz, a każdy eksport zapisuje je w swoim formacie. Wyjście PDF używa silnika sgcPDF, więc sgcPDF jest wymagany w każdej konfiguracji.

FormatSzczegóły.NET Community (bezpłatna)
PDF/UADomyślnie tagowany PDF/UA-1, z kolejnością czytania, tekstem alternatywnym dla obrazów i oznaczonymi nagłówkami. PDF/UA-2 na żądanie.✓
PDF/APDF/A-3 (rpaA3b, rpaA3a) dla archiwów i e-faktur z osadzonym XML faktury oraz PDF/A-4.✓
XLSX i CSVSkoroszyty Excela i pliki CSV z tych samych przygotowanych stron.✓
PNG, SVG, ODS, HTML i tekstJeden obraz na stronę, arkusze OpenDocument, HTML i zwykły tekst.✓
DOCX, ODT i RTFDokumenty Word, tekst OpenDocument i Rich Text Format.−
Podpisany PDFPakiet mostkowy sgcSign podpisuje eksporty PDF (PAdES).✓

Generuj raporty w usługach, ASP.NET Core i w systemie Linux

Silnik i eksporty nie wymagają UI, więc ten sam raport działa w usłudze Windows, web API lub demonie Linux. Wczytaj definicję raportu JSON zapisaną przez Twój kod lub przez projektanta, dołącz dane i zapisz plik.

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

Raporty przez HTTP

TsgcReportHTTPEndpoint udostępnia zarejestrowane raporty (RegisterReport) jako PDF, XLSX, CSV, HTML i inne pliki, a pakiety esegece.sgcReports.HTML i esegece.sgcReports.AspNetCore hostują jego trasy w ASP.NET Core.

Jeden silnik na wątek

Serwer przygotowuje równoległe raporty z jednym silnikiem i jednym zestawem źródeł danych na wątek. Dema .NET zawierają projekty LinuxDaemon i HTTPServer.

Zainstaluj narzędzie raportowe .NET z NuGet

esegece.sgcReports zawiera builder, źródła danych, silnik i eksporty. Dodaj pakiet swojego frameworka UI dla podglądu i projektanta oraz pakiety HTML i ASP.NET Core, aby udostępniać raporty w sieci.

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

Dla bezpłatnej edycji Community użyj tych samych identyfikatorów pakietów z sufiksem .Community, na przykład dotnet add package esegece.sgcReports.Community. Pełna lista pakietów jest na stronie pobierania sgcReports, a przegląd .NET wyjaśnia komponenty. Dema .NET to Invoice, Groups, JSONDefinition, PDFUA, Exports, Fluent, HTTPServer, LinuxDaemon, DatabaseSQL i MobileMAUI.

Edycje Community i Registered

Bezpłatne pakiety Community zawierają silnik, eksporty i podglądy. Edycja Registered dodaje projektantów dla użytkowników końcowych, eksporty DOCX, ODT i RTF oraz mosty do wykresów, wskaźników i tabel przestawnych.

Funkcja.NET Community (bezpłatna)Registered
Płynny builder, model raportu i definicje JSON✓✓
Pasma, grupy, master detail i wyrażenia✓✓
Eksport PDF/UA i PDF/A-3✓✓
Eksport XLSX, CSV, PNG, ODS, SVG, HTML i zwykłego tekstu✓✓
Podglądy WinForms, WPF i Avalonia✓✓
Silnik bez okna dla usług i Linuksa✓✓
Projektant raportów dla użytkowników końcowych dla WinForms, WPF i Avalonia−✓
Eksport DOCX, ODT i RTF−✓
Elementy wykresu, sparkline, wskaźnika i tabeli przestawnej−✓

Community, bezpłatnie

Pakiety .Community są bezpłatne dla osób prywatnych i organizacji z rocznym przychodem brutto poniżej 1 mln EUR i nie więcej niż 5 programistami. Organizacje osiągające którykolwiek z tych progów lub go przekraczające potrzebują licencji Registered.

esegece.sgcReports.Community na NuGet →

Registered

Każda funkcja i licencja komercyjna. Licencje Single, Team i Site, każda z pełnym kodem źródłowym, 1 rokiem aktualizacji i rabatem odnowienia od 50% do 70%.

Cennik sgcReports .NET →

sgcReports .NET

€199

Dostępne licencje Single, Team i Site.

  • Silnik, eksporty i pakiety WinForms, WPF i Avalonia
  • Pakiety HTML i ASP.NET Core
  • Pełny kod źródłowy
  • 1 rok aktualizacji

Pytania o raportowanie w .NET

Tak. sgcReports ma podgląd raportu i projektant raportów dla użytkowników końcowych dla WinForms (esegece.sgcReports.WinForms), WPF (esegece.sgcReports.Wpf) i Avalonia (esegece.sgcReports.Avalonia). Podglądy pokazują strony z nawigacją, powiększeniem, wyszukiwaniem, miniaturami i eksportem. Silnik i eksporty są w pakiecie rdzeniowym esegece.sgcReports i działają bez żadnego UI.

Dodaj pakiet NuGet esegece.sgcReports (lub esegece.sgcReports.Community), opakuj swój DataTable w TsgcReportDataTableSource, opisz strony, pasma i elementy płynnym TsgcReportBuilder i wywołaj SaveToPDF, SaveToXLSX lub SaveToCSV, jak w przykładzie tworzenia raportu. Możesz też wczytać układ z definicji raportu JSON.

Tak, z edycją Registered. TsgcWinFormsReportDesigner, TsgcWpfReportDesigner i TsgcAvaloniaReportDesigner to projektanci, które umieszczasz we własnym oknie, a sgcShowReportDesigner otwiera jednego jako okno modalne. Użytkownicy przeciągają elementy i pola na pasma, edytują właściwości, tabele i skrypty, oglądają podgląd wyniku i zapisują układ jako definicję JSON, którą Twój serwer może uruchomić bez okna.

Tak. SaveToPDF domyślnie zapisuje tagowany PDF/UA, PDFExport.PDFA przełącza na PDF/A-3, a SaveToXLSX zapisuje skoroszyt Excela z tych samych przygotowanych stron. CSV, PNG, SVG, ODS, HTML i zwykły tekst są w każdej edycji, a DOCX, ODT i RTF w edycji Registered.

Tak. Silnik bez okna i eksporty działają w systemach Windows i Linux, w usługach i demonach, a dema .NET zawierają projekt LinuxDaemon. W sieci pakiet esegece.sgcReports.AspNetCore integruje punkt końcowy raportów z ASP.NET Core, który udostępnia raporty jako PDF, XLSX, CSV, HTML i inne pliki.

Tak. Każdy pakiet NuGet sgcReports jest też dostępny jako bezpłatna edycja Community z sufiksem .Community, z silnikiem, eksportami i podglądami. Jest bezpłatna dla osób prywatnych i organizacji z rocznym przychodem brutto poniżej 1 mln EUR i nie więcej niż 5 programistami. Projektanci dla użytkowników końcowych oraz eksporty DOCX, ODT i RTF wymagają licencji Registered, zobacz cennik sgcReports.

Najkorzystniejsza oferta: All-AccessWszystkie produkty eSeGeCe, ze wsparciem Premium w cenie, już od €1,059 rocznie.
Zobacz cennik All-Access

Dodaj raporty do swojej aplikacji .NET

Buduj raporty w C#, pokazuj je w WinForms, WPF i Avalonia oraz eksportuj PDF i Excel jednym pakietem NuGet.