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.
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.
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.
Demo ReportTables w .NET WinForms: podgląd z nawigacją po stronach, powiększeniem, drukowaniem, PDF, wyszukiwaniem, miniaturami i eksportem oraz przyciskami projektanta i edytora tabel.
Zgrupowany raport z nagłówkiem dla każdej grupy, sumami częściowymi i numerami stron.
Faktura z danych master i detail, z jej pozycjami, sumami i kodem QR.
Definicja raportu JSON i strona, którą renderuje. Zmień układ bez rekompilacji aplikacji.
Jeden przygotowany raport, zapisany do PDF, skoroszytu Excela, pliku CSV i jednego PNG na stronę.
Edytor tabel projektanta raportów: wiersze nagłówka, danych i stopki, scalone komórki, style i podświetlenia.
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.
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.
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.
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.
Pakiet esegece.sgcReports.WinForms: kontrolka podglądu raportu, TsgcWinFormsReportDesigner (UserControl), modalny TsgcWinFormsReportDesignerForm i sgcReports_Designer_WinForms.sgcShowReportDesigner.
Pakiet esegece.sgcReports.Wpf: TsgcWpfReportPreview z nawigacją po stronach, powiększeniem, drukowaniem i zapisem do PDF, TsgcWpfReportDesigner (DockPanel) i modalne TsgcWpfReportDesignerWindow.
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.
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 to pasmowy generator raportów C#: strony zawierają pasma, pasma zawierają elementy, a silnik drukuje każde pasmo w odpowiednim momencie dla Twoich danych.
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.
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.
Połącz źródło detail z jego master przez MasterSource, MasterFields i DetailFields, tak jak faktura łączy swoje pozycje z fakturą.
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.
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.
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.
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.
| Format | Szczegóły | .NET Community (bezpłatna) |
|---|---|---|
| PDF/UA | Domyślnie tagowany PDF/UA-1, z kolejnością czytania, tekstem alternatywnym dla obrazów i oznaczonymi nagłówkami. PDF/UA-2 na żądanie. | ✓ |
| PDF/A | PDF/A-3 (rpaA3b, rpaA3a) dla archiwów i e-faktur z osadzonym XML faktury oraz PDF/A-4. | ✓ |
| XLSX i CSV | Skoroszyty Excela i pliki CSV z tych samych przygotowanych stron. | ✓ |
| PNG, SVG, ODS, HTML i tekst | Jeden obraz na stronę, arkusze OpenDocument, HTML i zwykły tekst. | ✓ |
| DOCX, ODT i RTF | Dokumenty Word, tekst OpenDocument i Rich Text Format. | − |
| Podpisany PDF | Pakiet mostkowy sgcSign podpisuje eksporty PDF (PAdES). | ✓ |
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.
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 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.
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.
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.
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 | − | ✓ |
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.
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 →€199
Dostępne licencje Single, Team i Site.
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.