Viewing PDFs in MAUI for C# .NET

This article was translated from English: Does it need improvement?
Translated
View the article in English

 IronPDF Viewer Banner

In der modernen Ära der plattformübergreifenden Entwicklung ist es nicht nur eine Annehmlichkeit, sondern eine Notwendigkeit, den Benutzern die Möglichkeit zu bieten, PDF-Dokumente direkt innerhalb Ihrer App anzusehen. Mit dem IronPDF Viewer können Sie die PDF-Anzeigefunktionalität in Ihre MAUI-Anwendung einbetten.

In diesem Artikel lernen wir, wie man den IronPDF Viewer in eine MAUI-Anwendung integriert, um Benutzern die Möglichkeit zu geben, PDFs anzusehen, zu speichern und zu drucken.

Schnellstart: Implementierung des IronPDF Viewers in MAUI

Beginnen Sie mit der Integration des IronPDF Viewers in Ihre MAUI-Anwendung mit nur wenigen Codezeilen. Dieses schnelle Handbuch zeigt, wie man mühelos eine PDF-Datei mit der leistungsstarken Bibliothek von IronPDF lädt. Ideal für Entwickler, die ihre Apps mit nahtlosen PDF-Anzeigefunktionen verbessern möchten, hebt dieser Ansatz Benutzerfreundlichkeit und schnelle Implementierung hervor. Initialisieren Sie einfach den IronPDF Viewer und laden Sie Ihre PDF, um eine bequeme PDF-Anzeige in Ihrer App zu ermöglichen.

  1. Installieren Sie IronPDF mit NuGet Package Manager

    PM > Install-Package IronPdf
  2. Kopieren Sie diesen Codeausschnitt und führen Sie ihn aus.

    var viewer = new IronPdf.Viewer.Maui.PdfViewer { Source = "document.pdf" };
  3. Bereitstellen zum Testen in Ihrer Live-Umgebung

    Beginnen Sie noch heute, IronPDF in Ihrem Projekt zu verwenden, mit einer kostenlosen Testversion

    arrow pointer

Visual Studio - NuGet Paket Manager

Klicken Sie in Visual Studio mit der rechten Maustaste auf Ihr Projekt im Projektmappen-Explorer und wählen Sie Manage NuGet Packages... aus. Von dort aus 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 Package Manager > Package Manager Console navigieren und den folgenden Befehl eingeben:

Install-Package IronPdf.Viewer.Maui

Integrieren Sie den IronPDF Viewer in eine MAUI-Anwendung

In den folgenden Abschnitten zeigen wir, wie der IronPDF Viewer in eine Standard-MAUI-Anwendung integriert wird.

Setup

Bevor Sie den IronPDF Viewer zu Ihrem MAUI-Projekt hinzufügen, stellen Sie sicher, dass es nicht auf die iOS- und Android-Plattformen abzielt. Sie können dies überprüfen, indem Sie mit der rechten Maustaste auf die Projektdatei klicken und Eigenschaften auswählen. Deaktivieren Sie die Kontrollkästchen Zielplattform iOS und Zielplattform Android, falls sie nicht bereits deaktiviert sind. Um diese Änderung erfolgreich zu übernehmen, müssen Sie das Projekt nach dem Deaktivieren speichern und Visual Studio neu starten.

Eigenschaften-Bildschirm

Nachdem Sie die iOS- und Android-Plattformen nicht mehr gezielt anvisieren, gehen Sie zu Ihrer MauiProgram.cs-Datei und fügen Sie den folgenden Code hinzu, um den Viewer zu initialisieren:

:path=/static-assets/pdf/content-code-examples/tutorials/pdf-viewing-1.cs
using 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();
    }
}
$vbLabelText   $csharpLabel

Standardmäßig zeigt der IronPDF Viewer ein Banner in der unteren rechten Ecke der Ansicht an. Um diese Ansicht zu entfernen, fügen Sie Ihren IronPDF (oder Iron Suite)Lizenzschlüssel wie folgt zu ConfigureIronPdfViewer hinzu:

:path=/static-assets/pdf/content-code-examples/tutorials/pdf-viewing-2.cs
.ConfigureIronPdfView("YOUR-LICENSE-KEY");
$vbLabelText   $csharpLabel

