Erstellen eines PDF-Berichts in JetBrains Rider (C#) unter Ubuntu 22.04.1 LTS

In diesem Artikel werfen wir einen Blick auf die Welt der .NET-Plattform in Ubuntu 22.04.1 LTS, ohne Microsoft Visual Studio zu verwenden, da sie unter Linux nicht installiert werden kann, und erstellen einen Bericht, der ins PDF-Format exportiert werden kann. Das aktuelle Vergleichsprodukt von Visual Studio ist natürlich JetBrains Rider. Es ist eine von JetBrains entwickelte plattformübergreifende integrierte Softwareentwicklungsumgebung für die .NET-Plattform. Sie unterstützt die Programmiersprachen C#, VB.NET und F#.

Wir werden hier nicht diskutieren, welche IDE besser oder schlechter ist. Lassen Sie uns also einfach einen PDF-Bericht/ein Dokument aus JetBrains Rider mit FastReport .NET erstellen, aufbauen und exportieren.

Was brauchen Sie vorerst? Sie müssen mindestens die JetBrains Rider IDE auf Ihrem PC installiert haben und auch die Besonderheiten von Linux berücksichtigen und zusätzliche Einstellungen vornehmen.

Zuerst benötigen wir für Linux zusätzliche Bibliotheken, die möglicherweise nicht standardmäßig vorinstalliert sind:

libgdiplus;
libx11-dev.

Linux-Einstellung am Beispiel von Ubuntu 22.04.1 LTS:

1. Konsole öffnen;
2. apt-get aktualisieren und Pakete installieren:

sudo apt-get update;
sudo apt-get install libgdiplus.

Als nächstes erstellen Sie eine neue Lösung, indem Sie «New Solution» wählen.

Der nächste Schritt ist die Projekt-Einstellungen. Wählen Sie unter .NET/.NET Core den Projekttyp „Console Application“. Benennen Sie anschließend das Projekt, zum Beispiel „ReportPDF_Core_ConsoleApp“. Klicken Sie dann auf Console Application, Sprache C#, NET 6.0 Framework.

Beginnen Sie mit dem Hinzufügen eines einfachen Beispieldatensatzes für Ihren Bericht in dem Anwendungscode. Fügen Sie dazu in Program.cs folgendes hinzu:

 using System.Data;

Fügen Sie als Nächstes die Variable hinzu:

// creating a dataset set 
DataSet dataSet = new DataSet();

Fügen Sie die CreateDataSet Funktion, in der der Datensatz erstellt und ausgefüllt wird:

void CreateDataSet()
{
// create a simple dataset with one table
// create a simple dataset
dataSet = new DataSet();
 
// create a table
DataTable table = new DataTable();
table.TableName = "Employees";
// adding a table to the dataset
dataSet.Tables.Add(table);
 
// adding data to a table
table.Columns.Add("ID", typeof(int));
table.Columns.Add("Name", typeof(string));
table.Rows.Add(1, "Andrew Fuller");
table.Rows.Add(2, "Nancy Davolio");
table.Rows.Add(3, "Margaret Peacock");
}

Und fügen Sie einen Aufruf der CreateDataSet Funktion hinzu:

//creating a dataset object
DataSet dataSet = new DataSet();
CreateDataSet();

Was ist der einfachste Weg, FastReport .NET in JetBrains Rider zum Laufen zu bringen? Verwenden Sie unsere Private NuGet-server Fast Reports.

Dieser Artikel beschreibt, wie Sie NuGet-Pakete nach der Beschaffung von FastReport .NET hinzufügen können. Hier ist eine kurze Anleitung für Sie, damit Sie nicht zu einem anderen Artikel gehen müssen. Klicken Sie auf die Registerkarte NuGet am unteren Rand der IDE und klicken Sie auf die Registerkarte Sources.

Fügen Sie nun ein neues Repository hinzu, indem Sie auf "+" klicken und die erforderlichen Daten eingeben:

- Name - Quellenname ohne Leerzeichen (z.B., FastReport);
- URL - https://nuget.fast-report.com/api/v3/index.json;
- User – E-Mail von Ihrem Fast Reports Konto;
- Password - Passwort vom Fast Reports Konto.

Sie werden sehen, dass das entsprechende Repository erschienen ist:

Wir werden nun das FastReport Core-Paket installieren. Gehen Sie dazu auf die Registerkarte Packages und filtern Sie die Pakete nach FastReport-Repository. Und natürlich installieren Sie das gefundene Paket.

Wenn die Installation erfolgreich abgeschlossen ist, werden Sie in einer Benachrichtigung darüber informiert.

Als Nächstes erstellen Sie eine Vorlage aus dem Code, indem Sie die folgenden Schritte ausführen. Fügen Sie anschließend zu Program.cs folgendes hinzu:

using System.Drawing;
using FastReport;
using FastReport.Export.Pdf;
using FastReport.Utils;

Fügen Sie als Nächstes CreateDataSet zu Program.cs unten hinzu:

Report report = new Report();
CreateReportTemplate();
ExportToPDF();

Fügen Sie dann die Funktion zum Erstellen einer Berichtsvorlage CreateReportTemplate hinzu:

void CreateReportTemplate()
{
 // adding a report page
 ReportPage page = new ReportPage();
 
 // creating a date band
 DataBand data = new DataBand();
 PageHeaderBand dataText = new PageHeaderBand();
 
 //creating a header
 ReportTitleBand titleBand = new ReportTitleBand();
 TextObject employeeIdText = new TextObject();
 TextObject employeeNameText = new TextObject();
 TextObject idText = new TextObject();
 TextObject nameText = new TextObject();
 TextObject titleText = new TextObject();
 //registering the data source
 report.RegisterData(dataSet);
 //enabling on the data table
 report.GetDataSource("Employees").Enabled = true;
 //adding a page to the template
 report.Pages.Add(page);
 // add to the page: data,data Text, titleBand
 // and set the unique name of the page
 page.AddChild(data);
 page.AddChild(dataText);
 page.AddChild(titleBand);
 page.CreateUniqueName();
 // set the unique name titleBand
 // and set the band settings
 titleBand.CreateUniqueName();
 titleBand.Height = Units.Centimeters * 1.5f;
 titleText.Bounds = new RectangleF(300, 0, Units.Centimeters * 10, Units.Centimeters * 0.5f);
 titleText.Text = "Employees";
 titleText.Font = new Font("Arial", 14, FontStyle.Bold);
 titleText.VertAlign = VertAlign.Center;
 
 // set the unique name data
 // and set the data settings
 data.CreateUniqueName();
 data.DataSource = report.GetDataSource("Employees");
 data.Height = Units.Centimeters * 0.5f;
 
 // set a unique dataText name
 // and set the dataText settings
 dataText.CreateUniqueName();
 dataText.Height = Units.Centimeters * 0.8f;
 
 // setting the unique name employeeIdText
 // and set the employeeIdText, idText settings
 employeeIdText.Parent = data;
 employeeIdText.CreateUniqueName();
 employeeIdText.Bounds = new RectangleF(0, 0, Units.Centimeters * 10, Units.Centimeters * 0.5f);
 idText.Bounds = new RectangleF(0, 0, Units.Centimeters * 10, Units.Centimeters * 0.5f);
 idText.Text = "ID";
 employeeIdText.Text = "[Employees.ID]";
 
 // set the unique name employeeNameText
 // and set the employeeNameText, nameText settings
 employeeNameText.Parent = data;
 employeeNameText.CreateUniqueName();
 employeeNameText.Bounds = new RectangleF(50, 0, Units.Centimeters * 10, Units.Centimeters * 0.5f);
 nameText.Bounds = new RectangleF(50, 0, Units.Centimeters * 10, Units.Centimeters * 0.5f);
 nameText.Text = "Name";
 employeeNameText.Text = "[Employees.Name]";
 
 // add on data band: employeeIdText, employeeNameText
 data.AddChild(employeeIdText);
 data.AddChild(employeeNameText);
 
 // add on dataText band: idText, nameText
 dataText.AddChild(idText);
 dataText.AddChild(nameText);
 
 // add on titleBand band: itleText
 titleBand.AddChild(titleText);
}

Fügen Sie als Nächstes die Funktion zum Erstellen einer Berichtsvorlage „ExportToPDF“ hinzu und nennen Sie den Berichtsexport "Bericht.pdf":

void ExportToPDF()
{
 // running the report
 report.Prepare();
 // creating an export instance
 PDFExport export = new PDFExport();
 report.Export(export, "test.pdf");
 // disposing the resources used by the report
 report.Dispose(); 
}

Starten Sie die Konsolenanwendung. Wenn die Meldung „Process finished with exit code 0“ kommt, haben Sie alles richtig gemacht. Öffnen Sie dann den Bericht in unserem Fall unter /home/alex/RiderProjects/ReportPDF_Core_ConsoleApp/ReportPDF_Core_ConsoleApp/bin/Debug/net6.0/test.pdf:

So haben wir einen einfachen Bericht/ein einfaches Dokument im PDF-Format, der/das aus einem Datensatz erstellt worden ist.

In diesem Artikel haben wir die Kombination aus JetBrains Rider (C#) + .NET Core + Console Application + FastReport .NET Core + Linux (Ubuntu 22.04.1 LTS) betrachtet und einen Bericht aus einem PDF-Datensatz erstellt. Und natürlich haben wir uns davon überzeugt, dass die .NET-Plattform problemlos ohne Microsoft Visual Studio verwendet werden kann, da Linux es einfach nicht hat.

Wir haben natürlich nicht die Erstellung einer GUI-Anwendung unter Linux betrachtet, die beispielsweise mit dem Mono-Framework möglich ist, aber auf unserer Website finden Sie Artikel dazu.

Vollständige Programmliste

using System.Data;
using System.Drawing;
using FastReport;
using FastReport.Export.Pdf;
using FastReport.Utils;
 
//Erstellen eines Datensatzobjektes 
DataSet dataSet = new DataSet();
CreateDataSet();
// Erstellen eines Berichtobjektes
Report report = new Report();
 
CreateReportTemplate();
ExportToPDF();
 
void CreateReportTemplate()
{
 // Hinzufügen einer Berichtsseite
 ReportPage page = new ReportPage();
 
 // Erstellen von DataBand
 DataBand data = new DataBand();
 PageHeaderBand dataText = new PageHeaderBand();
 
 //Erstellen der Kopfzeile
 ReportTitleBand titleBand = new ReportTitleBand();
 TextObject employeeIdText = new TextObject();
 TextObject employeeNameText = new TextObject();
 TextObject idText = new TextObject();
 TextObject nameText = new TextObject();
 TextObject titleText = new TextObject();
 //Erfassung der Datenquelle
 report.RegisterData(dataSet);
 //Einfügen der Datentabelle
 report.GetDataSource("Mitarbeiter").Enabled = true;
 // Hinzufügen einer Seite zur Vorlage
 report.Pages.Add(page);
 // Hinzufügen zur Seite: data,dataText, titleBand
 // und Vergabe eines eindeutigen Seitennamens 
 page.AddChild(data);
 page.AddChild(dataText);
 page.AddChild(titleBand);
 page.CreateUniqueName();
 // Vergabe eines eindeutigen Namens titleBand
 // und Festlegung der Band- Einstellungen 
 titleBand.CreateUniqueName();
 titleBand.Height = Units.Centimeters * 1.5f;
 titleText.Bounds = new RectangleF(300, 0, Units.Centimeters * 10, Units.Centimeters * 0.5f);
 titleText.Text = "Mitarbeiter";
 titleText.Font = new Font("Arial", 14, FontStyle.Bold);
 titleText.VertAlign = VertAlign.Center;
 
 // Vergabe eines eindeutigen data-Namens 
 // und Festlegung der data- Einstellungen
 data.CreateUniqueName();
 data.DataSource = report.GetDataSource("Mitarbeiter");
 data.Height = Units.Centimeters * 0.5f;
 
 // Vergabe eines eindeutigen dataText-Namens 
 // und Festlegung der dataText- Einstellungen
 dataText.CreateUniqueName();
 dataText.Height = Units.Centimeters * 0.8f;
 
 // Vergabe eines eindeutigen employeeIdText- Namens
 // und Festlegung der employeeIdText, idText- Einstellungen
 employeeIdText.Parent = data;
 employeeIdText.CreateUniqueName();
 employeeIdText.Bounds = new RectangleF(0, 0, Units.Centimeters * 10, Units.Centimeters * 0.5f);
 idText.Bounds = new RectangleF(0, 0, Units.Centimeters * 10, Units.Centimeters * 0.5f);
 idText.Text = "ID";
 employeeIdText.Text = "[Mitarbeiter.ID]";
 
 // Vergabe eines eindeutigen employeeNameText- Namens
 // und Festlegung der employeeNameText, nameText- Einstellungen
 employeeNameText.Parent = data;
 employeeNameText.CreateUniqueName();
 employeeNameText.Bounds = new RectangleF(50, 0, Units.Centimeters * 10, Units.Centimeters * 0.5f);
 nameText.Bounds = new RectangleF(50, 0, Units.Centimeters * 10, Units.Centimeters * 0.5f);
 nameText.Text = "Name";
 employeeNameText.Text = "[Mitarbeiter.Name]";
 
 // Ergänzung von data Band: employeeIdText, employeeNameText
 data.AddChild(employeeIdText);
 data.AddChild(employeeNameText);
 
 // Ergänzung von dataText Band: idText, nameText
 dataText.AddChild(idText);
 dataText.AddChild(nameText);
 
 // Ergänzung von titleBand: itleText
 titleBand.AddChild(titleText);
}
 
void ExportToPDF()
{
 report.Prepare();
 PDFExport export = new PDFExport();
 report.Export(export, "test.pdf");
 report.Dispose(); 
}
 
void CreateDataSet()
{
 // Erstellen eines einfachen Datensatzes mit einer Tabelle
 
 // Erstellen eines einfachen Datensatzes
 dataSet = new DataSet();
 
 // Erstellen einer Tabelle
 DataTable table = new DataTable();
 table.TableName = "Mitarbeiter";
 // Hinzufügen einer Tabelle zum Datensatz
 dataSet.Tables.Add(table);
 
 // Hinzufügen von Daten zu einer Tabelle
 table.Columns.Add("ID", typeof(int));
 table.Columns.Add("Name", typeof(string));
 table.Rows.Add(1, "Andrew Fuller");
 table.Rows.Add(2, "Nancy Davolio");
 table.Rows.Add(3, "Margaret Peacock");
}