Anzeigen von PDFs in MAUI für 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 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-Anzeigefunktionen in Ihre MAUI-Anwendung einbetten.

In diesem Artikel erfahren Sie, wie Sie den IronPDF Viewer in eine MAUI-Anwendung integrieren können, um Benutzern die Möglichkeit zu geben, PDFs anzusehen, zu speichern und zu drucken.


Übersicht


Herunterladen und Installieren der IronPDF Viewer Library

Visual Studio - NuGet-Paketverwaltung

Klicken Sie in Visual Studio mit der rechten Maustaste auf den Projektlösungsexplorer 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 dazu können Sie die NuGet Package Manager-Konsole öffnen, indem Sie zu "Tools > NuGet Packet Manager > Package Manager Console" navigieren und den folgenden Befehl eingeben:

Install-Package IronPdf.Viewer.Maui
C# NuGet Bibliothek foder PDF

Installieren mit NuGet

Installations-Paket IronPDF.Viewer.Maui
oder
C# PDF DLL

Herunterladen DLL

Herunterladen DLL

Manuelle Installation in Ihr Projekt

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 wählen. Deaktivieren Sie die unterstrichenen Kontrollkästchen Zielsetzung der iOS-Plattform und Zielsetzung der Android-Plattform in der Abbildung unten, 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.

Bildschirm Eigenschaften

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.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
VB   C#

Standardmäßig zeigt der IronPDF Viewer ein Banner unten rechts in der Ansicht an. Um diese Ansicht zu entfernen, fügen Sie Ihr IronPDF(oder Iron Suite) lizenzschlüssel zu ConfigureIronPdfView wie folgt:

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

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 zeigen Ihnen, wie Sie dies mit einer XAML- und einer C#-Inhaltsseite erreichen können.

Schritte

  1. 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

    Neuen Artikel 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 auf "Hinzufügen".

    .NET MAUI `ContentPage`

  3. 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>
XML

Wenn Sie stattdessen eine C# 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;
    }
}
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
VB   C#
  1. 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>
XML
  1. 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.

    IronPDF Viewer Standard

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 nach Dateinamen 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:

<?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 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")
VB   C#

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 erreichen, indem Sie einfach 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.cs
pdfView.Source = IronPdfViewSource.FromBytes(File.ReadAllBytes("~/Downloads/example.pdf"));
pdfView.Source = IronPdfViewSource.FromBytes(File.ReadAllBytes("~/Downloads/example.pdf"))
VB   C#

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 erreichen, indem Sie einfach 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.cs
pdfView.Source = IronPdfViewSource.FromStream(File.OpenRead("~/Downloads/example.pdf"));
pdfView.Source = IronPdfViewSource.FromStream(File.OpenRead("~/Downloads/example.pdf"))
VB   C#

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:

    Standard-Symbolleiste

    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 Parameter Option des IronPdfView-Tags in der XAML auf All:

<?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önnen Sie dasselbe auch in C# erreichen:

:path=/static-assets/pdf/content-code-examples/tutorials/pdf-viewing-7.cs
pdfView.Options = IronPdfViewOptions.All;
pdfView.Options = IronPdfViewOptions.All
VB   C#

Daraufhin wird Folgendes angezeigt:

Alle Symbolleiste

Wenn Sie nichts anzeigen lassen wollen, setzen Sie die Option auf None. Die Symbolleiste wird nicht angezeigt, wenn "Optionen" auf diesen Wert eingestellt sind:

Keine Symbolleiste

Sie können wählen, welche spezifischen Optionen Sie anzeigen möchten. Wenn Sie z. B. nur die Optionen "Miniaturansicht" und "Datei öffnen" anzeigen möchten, ändern Sie den Parameter "Optionen" von "IronPdfView" in XAML wie folgt:

<ipv:IronPdfView x:Name="pdfView" Options="Thumbs, Open"/>
XML

Ähnliches gilt für 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
VB   C#

Daraufhin wird Folgendes angezeigt:

Symbolleiste mit Miniaturansicht und Optionen zum Öffnen von Dateien

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 haben(oder IronPDF)bittekontakt zu unserem Support-Team. Wir sind Ihnen gerne behilflich.