PDF-Viewer-Seite hinzufügen

In diesem Abschnitt lernen wir, wie man eine PDF-Viewer-Seite erstellt, den IronPDF Viewer integriert und einen Tab dafür in einer MAUI-Anwendung erstellt. Wir werden Ihnen zeigen, wie das mit XAML und C# funktioniert. ContentPage.

Schritte

  1. Fügen Sie Ihrem Projekt eine neue Seite hinzu, indem Sie mit der rechten Maustaste auf Ihr Projekt klicken und dann zu Add > New Item... navigieren. Neues Element hinzufügen

  2. Navigieren Sie zum Abschnitt .NET MAUI. Um eine XAML-Seite zu erstellen, wählen Sie .NET MAUI ContentPage (XAML). Wählen Sie für eine C#-Datei .NET MAUI ContentPage (C#). Geben Sie Ihrer Datei den Namen PdfViewerPage und klicken Sie dann auf Add.  .NET MAUI `ContentPage`

  3. Fügen Sie in der XAML-Datei den folgenden Code hinzu und speichern Sie:
:path=/static-assets/pdf/tutorials/pdf-viewing/pdf-viewing-xaml-1.xml
<?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>
XML

Falls Sie stattdessen einen C#-Code ContentPage erstellt haben, fügen Sie stattdessen den folgenden Code ein und speichern Sie:

:path=/static-assets/pdf/content-code-examples/tutorials/pdf-viewing-3.cs
using IronPdf.Viewer.Maui;

public class MainPage : ContentPage
{
    private readonly IronPdfView pdfView;

    public MainPage()
    {
        InitializeComponent();

        this.pdfView = new IronPdfView { Options = IronPdfViewOptions.All };

        Content = this.pdfView;
    }
}
$vbLabelText   $csharpLabel
  1. Fügen Sie in AppShell.xaml Folgendes hinzu:
:path=/static-assets/pdf/tutorials/pdf-viewing/pdf-viewing-xaml-2.xml
<?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>
XML
  1. Speichern, erstellen und ausführen. Sie sollten oben links wie unten gezeigt Tabs sehen, und das Klicken auf den "PDF Viewer"-Tab sollte den IronPDF Viewer öffnen.

 IronPDF Viewer Standard

Laden einer PDF beim Start

Beim Start der Anwendung wird der IronPDF Viewer den Benutzer standardmäßig dazu auffordern, eine PDF zu öffnen. Es ist auch möglich, dass beim Start eine PDF automatisch geöffnet wird. Es gibt drei Möglichkeiten, wie Sie beim Start eine PDF laden können: durch einen Dateinamen, über ein Byte-Array und über einen Stream.

Laden nach Dateiname

Um eine PDF-Datei anhand ihres Dateinamens zu laden, können Sie die Quelle der PDF-Datei im IronPdfView-Tag in der XAML-Datei angeben. Ein Beispiel hierfür ist unten dargestellt:

:path=/static-assets/pdf/tutorials/pdf-viewing/pdf-viewing-xaml-3.xml
<?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>
XML

Alternativ können Sie die PDF-Datei über den Dateinamen laden, indem Sie die Methode IronPdfViewSource.FromFile in C# verwenden ContentPage:

: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");
$vbLabelText   $csharpLabel

Laden durch Byte-Array

Für einige Anwendungsfälle kann es wünschenswert sein, ein Byte-Array einer PDF zu laden. Dies ist von XAML aus nicht möglich, aber in C# möglich. Dies erreichen Sie ganz einfach mit der Methode IronPdfViewSource.FromBytes. Ein Beispiel, wie man diese Methode verwendet, wird unten gezeigt:

:path=/static-assets/pdf/content-code-examples/tutorials/pdf-viewing-5.cs
pdfView.Source = IronPdfViewSource.FromBytes(File.ReadAllBytes("~/Downloads/example.pdf"));
$vbLabelText   $csharpLabel

Laden durch Stream

Ebenso kann es in einigen Anwendungsfällen wünschenswerter sein, PDFs durch einen Stream zu laden. Dies ist von XAML aus nicht möglich, aber in C# möglich. Dies erreichen Sie ganz einfach mit der Methode IronPdfViewSource.FromStream. Ein Beispiel, wie man diese Methode verwendet, wird unten gezeigt:

