.NET için C# NuGet Ücretsiz Community sürümü

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.

Akıcı C# oluşturucu ve JSON düzenleri WinForms, WPF, Avalonia için tasarımcı PDF/UA, PDF/A-3, XLSX ve CSV Servislerde ve Linux'ta başsız

Fiyatlandırmaya bakın →   .NET indirmeleri ve demolar →

sgcReports ile hazırlanan ve rapor önizlemesinde gösterilen vardiya raporu: OEE, kullanılabilirlik, performans ve kalite kutuları, saate göre üretim grafiği, nedene göre duruş süresi çubukları ve bir parti barkodu içeren A4 sayfa

sgcReports ile Oluşturulan Raporlar

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.

C#'ta Rapor Nasıl Oluşturulur

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.

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

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.

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

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.

WinForms, WPF ve Avalonia için Rapor Tasarımcısı ve Görüntüleyici

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.

WinForms

esegece.sgcReports.WinForms paketi: rapor önizleme denetimi, TsgcWinFormsReportDesigner (bir UserControl), kipli TsgcWinFormsReportDesignerForm ve sgcReports_Designer_WinForms.sgcShowReportDesigner.

WPF

esegece.sgcReports.Wpf paketi: sayfa gezintisi, yakınlaştırma, yazdırma ve PDF kaydetme içeren TsgcWpfReportPreview, TsgcWpfReportDesigner (bir DockPanel) ve kipli TsgcWpfReportDesignerWindow.

Avalonia

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.

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

Bantlar, Gruplar, Ana Ayrıntı ve İfadeler

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.

Bantlar

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.

Gruplar ve toplamlar

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.

Ana ayrıntı

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.

İfadeler

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.

Tablolar ve çapraz tablolar

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.

Parametreler, betikler ve kalıtım

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.

C#'ta Bir Raporu PDF ve Excel'e Aktarı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çimAyrıntılar.NET Community (ücretsiz)
PDF/UAVarsayı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/AArşivler ve fatura XML'i gömülü e-faturalar için PDF/A-3 (rpaA3b, rpaA3a) ve PDF/A-4.✓
XLSX ve CSVAynı hazırlanmış sayfalardan Excel çalışma kitapları ve CSV dosyaları.✓
PNG, SVG, ODS, HTML ve metinSayfa başına bir görüntü, OpenDocument elektronik tabloları, HTML ve düz metin.✓
DOCX, ODT ve RTFWord belgeleri, OpenDocument metni ve Rich Text Format.−
İmzalı PDFsgcSign köprü paketi PDF dışa aktarmalarını imzalar (PAdES).✓

Raporları Servislerde, ASP.NET Core'da ve Linux'ta Oluşturun

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.

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

HTTP üzerinden raporlar

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.

İş parçacığı başına bir motor

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.

.NET Raporlama Aracını NuGet'ten Kurun

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.

Community ve Registered Sürümleri

Ü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, ücretsiz

.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.

NuGet'te esegece.sgcReports.Community →

Registered

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ı →

sgcReports .NET

€199

Single, Team ve Site lisansları mevcuttur.

  • Motor, dışa aktarmalar ve WinForms, WPF ve Avalonia paketleri
  • HTML ve ASP.NET Core paketleri
  • Tam kaynak kodu
  • 1 yıl güncelleme

.NET Raporlama Soruları

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ı.

En avantajlı seçenek: All-AccessTüm eSeGeCe ürünleri, Premium Destek dahil, yılda €1,059'dan itibaren.
All-Access fiyatlarına bakın

.NET Uygulamanıza Raporlama Ekleyin

Tek bir NuGet paketiyle raporları C#'ta oluşturun, WinForms, WPF ve Avalonia'da gösterin, PDF ve Excel'e aktarın.