Viewing PDFs in MAUI for C# .NET

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

Bannière IronPDF Viewer

Dans l'ère moderne du développement multiplateforme, offrir aux utilisateurs la possibilité de visualiser des documents PDF directement dans votre application n'est pas seulement une commodité, mais une nécessité. Avec le IronPDF Viewer, vous pouvez intégrer la fonctionnalité de visualisation PDF dans votre application MAUI.

Dans cet article, nous apprendrons comment intégrer IronPDF Viewer dans une application MAUI pour permettre aux utilisateurs de visualiser, enregistrer et imprimer des PDF.

Démarrage rapide : Affichage de PDF dans MAUI avec IronPDF

Intégrez IronPDF dans votre application MAUI facilement et commencez à visualiser des PDF sans effort. Cet extrait de code simple montre comment instancier le IronPDF PdfViewer et charger un fichier PDF pour une visualisation immédiate. Parfait pour les développeurs cherchant à améliorer les capacités de visualisation de PDF de leur application sans complexité.

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">

Flux de travail minimal (5 étapes)

  1. Téléchargez et installez la bibliothèque IronPDF Viewer
  2. Intégrez IronPDF Viewer dans une application MAUI
  3. Ajoutez une page de visionneuse de PDF en ajoutant soit XAML soit C# ContentPage
  4. Chargez un PDF au démarrage par nom de fichier, tableau d'octets et flux
  5. Configurez la barre d'outils


Téléchargez et installez la bibliothèque IronPDF Viewer

Commencez à utiliser IronPDF dans votre projet aujourd'hui avec un essai gratuit.

Première étape :
green arrow pointer

Visual Studio - Gestionnaire de packages NuGet

Dans Visual Studio, faites un clic droit sur votre projet dans l'explorateur de solution et sélectionnez Manage NuGet Packages.... De là, vous pouvez rechercher IronPdf.Viewer.Maui et installer la dernière version dans votre solution. Alternativement, vous pouvez ouvrir la console du gestionnaire de packages NuGet en naviguant dans Tools > NuGet Package Manager > Package Manager Console et en entrant la commande suivante :

Install-Package IronPdf.Viewer.Maui

Intégrez IronPDF Viewer dans une application MAUI

Dans les sections suivantes, nous vous montrerons comment intégrer IronPDF Viewer dans une application MAUI par défaut.

Configuration

Avant d'ajouter IronPDF Viewer à votre projet MAUI, assurez-vous qu'il ne cible pas les plateformes iOS et Android. Vous pouvez vérifier cela en faisant un clic droit sur le fichier de projet et en sélectionnant Propriétés. Désélectionnez les cases à cocher Cibler la plateforme iOS et Cibler la plateforme Android si elles ne sont pas déjà décochées. Pour que ce changement soit appliqué avec succès, vous devrez peut-être enregistrer le projet après avoir décoché et redémarrer Visual Studio.

Écran des propriétés

Après avoir désélectionné les plateformes iOS et Android, allez dans votre fichier MauiProgram.cs et ajoutez le code suivant pour initialiser la visionneuse :

: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

Par défaut, IronPDF Viewer affichera une bannière dans le coin inférieur droit de la vue. Pour supprimer cette vue, ajoutez votre clé de licence IronPDF (ou Iron Suite) à ConfigureIronPdfViewer comme suit :

: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

Ajoutez une page de visionneuse PDF

Dans cette section, nous apprendrons comment créer une page de visionneuse PDF, intégrer IronPDF Viewer et créer un onglet pour cela dans une application MAUI. Nous montrerons comment faire cela à la fois avec un fichier XAML et C# ContentPage.