:path=/static-assets/pdf/content-code-examples/tutorials/pdf-viewing-6.cs
pdfView.Source = IronPdfViewSource.FromStream(File.OpenRead("~/Downloads/example.pdf"));
$vbLabelText   $csharpLabel

Konfigurieren der Werkzeugleiste

Mit dem IronPDF Viewer können Sie wählen, welche Optionen in der Werkzeugleiste angezeigt werden sollen. Die verfügbaren Optionen sind:

  • Miniaturansicht
  • Dateiname anzeigen
  • Textsuche
  • Seitennummernavigation
  • Zoom
  • An Breite anpassen
  • An Höhe anpassen
  • Uhrzeigersinn rotieren
  • Gegen den Uhrzeigersinn rotieren
  • Datei öffnen
  • Datei herunterladen
  • Datei drucken
  • Anmerkungen anzeigen
  • Zwei-Seiten-Ansicht

Standardmäßig wird die unten gezeigte Werkzeugleiste des IronPDF Viewers angezeigt:

Standard-Symbolleiste

In der Standardansicht sind die Optionen für Dateiname, Textsuche und Gegen den Uhrzeigersinn rotieren alle deaktiviert. Um alles anzuzeigen, setzen Sie den Parameter Option des Tags IronPdfView im XAML auf All:

:path=/static-assets/pdf/tutorials/pdf-viewing/pdf-viewing-xaml-4.xml
<?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>
XML

Alternativ könnten Sie dasselbe in C# erreichen:

:path=/static-assets/pdf/content-code-examples/tutorials/pdf-viewing-7.cs
pdfView.Options = IronPdfViewOptions.All;
$vbLabelText   $csharpLabel

Dies wird das Folgende anzeigen:

Alle Symbolleisten

Wenn Sie nichts anzeigen möchten, stellen Sie die Option auf None ein. Die Symbolleiste wird nicht angezeigt, wenn Options auf diesen Wert eingestellt ist:

Keine Symbolleiste

Sie können auswählen, welche spezifischen Optionen Sie anzeigen möchten. Wenn Sie beispielsweise nur die Miniaturansicht und die Optionen zum Öffnen von Dateien anzeigen möchten, ändern Sie den Parameter Options von IronPdfView in XAML wie folgt:

:path=/static-assets/pdf/tutorials/pdf-viewing/pdf-viewing-xaml-5.xml
<ipv:IronPdfView x:Name="pdfView" Options="Thumbs, Open"/>
XML

Ebenso in C#:

:path=/static-assets/pdf/content-code-examples/tutorials/pdf-viewing-8.cs
pdfView.Options = IronPdfViewOptions.Thumbs | IronPdfViewOptions.Open;
$vbLabelText   $csharpLabel

Abschluss

In diesem Tutorial haben wir gelernt, wie man den IronPDF Viewer in eine MAUI-Anwendung integriert und seine Werkzeugleiste anpasst, um Ihre Bedürfnisse am besten zu erfüllen.

Dieser Viewer kommt mit unserem IronPDF-Produkt. Wenn Sie einen Funktionswunsch haben oder allgemeine Fragen zum IronPDF Viewer (oder IronPDF) haben, bitte kontaktieren Sie unser Support-Team. Wir helfen Ihnen gerne weiter.

Häufig gestellte Fragen

Wie kann ich PDFs in einer MAUI-Anwendung mit C# anzeigen?

Um PDFs in einer MAUI-Anwendung mit C# anzuzeigen, können Sie die IronPDF Viewer-Bibliothek integrieren. Dies beinhaltet die Installation der Bibliothek über NuGet in Visual Studio und die Konfiguration innerhalb Ihres Projekts, um PDF-Anzeigefunktionen zu ermöglichen.

Wie ist der Prozess zur Integration eines PDF-Viewers in einer MAUI-App?

Die Integration eines PDF-Viewers in einer MAUI-App erfordert die Installation der IronPDF Viewer-Bibliothek mit dem NuGet-Paketmanager und das Einrichten des Viewers in Ihrem Projekt mithilfe von MauiProgram.cs und XAML oder C# ContentPage zur Anzeige von PDFs.

