Erstellen und Installieren des Postgres-Plugins in FastReport .NET

Unser FastReport .NET verfügt über ziemlich umfangreiche Eigenschaften und ein breites Funktionsspektrum. In diesem Artikel betrachten wir die Herstellung einer Verbindung zur Datenbank über das FastReport Plugin für den Berichtsdesigner.

Im Beispiel unten lautet der Installationspfad von FastReport .NET wie folgt: C:\Program Files (x86)\FastReports\WinForms

1.    Navigieren Sie zu dem Installationsordner und folgen Sie dann dem Pfad  Extras\Core\FastReport.Data\FastReport.Data.Postgres

Wichtig! Der Pfad sollte genau so lauten; es kann sein, dass es auf anderen Pfaden veraltete Projekte gibt.

2.    Suchen Sie in Visual Studio die Projektdatei FastReport.Data.Postgres.csproj.

Wichtig: Dieser Ordner enthält mehrere Dateien, Sie müssen diese Datei öffnen.

3.    Mehrere Projekte werden in Visual Studio geöffnet. Wählen Sie FastReport.Data.Postgres aus, klicken Sie mit der rechten Maustaste darauf, und klicken Sie dann im Kontextmenü auf „Set as Startup Project“.

4.    Wählen Sie das Build „Release“ und das Target „net462“.

5.    Erweitern Sie im Entscheidungsbaum das Projekt -> Dependencies -> net462 -> Projects und Packages. Achten Sie auf Ausrufezeichen in Dreiecken.

6.    Löschen Sie „FastReport“ in „Projects“. Entfernen Sie nichts anderes aus den Abhängigkeiten (Dependencies). Jetzt müssen Sie die FastReport.Net und Npgsql Nuget-Pakete hinzufügen. 

Wichtig: FastReport.Net muss als Paket hinzugefügt werden, da die Methode zum Hinzufügen von FastReport.dll nicht mehr funktioniert.

7.    Wählen Sie im Kontextmenü „Dependencies“ die Option „Manage NuGet Packages“ aus.

8.    Sie müssen zwei Paketquellen (Package source) hinzufügen: nuget.org und eine Quelle, die auf unseren Nuget-Server oder auf einen lokalen Ordner verweist  C:\ProgramFiles(x86)\FastReports\WinForms\Nugets.

9.    Wählen Sie die nuget.org Quelle aus.

10.    Suchen Sie auf der Registerkarte „Installed“ oder „Updates“ das Npgsql-Paket und klicken Sie darauf.

11.    Auf der rechten Seite sehen Sie die folgenden Daten: die aktuelle Version 3.2.7, die an das Projekt gebunden ist, die neueste Paketversion 8.0.3, die Schaltflächen Uninstall und Update.

12.    Klicken Sie auf die Schaltfläche Update.

13.    Wählen Sie die zweite Paketquelle aus. In diesem Beispiel wird der Nuget Server von FastReports GmbH verwendet.

14.    Gehen Sie auf die Registerkarte Browse, geben Sie fastreport.net in das Suchfeld ein.

15.    Wählen Sie das FastReport.Net-Paket oder das FastReport.Net.Demo-Paket für die Testversion aus. 

Wichtig: Wählen Sie eines dieser beiden Pakete, da das Paket FastReport.Net.Pro veraltet ist und nicht mehr verwendet wird. 

16.    Schauen Sie sich die Version genau an und wählen Sie diejenige, die wir installiert haben. In dieser Anleitung wird die Version 2024.2.12 betrachtet.

17.    Klicken Sie auf die Schaltfläche Install. Akzeptieren Sie die Lizenzvereinbarung und warten Sie, bis das Paket installiert ist.

18.    Klicken Sie mit der rechten Maustaste auf das FastReport.Data.Postgres Projekt und klicken Sie im Kontextmenü auf Build.

19.    Unten links sehen Sie die Aufschrift „Build succeeded“. Dies bedeutet, dass das Plugin korrekt erstellt wurde und Visual Studio geschlossen werden kann.

20.    Gehen Sie zu dem Ordner, in dem FastReport.NET installiert ist, wie oben in der Anleitung angegeben ist: C:\Program Files (x86)\FastReports\WinForms. Hier sollten Sie «Designer.exe» finden.

21.    Navigieren Sie von diesem Ordner zu den folgenden Unterordnern nach dem Pfad: Extras\Core\FastReport.Data\FastReport.Data.Postgres\bin\Release 

22.    Suchen Sie zwei Ordner „net462“ und „net6.0-windows7.0“, gehen Sie in den Ordner net462.

23.    Kopieren Sie die folgenden Dateien aus diesem Ordner: 

FastReport.Data.Postgres.dll, 
Npgsql.dll, 
Microsoft.Bcl.AsyncInterfaces.dll, 
Microsoft.Extensions.Logging.Abstractions.dll, 
System.Threading.Tasks.Extensions.dll, 
System.Memory.dll 

24.    Fügen Sie die kopierten Dateien in den Ordner ein, in dem sich Designer.exe befindet.

25.    Starten Sie „Designer.exe“, gehen Sie in das Menü File->Options (View->Options, wenn die Multifunktionsleiste deaktiviert ist). Gehen Sie auf die Registerkarte „Plugins“.

26.    Wenn bereits ein FastReport.Data.Postgres-Plugin vorhanden ist, müssen Sie es entfernen und den Schritt 21 wiederholen.

27.    Klicken Sie auf die Schaltfläche „Add“, gehen Sie zum Designer-Ordner, in diesem Beispiel ist es C:\Program Files (x86)\FastReports\WinForms 

28.    Wählen Sie die FastReport.Data.Postgres.dll Datei aus und klicken Sie auf die Schaltfläche „Open“. Das Plugin erscheint in der Liste.

29.    Achten Sie auf die Aufschrift unten links, die darauf hinweist, dass der Designer neu gestartet werden muss. Klicken Sie auf die Schaltfläche OK. Schließen Sie den Designer.

30.    Starten Sie Designer.exe erneut. Wenn Sie diesen Anweisungen genau folgten, sollte die Verbindung zu Postgres in der Liste der Verbindungen erscheinen.

31.    Wenn beim Versuch, eine Verbindung herzustellen, der untenstehende Fehler auftritt,

müssen Sie den Designer schließen und die im Fehler angegebene Datei aus dem Ordner С:\Program Files(x86)\Fast Reports\WinForms \Extras\Core\FastReport.Data\FastReport.Data.Postgres\bin\Release\net462 in den Ordner kopieren, in dem sich Designer.exe befindet.

In FastReport .NET ist es sehr einfach, verschiedene Konnektoren zu erstellen und mit mehreren Datenbanken zu verbinden.