Étapes

  1. Ajoutez une nouvelle page à votre projet en faisant un clic droit sur votre projet, puis en naviguant vers Add > New Item... Ajouter un nouvel élément

  2. Naviguez vers la section .NET MAUI. Pour créer une page XAML, sélectionnez .NET MAUI ContentPage (XAML). Pour un fichier C#, sélectionnez .NET MAUI ContentPage (C#). Donnez à votre fichier le nom PdfViewerPage, puis cliquez sur Add. .NET MAUI `ContentPage`

  3. Dans le fichier XAML, ajoutez le code suivant et enregistrez :
: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

Si vous avez créé un ContentPage C# à la place, ajoutez le code suivant et enregistrez :

: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. Dans votre fichier AppShell.xaml, ajoutez ce qui suit :
: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. Enregistrez votre projet, puis construisez et exécutez. Vous devriez voir des onglets dans le coin supérieur gauche comme montré ci-dessous, et en cliquant sur l'onglet "PDF Viewer" devrait ouvrir le IronPDF Viewer.

IronPDF Viewer par défaut

Chargez un PDF au démarrage

Au démarrage de l'application, IronPDF Viewer invite l'utilisateur à ouvrir un PDF par défaut. Il est également possible d'ouvrir automatiquement un PDF au démarrage. Il existe trois façons de charger un PDF au démarrage : par un nom de fichier, à travers un tableau d'octets, et à travers un flux.

Charger par nom de fichier

Pour charger un PDF par nom de fichier, vous pouvez spécifier la source du fichier PDF dans la balise IronPdfView dans le fichier XAML. Un exemple de ceci est montré ci-dessous :

: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

Alternativement, vous pouvez charger le PDF par nom de fichier en utilisant la méthode IronPdfViewSource.FromFile dans un ContentPage C# :

: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

Charger à travers un tableau d'octets

Pour certains cas d'utilisation, il peut être souhaitable de charger un tableau d'octets d'un PDF. Cela n'est pas possible depuis XAML, mais est possible en C#. Vous pouvez réaliser cela en utilisant simplement la méthode IronPdfViewSource.FromBytes. Un exemple de comment utiliser cette méthode est montré ci-dessous :

: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

Charger à travers un flux

De même, il peut être plus souhaitable de charger les PDF à travers un flux dans certains cas d'utilisation. Cela n'est pas possible depuis XAML, mais est possible en C#. Vous pouvez réaliser cela en utilisant simplement la méthode IronPdfViewSource.FromStream. Un exemple de comment utiliser cette méthode est montré ci-dessous :

: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

Configurez la barre d'outils

Avec IronPDF Viewer, vous pouvez choisir quelles options afficher dans la barre d'outils. Les options disponibles sont :

  • Vue miniature
  • Affichage du nom de fichier
  • Recherche de texte
  • Navigation par numéro de page
  • Zoom
  • Adapter à la largeur
  • Adapter à la hauteur
  • Pivoter dans le sens des aiguilles d'une montre
  • Pivoter dans le sens inverse des aiguilles d'une montre
  • Ouvrir le fichier
  • Télécharger le fichier
  • Imprimer le fichier
  • Afficher les annotations
  • Vue à deux pages

Par défaut, IronPDF Viewer affichera la barre d'outils montrée ci-dessous :

Barre d'outils par défaut

Dans la vue par défaut, l'affichage du nom de fichier, la recherche de texte et les options de rotation dans le sens inverse des aiguilles d'une montre sont toutes désactivées. Pour tout afficher, définissez le paramètre Option de la balise IronPdfView dans le XAML sur 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

Alternativement, vous pourriez réaliser la même chose en C# :

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

Ce qui affichera ce qui suit :

Tous barre d'outils

Si vous ne voulez rien afficher, définissez l'option sur None. La barre d'outils ne s'affichera pas si Options sont définies ainsi :

Pas de barre d'outils

Vous pouvez choisir quelles options spécifiques vous souhaitez afficher. Par exemple, si vous souhaitez afficher uniquement les options de miniature et d'ouverture de fichier, modifiez le paramètre Options de IronPdfView dans le XAML comme suit :

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

