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: PDFs in MAUI mit IronPDF anzeigen

Integrieren Sie IronPDF mühelos in Ihre MAUI-Anwendung und beginnen Sie, PDFs problemlos anzuzeigen. Dieses einfache Codebeispiel zeigt, wie man den IronPDF PdfViewer instanziiert und eine PDF-Datei zur sofortigen Anzeige lädt. Perfekt für Entwickler, die die PDF-Anzeige-Fähigkeiten ihrer App ohne Komplexität verbessern möchten.

Nuget IconGet started making PDFs with NuGet now:

  1. Install IronPDF with NuGet Package Manager

    PM > Install-Package IronPdf

  2. Copy and run this code snippet.

    new IronPdf.Viewer.Maui.PdfViewer { Source = "document.pdf" };
  3. Deploy to test on your live environment

    Start using IronPDF in your project today with a free trial
    arrow pointer
class="hsg-featured-snippet">

Minimaler Workflow (5 Schritte)

  1. Laden Sie die IronPDF Viewer-Bibliothek herunter und installieren Sie sie
  2. Integrieren Sie den IronPDF Viewer in eine MAUI-Anwendung
  3. Fügen Sie eine PDF-Anzeigeseite hinzu, indem Sie entweder eine XAML- oder C#-ContentPage hinzufügen
  4. Laden Sie eine PDF beim Start durch Dateinamen, Byte-Array und Stream
  5. Konfigurieren Sie die Werkzeugleiste


Laden und Installieren der IronPDF Viewer-Bibliothek

Nutzen Sie IronPDF heute kostenlos in Ihrem Projekt.

Erster Schritt:
green arrow pointer

Visual Studio - NuGet-Paketmanager

Klicken Sie in Visual Studio mit der rechten Maustaste auf Ihr Projekt im Lösungs-Explorer und wählen Sie NuGet-Pakete verwalten.... 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-Paketmanager-Konsole öffnen, indem Sie zu Tools > NuGet-Paket-Manager > Paketmanager-Konsole 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();
    }
}
Imports IronPdf.Viewer.Maui

Public Module MauiProgram
	Public Function CreateMauiApp() As MauiApp
		Dim builder = MauiApp.CreateBuilder()
		builder.UseMauiApp(Of App)().ConfigureIronPdfView() ' configure the viewer on app start-up

		Return builder.Build()
	End Function
End Module
$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 zu ConfigureIronPdfViewer wie folgt hinzu:

:path=/static-assets/pdf/content-code-examples/tutorials/pdf-viewing-2.cs
.ConfigureIronPdfView("YOUR-LICENSE-KEY");
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

Fügen Sie eine PDF-Viewer-Seite hinzu

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 zeigen, wie dies sowohl mit einer XAML- als auch mit einer C# ContentPage geschieht.

Schritte

  1. Fügen Sie Ihrem Projekt eine neue Seite hinzu, indem Sie mit der rechten Maustaste auf Ihr Projekt klicken und dann zu Hinzufügen > Neues Element... 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). Für eine C#-Datei wählen Sie .NET MAUI ContentPage (C#). Geben Sie Ihrer Datei den Namen PdfViewerPage, und klicken Sie dann auf Hinzufügen. .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

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.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;
    }
}
Imports IronPdf.Viewer.Maui

Public Class MainPage
	Inherits ContentPage

	Private ReadOnly pdfView As IronPdfView

	Public Sub New()
		InitializeComponent()

		Me.pdfView = New IronPdfView With {.Options = IronPdfViewOptions.All}

		Content = Me.pdfView
	End Sub
End Class
$vbLabelText   $csharpLabel
  1. Fügen Sie in Ihrer AppShell.xaml Datei 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 Sie Ihr Projekt, dann erstellen Sie und führen Sie es aus. 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 nach Dateiname zu laden, könnten Sie die Quelle der PDF-Datei im IronPdfView-Tag in der XAML-Datei angeben. Ein Beispiel dafür wird unten gezeigt:

: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 nach Dateiname 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");
' 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. Sie können dies einfach erreichen, indem Sie die Methode IronPdfViewSource.FromBytes verwenden. 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"));
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. Sie können dies einfach erreichen, indem Sie die Methode IronPdfViewSource.FromStream verwenden. 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"));
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-Werkzeugleiste

In der Standardansicht sind die Optionen für Dateiname, Textsuche und Gegen den Uhrzeigersinn rotieren alle deaktiviert. Um alles anzuzeigen, setzen Sie den Option-Parameter des IronPdfView-Tags in 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;
pdfView.Options = IronPdfViewOptions.All
$vbLabelText   $csharpLabel

