Blazor PDF Viewer Tutorial

Einführung

Adobe hat das Portable Document Format (PDF) erstellt, das weithin zur Veröffentlichung von formatiertem Text und Bildern verwendet wird. In diesem Tutorial wird empfohlen, IronPDF in eine Blazor-Serveranwendung zur Anzeige von PDFs zu integrieren, da es einfach zu verwenden und effizient ist.

1. IronPDF-Funktionen

Mit Hilfe der leistungsstarken IronPDF PDF for .NET-Bibliothek können Entwickler problemlos PDF-Dokumente erstellen, lesen und ändern. Basierend auf dem IronPDF Chrome Rendering Engine umfasst IronPDF eine breite Palette nützlicher und leistungsstarker Funktionen, wie die Möglichkeit, HTML5, JavaScript, CSS und Bilder in PDFs zu konvertieren, die Möglichkeit, benutzerdefinierte Kopf- und Fußzeilen zu PDFs hinzuzufügen, und die Möglichkeit, PDFs zu erstellen, die genau so aussehen wie in einem Webbrowser.

IronPDF unterstützt mehrere Webtechnologien, darunter HTML, ASPX, Razor View und MVC. Die wichtigsten Merkmale von IronPDF sind

• IronPDF bietet volle Kontrolle über die Erstellung und Änderung von PDF-Dateien innerhalb von .NET C#-Anwendungen
• IronPDF kann PDF-Dateien von Webseiten aus ihren URLs generieren, indem spezifische User-Agent-, Proxy-, Header- und Cookie-Konfigurationen verwendet werden.
• IronPDF kann Bilder aus bestehenden PDF-Dokumenten löschen
• IronPDF kann Text, Fotos, Lesezeichen, Wasserzeichen und andere Elemente zu PDF-Dokumenten hinzufügen
• IronPDF verfügt über mehrere Funktionen, mit denen PDF-Dokumente einfach zusammengeführt und geteilt werden können.
• IronPDF kann Web-Medieninhalte wie CSS und JavaScript verstehen und darstellen
• IronPDF unterstützt verschiedene .NET-Desktop- und MVC-Webanwendungs-Frameworks, einschließlich ASP.NET und Blazor

2. Was ist Blazor?

Blazor ist ein experimentelles Webanwendungs-Framework, das es ermöglicht, clientseitige Webanwendungen in C# und HTML unter Verwendung von Web Assembly zu erstellen.

Web Assembly-Anwendungen werden in einem binären Befehlsformat an den Browser gesendet, das mit nahezu natürlicher Geschwindigkeit arbeitet. Dies hat neue Möglichkeiten für Sprachen wie C# geschaffen, die innerhalb des Browsers ausgeführt werden können.

Erstellen eines neuen Projekts in Visual Studio

Öffnen Sie zunächst die Anwendung Microsoft Visual Studio und wählen Sie im Menü "Datei" die Option "Neues Projekt". Wählen Sie dann "Blazor Server App".

Erstellen eines neuen Projekts in Visual Studio

Geben Sie einen Projektnamen ein und wählen Sie einen Dateipfad. Klicken Sie dann auf die Schaltfläche Erstellen.

Erstellen eines neuen Projekts in Visual Studio

Wählen Sie außerdem das gewünschte .NET-Framework aus. Es wird empfohlen, aus Gründen der Stabilität die neueste Version zu verwenden.

Wählen des .NET 6.0 Frameworks für die neue Blazor Server App

Microsoft Visual Studio wird nun die Struktur für die neue Blazor Server-App erstellen. Dieses Projekt enthält eine Sammlung von .razor-Dateien, in die Sie Quellcode eingeben können.

Im nächsten Schritt wird die IronPDF-Bibliothek zum Projekt hinzugefügt.

3. Installieren Sie die IronPDF-Bibliothek

Die IronPDF Library kann auf vier Arten heruntergeladen und installiert werden:

• Verwendung des NuGet-Paketmanagers von Visual Studio
• Verwendung der Befehlszeile von Visual Studio
• Direktes Herunterladen von der NuGet-Website
• Direktes Herunterladen von der IronPDF-Website