De même, en 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

Ce qui affichera ce qui suit :

Barre d'outils avec options de miniature et d'ouverture de fichier

Conclusion

Dans ce tutoriel, nous avons appris à intégrer IronPDF Viewer dans une application MAUI et comment personnaliser sa barre d'outils pour répondre au mieux à vos besoins.

Cette visionneuse est fournie avec notre produit IronPDF. Si vous souhaitez faire une demande de fonctionnalité ou avez des questions générales sur IronPDF Viewer (ou IronPDF), veuillez contacter notre équipe de support. Nous serons plus qu'heureux de vous aider.

Questions Fréquemment Posées

Comment puis-je visualiser des PDF dans une application MAUI ?

Pour visualiser des PDF dans une application MAUI, vous pouvez intégrer IronPDF Viewer en l'installant depuis le gestionnaire de packages NuGet dans Visual Studio et en ajoutant le code requis à votre projet.

Quelles étapes sont nécessaires pour intégrer un visualiseur PDF dans une application MAUI ?

Assurez-vous que votre projet MAUI est compatible, téléchargez la bibliothèque IronPDF Viewer via NuGet, et initialisez le visualiseur dans votre fichier _MauiProgram.cs_ en utilisant votre clé de licence IronPDF.

Comment puis-je charger un fichier PDF lorsque mon application MAUI démarre ?

Vous pouvez charger un PDF au démarrage en définissant la source dans le fichier XAML ou en utilisant des méthodes comme IronPdfViewSource.FromFile, FromBytes, ou FromStream dans votre C# ContentPage.

Comment puis-je personnaliser la barre d'outils dans le visualiseur PDF pour MAUI ?

Personnalisez la barre d'outils en configurant le paramètre 'Options' dans le code XAML ou C# pour inclure des fonctionnalités comme la vue miniature, la recherche de texte, le zoom, et plus, ou réglez-le sur 'All' pour une fonctionnalité complète.

Est-il possible de masquer la barre d'outils dans le visualiseur PDF MAUI ?

Oui, en réglant le paramètre 'Options' sur 'None', vous pouvez masquer la barre d'outils et empêcher l'affichage de tout outil.

Quelles sont les étapes de dépannage courantes pour le visualiseur PDF dans MAUI ?

Assurez-vous que IronPDF Viewer est correctement installé via NuGet, vérifiez la compatibilité de votre projet et assurez-vous que tout code nécessaire, tel que l'initialisation de la clé de licence, est correctement implémenté dans vos fichiers de projet.

Puis-je utiliser le visualiseur PDF dans des applications MAUI ciblant iOS ou Android ?

Actuellement, IronPDF Viewer ne supporte pas les projets MAUI ciblant les plateformes iOS ou Android. Assurez-vous que votre projet cible des plateformes compatibles.

Comment puis-je faire des demandes de fonctionnalités ou obtenir du support pour le visualiseur PDF ?

Pour des demandes de fonctionnalités ou du support, contactez l'équipe de support IronPDF via leur site officiel pour obtenir de l'aide avec le visualiseur PDF.

IronPDF Viewer est-il compatible avec .NET 10 dans les projets MAUI ?

Oui, IronPDF est entièrement compatible avec .NET 10, tout comme avec les versions précédentes telles que .NET 6, .NET 7 et .NET Core. Vous pouvez donc utiliser IronPDF au sein d'applications MAUI ciblant .NET 10 sans configuration particulière ni solution de contournement.

Jordi Bardia
Ingénieur logiciel
Jordi est le plus compétent en Python, C# et C++, et lorsqu'il ne met pas à profit ses compétences chez Iron Software, il programme des jeux. Partageant les responsabilités des tests de produit, du développement de produit et de la recherche, Jordi apporte une immense valeur à l'amé...
Lire la suite
Prêt à commencer?
Nuget Téléchargements 16,133,208 | Version : 2025.11 vient de sortir