Kann der IronPDF Viewer auf iOS- und Android-Plattformen in einem MAUI-Projekt verwendet werden?

Derzeit ist der IronPDF Viewer für MAUI-Projekte vorgesehen, die nicht auf iOS- und Android-Plattformen abzielen. Er wird am besten in Projekten verwendet, die auf Desktop-Umgebungen abzielen.

Wie lade ich eine PDF-Datei beim Start der Anwendung in meinem MAUI-Projekt?

Sie können eine PDF-Datei beim Start laden, indem Sie die IronPDF Viewer-Methoden wie IronPDFViewSource.FromFile, FromBytes oder FromStream in Ihrer MAUI-Anwendung verwenden.

Was sind die Konfigurationsoptionen für die Toolbar des IronPDF Viewers?

Die IronPDF Viewer-Toolbar kann angepasst werden, um Optionen wie Miniaturansicht, Textsuche, Seitennavigation, Zoom, Rotation und Dateioperationen einzuschließen. Sie können sie so einstellen, dass alle, keine oder nur bestimmte Werkzeuge basierend auf Ihren Anforderungen angezeigt werden.

Wie kann ich die Toolbar des PDF-Viewers anpassen, um bestimmte Werkzeuge anzuzeigen?

Um die Toolbar anzupassen, um bestimmte Werkzeuge anzuzeigen, passen Sie den 'Options'-Parameter in Ihrem XAML- oder C#-Code an, um nur die gewünschten Optionen wie 'ThumbnailView,OpenFile' einzuschließen.

Ist es möglich, die Toolbar im IronPDF Viewer auszublenden?

Ja, Sie können die Toolbar ausblenden, indem Sie den 'Options'-Parameter auf 'None' setzen, wodurch die Toolbar aus der Benutzeroberfläche des Viewers entfernt wird.

Wie kann ich Probleme mit der PDF-Darstellung in einer MAUI-Anwendung angehen?

Wenn Sie Probleme mit der PDF-Darstellung in einer MAUI-Anwendung haben, stellen Sie sicher, dass die IronPDF-Bibliothek ordnungsgemäß installiert und konfiguriert ist. Überprüfen Sie außerdem auf plattformspezifische Einschränkungen oder holen Sie Unterstützung beim technischen Team von IronPDF.

Wo kann ich Unterstützung für die Integration von IronPDF Viewer in MAUI-Anwendungen finden?

Sie können sich über die offizielle Website des IronPDF-Teams an das Support-Team wenden, um Unterstützung oder Funktionsanfragen zur Integration von IronPDF Viewer in MAUI-Anwendungen zu erhalten.

Ist IronPDF Viewer vollständig mit .NET 10-Projekten kompatibel?

Ja. IronPDF unterstützt .NET 10 in allen seinen Hauptproduktlinien, einschließlich der Viewer-Komponente für MAUI-Anwendungen. Das IronPDF Viewer-Paket ist mit Zielframeworks wie net10.0-windows und net10.0-maccatalyst kompatibel und ermöglicht Entwicklern so die Integration von PDF-Anzeigefunktionen in .NET 10-Desktop-Projekte ohne zusätzliche Umwege.

Curtis Chau
Technischer Autor

Curtis Chau hat einen Bachelor-Abschluss in Informatik von der Carleton University und ist spezialisiert auf Frontend-Entwicklung mit Expertise in Node.js, TypeScript, JavaScript und React. Leidenschaftlich widmet er sich der Erstellung intuitiver und ästhetisch ansprechender Benutzerschnittstellen und arbeitet gerne mit modernen Frameworks sowie der Erstellung gut strukturierter, optisch ansprechender ...

Weiterlesen
Bereit anzufangen?
Nuget Downloads 17,803,474 | Version: 2026.3 gerade veröffentlicht
Still Scrolling Icon

Scrollst du immer noch?

Sie brauchen schnell einen Beweis? PM > Install-Package IronPdf
Führen Sie eine Probe aus Sehen Sie zu, wie Ihr HTML-Code in eine PDF-Datei umgewandelt wird.