3.1 Verwendung des NuGet-Paketmanagers von Visual Studio

Visual Studio bietet den NuGet Package Manager, um die Installation von Bibliotheken direkt in Projekten zu unterstützen. Der folgende Screenshot zeigt, wie Sie den NuGet Package Manager öffnen.

Zugriff auf den NuGet-Paket-Manager von Visual Studio

Verwenden Sie das Suchfeld auf der Registerkarte Durchsuchen, um nach "IronPDF" zu suchen, wie in der folgenden Abbildung gezeigt:

Suche nach der IronPDF-Bibliothek im NuGet-Paketmanager-GUI

Das Bild oben zeigt die Liste der verwandten Suchergebnisse. Wählen Sie die erforderlichen Optionen, um das Paket in Ihr Projekt zu installieren.

3.2 Verwendung der Visual Studio-Befehlszeile

In Visual Studio, gehen Sie zu Tools > NuGet-Paket-Manager > Paket-Manager-Konsole

Geben Sie die folgende Zeile auf der Registerkarte Paketmanager-Konsole ein:

Install-Package IronPdf

Das Paket wird nun heruntergeladen und im aktuellen Projekt installiert.

Installation der IronPDF-Bibliothek mit dem NuGet-Paket-Manager-Konsole

3.3 Direktes Herunterladen von der NuGet-Website

Die dritte Möglichkeit, die IronPDF-Bibliothek zu installieren, besteht darin, das NuGet-Paket direkt von der Website herunterzuladen.

Gehen Sie zum IronPDF-Paket auf NuGet.

• Klicken Sie im Menü auf der rechten Seite auf die Option "Paket herunterladen".
• Öffnen Sie das heruntergeladene Paket in Ihrem Dateisystem. Sie wird automatisch installiert.
• Laden Sie die Lösung neu und verwenden Sie sie in Ihrem Projekt.

3.4 Direktes Herunterladen von der IronPDF-Website

Laden Sie das neueste Paket von der IronPDF-Website herunter.

Führen Sie nach dem Herunterladen die folgenden Schritte aus, um das Paket zu Ihrem Projekt hinzuzufügen:

• Klicken Sie mit der rechten Maustaste auf das Projekt im Lösungsfenster.
• Wählen Sie die Option "Referenz" und navigieren Sie dann zum Speicherort der Bibliothek, die Sie zuvor heruntergeladen haben.
• Klicken Sie auf OK, um die Bibliothek als Referenz hinzuzufügen.

4. Anzeigen von PDF-Dokumenten mit der Blazor Server App

Die Blazor-Anwendung, die in diesem Tutorial gebaut wird, erstellt ein PDF-Dokument aus der URL einer Webseite und rendert es in den Webbrowser eines Clients.

Mit IronPDF ist das Anzeigen von PDF-Dateien ganz einfach.

Fügen Sie den folgenden Quellcode in die entsprechende .razor-Datei ein.

string _imgUrl = "";
private async Task ViewFile()
{
    var renderer = new IronPdf.ChromePdfRenderer();
    var pdf = renderer.RenderUrlAsPdf("https://localhost:7018/fetchdata");
    _imgUrl = $"data:application/pdf;base64,{Convert.ToBase64String(pdf.Stream.ToArray())}";
}

string _imgUrl = "";
private async Task ViewFile()
{
    var renderer = new IronPdf.ChromePdfRenderer();
    var pdf = renderer.RenderUrlAsPdf("https://localhost:7018/fetchdata");
    _imgUrl = $"data:application/pdf;base64,{Convert.ToBase64String(pdf.Stream.ToArray())}";
}

Private _imgUrl As String = ""
Private Async Function ViewFile() As Task
	Dim renderer = New IronPdf.ChromePdfRenderer()
	Dim pdf = renderer.RenderUrlAsPdf("https://localhost:7018/fetchdata")
	_imgUrl = $"data:application/pdf;base64,{Convert.ToBase64String(pdf.Stream.ToArray())}"
