C# için .NET Raporlama Aracı
sgcReports bir .NET raporlama aracı ve C# rapor oluşturucusudur: raporları kodla oluşturun, WinForms, WPF ve Avalonia'da gösterin, PDF ve Excel'e aktarın.
sgcReports bir .NET raporlama aracı ve C# rapor oluşturucusudur: raporları kodla oluşturun, WinForms, WPF ve Avalonia'da gösterin, PDF ve Excel'e aktarın.
Rapor motoru tarafından bir kez hazırlanan ve bir önizlemede gösterilen ya da PDF, Excel, CSV ve görüntülere yazılan gruplanmış listeler, faturalar, tablolar ve kataloglar.
.NET WinForms'ta ReportTables demosu: sayfa gezintisi, yakınlaştırma, yazdırma, PDF, arama, küçük resimler ve dışa aktarma içeren önizleme, ayrıca tasarımcı ve tablo düzenleyici için düğmeler.
Grup başına bir başlık, ara toplamlar ve sayfa numaraları içeren gruplanmış bir rapor.
Ana ve ayrıntı verilerinden bir fatura, satırları, toplamları ve bir QR koduyla.
Bir JSON rapor tanımı ve oluşturduğu sayfa. Uygulamanızı yeniden derlemeden bir düzeni değiştirin.
PDF, bir Excel çalışma kitabı, bir CSV dosyası ve sayfa başına bir PNG olarak yazılan bir hazırlanmış rapor.
Rapor tasarımcısının tablo düzenleyicisi: başlık, veri ve altbilgi satırları, birleştirilmiş hücreler, stiller ve vurgular.
Rapora verisini bir DataTable üzerinde bir TsgcReportDataTableSource ile verin, düzeni akıcı TsgcReportBuilder ile tanımlayın ve kaydedin. Oluşturucu kendi raporunu ve rapor motorunu oluşturur ve sahiplenir. Her tür, Delphi sürümüyle aynı sınıf adlarıyla esegece.sgcReports ad alanındadır.
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;
}
}
Veritabanınızdan ya da nesnelerinizden bir DataTable doldurun, veri kaynağına verin ve raporu kaydedin. PDF çıktısı varsayılan olarak etiketli PDF/UA'dır ve aynı hazırlanmış sayfalar Excel ve CSV'ye gider.
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");
}
}
Oluşturucu ayrıca sayfa üst bilgileri ve altbilgileri, sütun başlıkları, ayrıntı bantları, tablolar, onay kutuları, barkodlar, rapor parametreleri ve yer imleri ekler. TsgcReportBuilder yardım konusuna ve başlangıç kılavuzuna bakın.
Her kullanıcı arayüzü paketinde bir rapor önizlemesi ve hazır bir son kullanıcı rapor tasarımcısı bulunur, böylece kullanıcılarınız uygulamanızın içinde rapor düzenlerini açabilir, değiştirebilir ve kaydedebilir. Tasarımcılarda bir araç çubuğu, Design ve Preview sekmeleri, Toolbox, Outline ve Data ağaçları, bir özellik denetçisi, cetveller, geri alma ve yineleme ve bir betik düzenleyici vardır. Üç ana makine, platformdan bağımsız tek bir tasarımcı modelini paylaşır.
esegece.sgcReports.WinForms paketi: rapor önizleme denetimi, TsgcWinFormsReportDesigner (bir UserControl), kipli TsgcWinFormsReportDesignerForm ve sgcReports_Designer_WinForms.sgcShowReportDesigner.
esegece.sgcReports.Wpf paketi: sayfa gezintisi, yakınlaştırma, yazdırma ve PDF kaydetme içeren TsgcWpfReportPreview, TsgcWpfReportDesigner (bir DockPanel) ve kipli TsgcWpfReportDesignerWindow.
esegece.sgcReports.Avalonia paketi: sayfa gezintisi, yakınlaştırma ve PDF kaydetme içeren TsgcAvaloniaReportPreview, TsgcAvaloniaReportDesigner ve zaman uyumsuz dosya seçicili sgcShowReportDesignerAsync.
Önizlemelerde bir arama çubuğu, sayfa küçük resimleri, PDF ana hattı, on bir biçimli bir Export menüsü, uzun bir rapor hazırlanırken bir Cancel düğmesi ve rapor parametreleri için bir istem bulunur. Önizlemeler her sürümde, tasarımcı sınıfları Registered sürümündedir. Tasarımcılar ayrıca ReportBuilder .rtm şablonlarını yeni raporlar olarak içe aktarır. .NET tasarımcı yardımına bakın.
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 bantlı bir C# rapor oluşturucusudur: sayfalar bantları, bantlar öğeleri tutar ve motor her bandı verileriniz için doğru zamanda yazdırır.
Rapor başlığı ve özeti, sayfa üst bilgisi ve altbilgisi, sütun başlığı, grup başlığı ve altbilgisi, ana veri ve ayrıntı veri bantları; her birinin kendi yüksekliği, stili ve öğeleri vardır.
Bir grup başlığı, ifadesi her değiştiğinde yeni bir grup başlatır ve bir grup altbilgisi Sum ve Count gibi toplama işlevleriyle ara toplamları yazdırır.
Bir faturanın satırlarını faturaya bağlaması gibi, bir ayrıntı kaynağını ana kaynağına MasterSource, MasterFields ve DetailFields ile bağlayın.
Metin öğelerinin içinde köşeli parantez içinde alanlar ve işlevler, örneğin [Sales.Customer] ya da [FormatFloat('#,0.00', Sum(Sales.Amount))], ayrıca bir koşul doğru olduğunda bir öğenin stilini değiştiren vurgular.
Başlık, veri ve altbilgi satırları, birleştirilmiş hücreler ve metniyle büyüyen satırlar içeren tablo öğeleri, ayrıca birkaç ölçü ve toplam içeren çapraz tablolar.
Bir istemle türlendirilmiş rapor parametreleri, raporda saklanan küçük bir betik dili ve antetli kâğıt gibi bir temel düzenden türeyen raporlar.
Veri, bir DataTable üzerinde bir TsgcReportDataTableSource kaynağından ya da bir JSON nesne dizisi üzerinde bir TsgcReportJSONSource kaynağından gelir. Zengin metin, filigranlar, barkodlar, onay kutuları ve yer imleri her sürümdedir. Grafik, sparkline, gösterge ve pivot tablo öğeleri Registered sgcCharts, sgcGauges ve sgcPivotGrid köprü paketleriyle gelir. sgcReports özellik matrisine bakın.
Motor sayfaları bir kez hazırlar ve her dışa aktarma bunları kendi biçiminde yazar. PDF çıktısı sgcPDF motorunu kullanır, bu nedenle sgcPDF her yapılandırmada gereklidir.
| Biçim | Ayrıntılar | .NET Community (ücretsiz) |
|---|---|---|
| PDF/UA | Varsayılan olarak etiketli PDF/UA-1, okuma sırası, görüntüler için alternatif metin ve işaretlenmiş başlıklarla. İstenirse PDF/UA-2. | ✓ |
| PDF/A | Arşivler ve fatura XML'i gömülü e-faturalar için PDF/A-3 (rpaA3b, rpaA3a) ve PDF/A-4. | ✓ |
| XLSX ve CSV | Aynı hazırlanmış sayfalardan Excel çalışma kitapları ve CSV dosyaları. | ✓ |
| PNG, SVG, ODS, HTML ve metin | Sayfa başına bir görüntü, OpenDocument elektronik tabloları, HTML ve düz metin. | ✓ |
| DOCX, ODT ve RTF | Word belgeleri, OpenDocument metni ve Rich Text Format. | − |
| İmzalı PDF | sgcSign köprü paketi PDF dışa aktarmalarını imzalar (PAdES). | ✓ |
Motor ve dışa aktarmalar kullanıcı arayüzü gerektirmez, bu nedenle aynı rapor bir Windows servisinde, bir web API'sinde ya da bir Linux daemon'unda çalışır. Kodunuzun ya da tasarımcının kaydettiği bir JSON rapor tanımını yükleyin, veriyi ekleyin ve dosyayı yazın.
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 kayıtlı raporları (RegisterReport) PDF, XLSX, CSV, HTML ve diğer dosyalar olarak sunar, esegece.sgcReports.HTML ve esegece.sgcReports.AspNetCore paketleri ise yollarını ASP.NET Core'da barındırır.
Bir sunucu eşzamanlı raporları iş parçacığı başına bir motor ve bir veri kaynağı kümesiyle hazırlar. .NET demoları bir LinuxDaemon ve bir HTTPServer projesi içerir.
esegece.sgcReports oluşturucuyu, veri kaynaklarını, motoru ve dışa aktarmaları içerir. Önizleme ve tasarımcı için kullanıcı arayüzü çerçevenizin paketini, raporları web'de sunmak için ise HTML ve ASP.NET Core paketlerini ekleyin.
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
Ücretsiz Community sürümü için aynı paket kimliklerini .Community sonekiyle kullanın, örneğin dotnet add package esegece.sgcReports.Community. Paketlerin tam listesi sgcReports indirme sayfasındadır, bileşenleri ise .NET genel bakışı açıklar. .NET demoları Invoice, Groups, JSONDefinition, PDFUA, Exports, Fluent, HTTPServer, LinuxDaemon, DatabaseSQL ve MobileMAUI'dir.
Ücretsiz Community paketleri motoru, dışa aktarmaları ve önizlemeleri içerir. Registered sürümü son kullanıcı tasarımcılarını, DOCX, ODT ve RTF dışa aktarmalarını ve grafik, gösterge ve pivot tablo köprülerini ekler.
| Özellik | .NET Community (ücretsiz) | Registered |
|---|---|---|
| Akıcı oluşturucu, rapor modeli ve JSON tanımları | ✓ | ✓ |
| Bantlar, gruplar, ana ayrıntı ve ifadeler | ✓ | ✓ |
| PDF/UA ve PDF/A-3 dışa aktarma | ✓ | ✓ |
| XLSX, CSV, PNG, ODS, SVG, HTML ve düz metin dışa aktarma | ✓ | ✓ |
| WinForms, WPF ve Avalonia önizlemeleri | ✓ | ✓ |
| Servisler ve Linux için başsız motor | ✓ | ✓ |
| WinForms, WPF ve Avalonia için son kullanıcı rapor tasarımcısı | − | ✓ |
| DOCX, ODT ve RTF dışa aktarma | − | ✓ |
| Grafik, sparkline, gösterge ve pivot tablo öğeleri | − | ✓ |
.Community paketleri, yıllık brüt geliri 1 milyon EUR'nun altında olan ve en fazla 5 geliştiricisi bulunan bireyler ve kuruluşlar için ücretsizdir. Eşiklerden herhangi birine ulaşan ya da onu aşan kuruluşlar için Registered lisansı gerekir.
Her özellik ve ticari lisans. Her biri tam kaynak kodu, 1 yıl güncelleme ve 50% ile 70% arasında yenileme indirimiyle Single, Team ve Site lisansları.
sgcReports .NET fiyatlandırması →€199
Single, Team ve Site lisansları mevcuttur.
Evet. sgcReports'un WinForms (esegece.sgcReports.WinForms), WPF (esegece.sgcReports.Wpf) ve Avalonia (esegece.sgcReports.Avalonia) için bir rapor önizlemesi ve son kullanıcı rapor tasarımcısı vardır. Önizlemeler sayfaları gezinme, yakınlaştırma, arama, küçük resimler ve dışa aktarmayla gösterir. Motor ve dışa aktarmalar çekirdek esegece.sgcReports paketindedir ve herhangi bir kullanıcı arayüzü olmadan çalışır.
esegece.sgcReports NuGet paketini (ya da esegece.sgcReports.Community) ekleyin, DataTable nesnenizi bir TsgcReportDataTableSource içine sarın, sayfaları, bantları ve öğeleri akıcı TsgcReportBuilder ile tanımlayın ve rapor oluşturma örneğindeki gibi SaveToPDF, SaveToXLSX ya da SaveToCSV çağırın. Düzeni bir JSON rapor tanımından da yükleyebilirsiniz.
Evet, Registered sürümüyle. TsgcWinFormsReportDesigner, TsgcWpfReportDesigner ve TsgcAvaloniaReportDesigner kendi pencerenize yerleştirdiğiniz tasarımcılardır ve sgcShowReportDesigner birini kipli pencere olarak açar. Kullanıcılar öğeleri ve alanları bantların üzerine sürükler, özellikleri, tabloları ve betikleri düzenler, sonucu önizler ve düzeni sunucunuzun başsız çalıştırabileceği bir JSON tanımı olarak kaydeder.
Evet. SaveToPDF varsayılan olarak etiketli PDF/UA yazar, PDFExport.PDFA PDF/A-3'e geçer ve SaveToXLSX aynı hazırlanmış sayfalardan bir Excel çalışma kitabı yazar. CSV, PNG, SVG, ODS, HTML ve düz metin her sürümde, DOCX, ODT ve RTF ise Registered sürümündedir.
Evet. Başsız motor ve dışa aktarmalar Windows'ta ve Linux'ta, servislerde ve daemon'larda çalışır ve .NET demoları bir LinuxDaemon projesi içerir. Web için esegece.sgcReports.AspNetCore paketi, raporları PDF, XLSX, CSV, HTML ve diğer dosyalar olarak sunan rapor uç noktasını ASP.NET Core ile bütünleştirir.
Evet. Her sgcReports NuGet paketi, motor, dışa aktarmalar ve önizlemelerle birlikte .Community soneki taşıyan ücretsiz bir Community sürümü olarak da sunulur. Yıllık brüt geliri 1 milyon EUR'nun altında olan ve en fazla 5 geliştiricisi bulunan bireyler ve kuruluşlar için ücretsizdir. Son kullanıcı tasarımcıları ve DOCX, ODT ve RTF dışa aktarmaları Registered lisansı gerektirir, bkz. sgcReports fiyatlandırması.