Dies wird das Folgende anzeigen:

Alle Werkzeugleiste

Wenn Sie nichts anzeigen möchten, setzen Sie die Option auf None. Die Werkzeugleiste wird nicht angezeigt, wenn Options darauf gesetzt sind:

Keine Werkzeugleiste

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 Options-Parameter 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;
pdfView.Options = IronPdfViewOptions.Thumbs Or IronPdfViewOptions.Open
$vbLabelText   $csharpLabel

Dies wird das Folgende anzeigen:

Werkzeugleiste mit Miniaturansicht und Dateiauswahl

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 anzeigen?

Um PDFs in einer MAUI-Anwendung anzuzeigen, können Sie den IronPDF Viewer integrieren, indem Sie ihn über den NuGet-Paketmanager in Visual Studio installieren und den erforderlichen Code in Ihr Projekt einfügen.

Welche Schritte sind erforderlich, um einen PDF-Viewer in einer MAUI-App zu integrieren?

Stellen Sie sicher, dass Ihr MAUI-Projekt kompatibel ist, laden Sie die IronPDF Viewer-Bibliothek über NuGet herunter und initialisieren Sie den Viewer in Ihrer Datei _MauiProgram.cs_ mit Ihrem IronPDF-Lizenzschlüssel.

Wie lade ich eine PDF-Datei, wenn meine MAUI-Anwendung startet?

Sie können ein PDF beim Start laden, indem Sie die Quelle in der XAML-Datei festlegen oder Methoden wie IronPdfViewSource.FromFile, FromBytes oder FromStream in Ihrer C# ContentPage verwenden.

Wie kann ich die Toolbar im PDF-Viewer für MAUI anpassen?

Passen Sie die Toolbar an, indem Sie den 'Options'-Parameter in XAML oder C#-Code konfigurieren, um Funktionen wie Miniaturansicht, Textsuche, Zoom und mehr zu integrieren, oder setzen Sie ihn auf 'Alle' für vollständige Funktionalität.

Ist es möglich, die Toolbar im MAUI PDF Viewer zu verbergen?

Ja, indem Sie den 'Options'-Parameter auf 'Keine' setzen, können Sie die Toolbar verbergen und verhindern, dass sie Werkzeuge anzeigt.

Was sind einige häufige Schritte zur Fehlerbehebung für den PDF-Viewer in MAUI?

Stellen Sie sicher, dass der IronPDF Viewer ordnungsgemäß über NuGet installiert ist, überprüfen Sie die Kompatibilität Ihres Projekts und stellen Sie sicher, dass erforderlicher Code, wie etwa die Initialisierung des Lizenzschlüssels, korrekt in Ihren Projektdateien implementiert ist.

Kann ich den PDF-Viewer in MAUI-Apps verwenden, die auf iOS oder Android abzielen?

Der IronPDF Viewer unterstützt derzeit keine MAUI-Projekte, die auf iOS- oder Android-Plattformen abzielen. Stellen Sie sicher, dass Ihr Projekt auf kompatible Plattformen abzielt.

Wie kann ich Funktionsanfragen stellen oder Unterstützung für den PDF-Viewer erhalten?

Für Funktionsanfragen oder Unterstützung kontaktieren Sie das IronPDF-Supportteam über deren offizielle Website, um Unterstützung für den PDF-Viewer zu erhalten.

Ist IronPDF Viewer mit .NET 10 in MAUI-Projekten kompatibel?

Ja – IronPDF ist vollständig kompatibel mit .NET 10, genau wie mit früheren Versionen wie .NET 6, .NET 7 und .NET Core. Dies schließt die Verwendung von IronPDF in MAUI-Anwendungen ein, die auf .NET 10 abzielen, ohne dass spezielle Konfigurationen oder Workarounds erforderlich sind.

Jordi Bardia
Software Ingenieur
Jordi ist am besten in Python, C# und C++ versiert. Wenn er nicht bei Iron Software seine Fähigkeiten einsetzt, programmiert er Spiele. Mit Verantwortung für Produkttests, Produktentwicklung und -forschung trägt Jordi mit immensem Wert zur kontinuierlichen Produktverbesserung bei. Die abwechslungsreiche Erfahrung hält ihn gefordert und engagiert, ...
Weiterlesen
Bereit anzufangen?
Nuget Downloads 16,133,208 | Version: 2025.11 gerade veröffentlicht