Vom Rauch zum Boden: Ein Update zu unserem Biokohle-Projekt in Nordthailand

Der Workshop

Falls Sie Jeff Fritz nicht kennen: Er ist ein Microsoft MVP, ein Principal Program Manager bei Microsoft und Gastgeber des langlaufenden Fritz and Friends-Streams. Er veranstaltet kostenlose Workshops für Entwickler, die am Anfang ihrer .NET-Reise stehen, und vor einigen Wochen hat er einen der ehrgeizigsten durchgeführt: ein fünfstündiger Live-Build, der HTML, CSS, C#, Blazor, ASP.NET und .NET Aspire abdeckte, bei dem die gesamte Gruppe eine funktionierende Anwendung zum Sammeln von Sammlungen von Grund auf erstellte.

Nach vier Stunden benötigte die Anwendung PDF-Berichte. Ein Benutzer sollte in der Lage sein, auf eine Schaltfläche zu klicken und ein sauberes, herunterladbares PDF seiner Sammlung zu erhalten. Herkömmliche, reale interne Tool-Sachen. Die Art von Funktion, die jeder Produktmanager schließlich verlangt und die jeder Entwickler irgendwann liefern muss.

Das Muster, das Jeff lehrt, ist das, das die meisten Teams verwenden sollten, und es lohnt sich, es zu erklären, denn sobald man es sieht, hört man auf, nach den falschen Werkzeugen zu greifen.

Installieren Sie IronPDF kostenlos

Das Fünf-Schritte-Muster

Hier ist die Form davon. Es ist täuschend kurz.

1. Eine dedizierte Razor-Seite für den Bericht. Jeff erstellt Report.razor im Pages-Verzeichnis des Projekts. Kleine Entscheidung, großer Gewinn, indem der Bericht als eigene Seite gehalten wird, kann er unabhängig vom Rest der Benutzeroberfläche formatiert, regeneriert und getestet werden. Der Bericht wird zu einem erstklassigen Bestandteil der Anwendung und nicht zu einem Hack, der auf eine andere Ansicht angehängt wird.

2. Injizieren Sie den Datenkontext. Die Entity Framework Core CollectionContext-Fabrik wird über Dependency Injection eingebracht, genau wie jeder andere Datenabrufpunkt in der Anwendung. Kein spezielles Muster, kein Workaround, kein separater Datenpfad nur für Berichte. Der Bericht verwendet dieselben Daten wie der Rest der App, auf die gleiche Weise.

3. Rendern Sie den Bericht als HTML. Dies ist der Schritt, der ein gutes Muster von einem brüchigen trennt. Jeff greift nicht zu einer PDF-spezifischen Layoutsprache. Er schreibt den Bericht als HTML, denselben Markup, den er den ganzen Nachmittag über verwendet hat, und lässt das vorhandene Styling wirken. Kopfzeilen, Tabellen, Abschnitte, alles in HTML. Die Tatsache, dass das endgültige Ergebnis ein PDF ist, ist ein Detail, das später kommt.

4. Konvertieren Sie HTML zu PDF mit einer Zeile. Hier hat IronPDF seinen Platz verdient. ChromePdfRenderer nimmt die HTML-Zeichenfolge und erzeugt ein echtes, korrekt gerendertes PDF mit einer Chrome-Engine im Hintergrund. CSS, das im Browser gut aussieht, sieht auch im PDF gut aus. Keine separate Styling-Schicht zu lernen, keine Rendering-Quirks zu debuggen.

5. Rückgabe als Datei. Der Browser lädt das PDF sauber herunter, wenn der Benutzer den Button klickt. Fertig. Funktion bereitgestellt.

Das ist das gesamte Muster. Fünf Schritte, zwanzig Minuten Stream-Zeit und eine Funktion, die in der Produktion hält.

Warum das funktioniert

Der tiefere Grund, warum dieses Muster das richtige ist, ist die Dauerhaftigkeit, aber der oberflächliche Grund ist, dass jeder Schritt etwas ist, das der Entwickler bereits zu tun weiß.

Das Berichtslayout schreiben? Das ist HTML und CSS, wie bei jeder anderen Seite. Die Daten abfragen? Dasselbe EF-Core-Muster. Die Seite in die App einbinden? Gleiche Razor-Seiten, gleiches DI. Der einzige wirklich neue Schritt ist die Konvertierung in PDF, und das ist eine Zeile.

Vergleichen Sie das mit den Alternativen. Druckdialog-Ansätze brechen, sobald ein Benutzer einen anderen Browser, einen anderen Zoom-Level oder eine unerwartete Druckereinstellung hat. PDF-Bibliotheken auf der Client-Seite zwingen den Entwickler, eine völlig neue Layoutsprache zu lernen. Eigenständig entwickelte koordinatenbasierte Layouts funktionieren für einen Bericht und brechen beim zweiten zusammen. Keine dieser Ansätze überlebt den Kontakt mit einem realen Produkt.

Das serverseitige HTML-zu-PDF-Muster überlebt. Das Ergebnis ist konsistent, deterministisch und zentralisiert, derselbe Input erzeugt jedes Mal dasselbe PDF, auf jedem Client, da das Rendering an einem Ort unter einem Satz von Regeln passiert. Für interne Werkzeuge, kundenorientierte Berichte, Audit-Trail-Dokumente, überall dort, wo Konsistenz beim Output wirklich zählt, ist dies das Muster, das standhält.

Dieser Workshop lehrt es klar, weil er keine Zeit hat, es auf eine andere Weise zu lehren.

Probieren Sie es in Ihrem eigenen Projekt aus

Die Bibliothek, die Jeff für den Konvertierungsschritt verwendet, IronPDF, ist kostenlos mit einem 30-Tage-Testlizenzschlüssel auszuprobieren. Registrieren Sie sich mit einer geschäftlichen E-Mail-Adresse, der Schlüssel kommt in Ihren Posteingang, und Sie können das genaue Muster, das Jeff Fritz lehrt, in Ihrem eigenen Projekt umsetzen, bevor der Nachmittag vorbei ist. Keine Wasserzeichen während der Testphase, voller Funktionszugang, jede API verfügbar.

Wenn Sie das Hinzufügen von PDF-Berichten aufgeschoben haben, weil es das letzte Mal, als Sie es versucht haben, einen Tag gedauert hat, ist dies die Version des Projekts, die zwanzig Minuten dauert.

Starten Sie Ihre kostenlose IronPDF-Testversion

Sehen Sie sich den vollständigen Workshop an

Jeff's komplette Sitzung ist auf seinem YouTube-Kanal. Der PDF-Berichtsabschnitt beginnt bei 4:56:48, aber auch die früheren Module sind Ihre Zeit wert, sie sind eine klare Rampe durch den modernen .NET-Stack, und Jeff's Lehre ist wirklich gut.

Watch on YouTube