Anzeigen von PDFs in MAUI für C# .NET
In der modernen Ära der plattformübergreifenden Entwicklung ist die Möglichkeit, PDF-Dokumente direkt in Ihrer Anwendung anzuzeigen, nicht nur ein Komfort, sondern eine Notwendigkeit. Mit dem IronPDF Viewer können Sie PDF-Anzeige-Funktionen in Ihre MAUI-Anwendung einbetten.
In diesem Artikel werden wir lernen, wie man den IronPDF Viewer in eine MAUI-Anwendung integriert, um Benutzern die Möglichkeit zu geben, PDFs anzuzeigen, zu speichern und zu drucken.
Übersicht
Anzeigen von PDFs in C# .NET MAUI APPs
- Laden Sie die IronPDF Viewer-Bibliothek herunter und installieren Sie sie
- Integration von IronPDF Viewer in eine MAUI-Anwendung
- Fügen Sie eine PDF-Viewer-Seite hinzu, indem Sie entweder XAML oder C# ContentPage
- Laden einer PDF-Datei beim Start nach Dateiname, Byte-Array und Stream
- Konfigurieren Sie die Werkzeugleiste
Herunterladen und Installieren der IronPDF Viewer Library
Beginnen Sie noch heute mit der Verwendung von IronPDF in Ihrem Projekt mit einer kostenlosen Testversion.
Visual Studio - NuGet-Paketverwaltung
In Visual Studio klicken Sie mit der rechten Maustaste im Projektmappen-Explorer auf Ihr Projekt und wählen Sie Verwalten von NuGet-Paketen.... Dort können Sie nach IronPdf.Viewer.Maui suchen und die neueste Version in Ihre Lösung installieren. Alternativ können Sie die NuGet-Paket-Manager-Konsole öffnen, indem Sie zu Tools > NuGet-Paket-Manager > Paket-Manager-Konsole navigieren und den folgenden Befehl eingeben:
Install-Package IronPdf.Viewer.Maui
Integration von IronPDF Viewer in eine MAUI-Anwendung
In den folgenden Abschnitten wird gezeigt, wie IronPDF Viewer in eine Standard-MAUI-Anwendung integriert werden kann.
Einrichtung
Bevor Sie IronPDF Viewer zu Ihrem MAUI-Projekt hinzufügen, stellen Sie zunächst sicher, dass es nicht auf die Plattformen iOS und Android ausgerichtet ist. Sie können dies überprüfen, indem Sie mit der rechten Maustaste auf die Projektdatei klicken und Eigenschaften auswählen. Deaktivieren Sie die unterstrichenen Kontrollkästchen Zielplattform iOS und Zielplattform Android im untenstehenden Bild, wenn sie nicht bereits deaktiviert sind. Damit diese Änderung erfolgreich umgesetzt werden kann, müssen Sie das Projekt nach dem Entfernen der Markierung speichern und Visual Studio neu starten.
Nachdem Sie das Targeting für die iOS- und Android-Plattformen aufgehoben haben, gehen Sie zu Ihrer Datei MauiProgram.cs und fügen Sie den folgenden Code hinzu, um den Viewer zu initialisieren:
:path=/static-assets/pdf/content-code-examples/tutorials/pdf-viewing-1.csusing IronPdf.Viewer.Maui;
public static class MauiProgram
{
public static MauiApp CreateMauiApp()
{
var builder = MauiApp.CreateBuilder();
builder
.UseMauiApp<App>()
// other configuration options ...
.ConfigureIronPdfView(); // configure the viewer on app start-up
return builder.Build();
}
}Standardmäßig zeigt der IronPDF Viewer ein Banner unten rechts in der Ansicht an. Um diese Ansicht zu entfernen, fügen Sie Ihren IronPDF (oder Iron Suite) Lizenzschlüssel zu ConfigureIronPdfView hinzu, wie folgt:
:path=/static-assets/pdf/content-code-examples/tutorials/pdf-viewing-2.cs.ConfigureIronPdfView("YOUR-LICENSE-KEY");Hinzufügen einer PDF-Viewer-Seite
In diesem Abschnitt lernen wir, wie man eine PDF-Viewer-Seite erstellt, IronPDF Viewer integriert und eine Registerkarte dafür in einer MAUI-Anwendung erstellt. Wir werden demonstrieren, wie man dies sowohl mit einer XAML- als auch einer C# ContentPage macht.
Schritte
Fügen Sie eine neue Seite zu Ihrem Projekt hinzu, indem Sie mit der rechten Maustaste auf Ihr Projekt klicken und dann zu
Hinzufügen > Neues Element...navigieren.
Wechseln Sie zum Abschnitt
.NET MAUI. Um eine XAML-Seite zu erstellen, wählen Sie.NET MAUI ContentPage (XAML). Für eine C#-Datei wählen Sie.NET MAUI ContentPage (C#). Geben Sie Ihrer Datei den Namen PdfViewerPage und klicken Sie dann aufHinzufügen.
- Fügen Sie in der XAML-Datei den folgenden Code hinzu und speichern Sie ihn:
<?xml version="1.0" encoding="utf-8" ?>
<ContentPage ...
xmlns:ipv="clr-namespace:IronPdf.Viewer.Maui;assembly=IronPdf.Viewer.Maui"
...>
<ipv:IronPdfView x:Name="pdfView"/>
</ContentPage>Wenn Sie stattdessen eine C# ContentPage erstellt haben, fügen Sie stattdessen den folgenden Code hinzu und speichern Sie:
:path=/static-assets/pdf/content-code-examples/tutorials/pdf-viewing-3.csusing IronPdf.Viewer.Maui;
public class MainPage : ContentPage
{
private readonly IronPdfView pdfView;
public MainPage()
{
InitializeComponent();
this.pdfView = new IronPdfView { Options = IronPdfViewOptions.All };
Content = this.pdfView;
}
}
- Fügen Sie in Ihrer Datei AppShell.xaml folgendes hinzu:
<?xml version="1.0" encoding="UTF-8" ?>
<Shell ...
xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
...>
<TabBar x:Name="AppTabBar">
<Tab Title="Home">
<ShellContent ContentTemplate="{DataTemplate local:MainPage}" Route="MainPage"/>
</Tab>
<Tab Title="PDF Viewer">
<ShellContent ContentTemplate="{DataTemplate local:PdfViewerPage}" Route="PDFViewer"/>
</Tab>
</TabBar>
</Shell>Speichern Sie Ihr Projekt, erstellen Sie es und führen Sie es aus. In der oberen linken Ecke sollten Sie Registerkarten sehen, wie unten dargestellt. Wenn Sie auf die Registerkarte "PDF Viewer" klicken, wird der IronPDF Viewer geöffnet.
Laden einer PDF-Datei beim Start
Beim Start der Anwendung fordert IronPDF Viewer den Benutzer standardmäßig auf, eine PDF-Datei zu öffnen. Es ist auch möglich, dass das Programm beim Start automatisch eine PDF-Datei öffnet. Es gibt drei Möglichkeiten, eine PDF-Datei beim Start zu laden: über einen Dateinamen, über ein Byte-Array und über einen Stream.
Laden nach Dateiname
Um eine PDF-Datei per Dateinamen zu laden, können Sie die Quelle der PDF-Datei im IronPdfView-Tag in der XAML-Datei angeben. Ein Beispiel dafür wird unten gezeigt:
<?xml version="1.0" encoding="utf-8" ?>
<ContentPage ...
xmlns:ipv="clr-namespace:IronPdf.Viewer.Maui;assembly=IronPdf.Viewer.Maui"
...>
<ipv:IronPdfView Source="C:/path/to/my/example.pdf" />
</ContentPage>Alternativ können Sie die PDF-Datei über den Dateinamen laden, indem Sie die Methode IronPdfViewSource.FromFile in einer C# ContentPage verwenden:
:path=/static-assets/pdf/content-code-examples/tutorials/pdf-viewing-4.cs// We assume an IronPdfView instance is created previously called pdfView
pdfView.Source = IronPdfViewSource.FromFile("C:/path/to/my/example.pdf");Laden über Byte-Array
Für einige Anwendungsfälle kann es wünschenswert sein, ein Byte-Array einer PDF-Datei zu laden. Dies ist in XAML nicht möglich, aber in C# schon. Sie können dies einfach erreichen, indem Sie die Methode IronPdfViewSource.FromBytes verwenden. Ein Beispiel für die Anwendung dieser Methode wird im Folgenden gezeigt:
:path=/static-assets/pdf/content-code-examples/tutorials/pdf-viewing-5.cspdfView.Source = IronPdfViewSource.FromBytes(File.ReadAllBytes("~/Downloads/example.pdf"));Belastung durch Stream
Ebenso kann es in einigen Anwendungsfällen wünschenswert sein, dass PDF-Dateien über einen Stream geladen werden. Dies ist in XAML nicht möglich, aber in C# schon. Sie können dies einfach erreichen, indem Sie die Methode IronPdfViewSource.FromStream verwenden. Ein Beispiel für die Anwendung dieser Methode wird im Folgenden gezeigt:
:path=/static-assets/pdf/content-code-examples/tutorials/pdf-viewing-6.cspdfView.Source = IronPdfViewSource.FromStream(File.OpenRead("~/Downloads/example.pdf"));Konfigurieren Sie die Symbolleiste
Mit IronPDF Viewer können Sie wählen, welche Optionen in der Symbolleiste angezeigt werden sollen. Es stehen folgende Optionen zur Verfügung:
- Thumbnail-Ansicht
- Anzeige des Dateinamens
- Text-Suche
- Seitennummern-Navigation
- Vergrößern
- An die Breite anpassen
- Anpassung an die Höhe
- Drehen im Uhrzeigersinn
- Drehen gegen den Uhrzeigersinn
- Datei öffnen
- Datei herunterladen
- Datei drucken
- Anmerkungen anzeigen
Zweiseitige Ansicht
In der Standardeinstellung zeigt IronPDF Viewer die unten abgebildete Symbolleiste an:
In der Standardansicht sind die Optionen für die Anzeige von Dateinamen, die Textsuche und das Drehen gegen den Uhrzeigersinn deaktiviert. Um alles anzuzeigen, setzen Sie den
Option-Parameter desIronPdfView-Tags in XAML aufAll:
<?xml version="1.0" encoding="utf-8" ?>
<ContentPage ...
xmlns:ipv="clr-namespace:IronPdf.Viewer.Maui;assembly=IronPdf.Viewer.Maui"
...>
<ipv:IronPdfView x:Name="pdfView" Options="All"/>
</ContentPage>Alternativ können Sie dasselbe auch in C# erreichen:
:path=/static-assets/pdf/content-code-examples/tutorials/pdf-viewing-7.cspdfView.Options = IronPdfViewOptions.All;Daraufhin wird Folgendes angezeigt:
Wenn Sie nichts anzeigen möchten, setzen Sie die Option auf None. Die Symbolleiste wird nicht angezeigt, wenn Options folgendermaßen eingestellt sind:
Sie können wählen, welche spezifischen Optionen Sie anzeigen möchten. Zum Beispiel, wenn Sie nur die Miniaturansicht und die Dateiöffnungsoptionen anzeigen möchten, ändern Sie den Options-Parameter von IronPdfView in XAML wie folgt:
<ipv:IronPdfView x:Name="pdfView" Options="Thumbs, Open"/>Ähnliches gilt für C#:
:path=/static-assets/pdf/content-code-examples/tutorials/pdf-viewing-8.cspdfView.Options = IronPdfViewOptions.Thumbs | IronPdfViewOptions.Open;Daraufhin wird Folgendes angezeigt:
Schlussfolgerung
In diesem Tutorial haben wir gelernt, wie man IronPDF Viewer in eine MAUI-Anwendung integriert und wie man die Symbolleiste an die eigenen Bedürfnisse anpasst.
Dieser Viewer wird mit unserem Produkt IronPDF geliefert. Wenn Sie eine Funktionsanfrage stellen möchten oder allgemeine Fragen zu IronPDF Viewer (oder IronPDF) haben, wenden Sie sich bitte an unser Support-Team. Wir sind Ihnen gerne behilflich.