End Function

Der obige Codeausschnitt verwendet zuerst die RenderUrlAsPdf-Methode von IronPDF, die den HTML-Inhalt von einer angegebenen URL herunterlädt und in ein PDF-Format umwandelt. Anschließend rendert das Codeschnipsel den generierten PDF-Inhalt als eine Zeichenkette aus base64-Rohdaten und speichert sie in einer lokalen Variablen.

Zur Vereinfachung können Anwendungen die SaveAs-Methode von IronPDF (verfügbar auf jeder ChromePdfRenderer-Instanz) verwenden, um generierte PDF-Dokumente auf dem Dateisystem des Servers zur schnellen späteren Nutzung zu speichern.

Das nächste Codesegment bereitet die Base-64-PDF-Daten für die Ausgabe im Browser des Kunden vor.

@if (_imgUrl != string.Empty)
{
    <iframe src="@_imgUrl" style="width:750px;height:750px;" type="application/pdf"/>
}

@if (_imgUrl != string.Empty)
{
    <iframe src="@_imgUrl" style="width:750px;height:750px;" type="application/pdf"/>
}

'INSTANT VB WARNING: The following constructor is declared outside of its associated class:
'ORIGINAL LINE: if(_imgUrl != string.Empty)
Private Sub New(Optional _imgUrl (Not ByVal) As = String.Empty)
'INSTANT VB WARNING: An assignment within expression was extracted from the following statement:
'ORIGINAL LINE: <iframe src="@_imgUrl" style="width:750px;height:750px;" type="application/pdf"/>
	"width:750px;height:750px;" type="application/pdf"/>
'INSTANT VB WARNING: An assignment within expression was extracted from the following statement:
'ORIGINAL LINE: <iframe src="@_imgUrl" style="width:750px;height:750px;" type
	"@_imgUrl" style="width:750px;height:750px;" type
	<iframe src="@_imgUrl" style
End Sub

Die obige Funktion empfängt die base64-Daten von der Blazor-Server-Seite und bindet sie an das src-Attribut eines iframe-Elements. Beim Laden der Seite veranlasst dies die Browser, ihre integrierten Viewer zu verwenden, um den base64-Inhalt als korrektes PDF-Dokument darzustellen.

Unten ist ein Screenshot der PDF-Datei, wenn sie aus dem base64-String gerendert wird.

![Blazor PDF Viewer Tutorial, Abbildung 7: Anzeigen eines in einer Blazor-App im Browser generierten PDF. Dieses PDF wurde von IronPDF erstellt und als Base64-String an den Browser gesendet.

Anzeigen eines in einer Blazor-App generierten PDFs im Browser. Dieses PDF wurde von IronPDF erstellt und als base64-Zeichenkette an den Browser gesendet.

Anzeigen eines PDF-Dokuments aus einer HTML-Zeichenkette

Im Folgenden wird gezeigt, wie IronPDF eine PDF-Datei aus einer Reihe von HTML-Tags erstellen kann.

var pdf = new IronPdf.ChromePdfRenderer().RenderHtmlAsPdf("<h1>Hello world!!</h1>")

var pdf = new IronPdf.ChromePdfRenderer().RenderHtmlAsPdf("<h1>Hello world!!</h1>")

'INSTANT VB TODO TASK: The following line uses invalid syntax:
'var pdf = New IronPdf.ChromePdfRenderer().RenderHtmlAsPdf("<h1>Hello world!!</h1>")

Das erzeugte PDF-Dokument kann über den Browser des Kunden mit dem im vorherigen Abschnitt beschriebenen Verfahren angezeigt werden.

Schlussfolgerung

In diesem Artikel wurde gezeigt, wie man eine Blazor-Webanwendung entwickelt, die die IronPDF-Bibliothek verwendet, um eine PDF-Datei aus einer Webseite zu generieren und sie im Browser des Benutzers anzuzeigen.

IronPDF ist nicht quelloffen; Jedoch ermöglicht ein kostenloser Testschlüssel die Nutzung in der Produktion ohne Wasserzeichen.