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

À l'ère moderne du développement multiplateforme, fournir 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 Visualiseur IronPDF, vous pouvez intégrer des fonctionnalités de visualisation de PDF dans votre application MAUI.

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

Démarrage rapide : Implémentation IronPDF Viewer dans MAUI

Commencez à intégrer le Visualiseur IronPDF dans votre application MAUI avec seulement quelques lignes de code. Ce guide rapide démontre comment charger sans effort un fichier PDF en utilisant la puissante bibliothèque d'IronPDF. Idéal pour les développeurs désireux d'améliorer leurs applications avec des capacités de visualisation de PDF fluides, cette approche met en avant la facilité d'utilisation et la mise en œuvre rapide. Il vous suffit de télécharger le Visualiseur IronPDF et de charger votre PDF pour permettre une visualisation pratique des PDF dans votre application.

  1. Installez IronPDF avec le Gestionnaire de Packages NuGet

    PM > Install-Package IronPdf
  2. Copiez et exécutez cet extrait de code.

    var viewer = new IronPdf.Viewer.Maui.PdfViewer { Source = "document.pdf" };
  3. Déployez pour tester sur votre environnement de production.

    Commencez à utiliser IronPDF dans votre projet dès aujourd'hui avec un essai gratuit

    arrow pointer

Visual Studio - Gestionnaire de packages NuGet

Dans Visual Studio, cliquez avec le bouton droit sur votre projet dans l'explorateur de solutions et sélectionnez Manage NuGet Packages.... De là, vous pouvez rechercher IronPdf.Viewer.Maui et installer la dernière version dans votre solution. Vous pouvez également ouvrir la console du gestionnaire de packages NuGet en accédant à Tools > NuGet Package Manager > Package Manager Console et en saisissant la commande suivante :

Install-Package IronPdf.Viewer.Maui

Intégrez le Visualiseur IronPDF dans une application MAUI

Dans les sections suivantes, nous allons démontrer comment intégrer le Visualiseur IronPDF dans une application MAUI par défaut.

Configuration

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

Écran des propriétés

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

: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

Par défaut, le Visualiseur IronPDF affichera une bannière en bas à droite de la vue. Pour supprimer cette vue, ajoutez votre clé de licence IronPDF (ou Iron Suite) à ConfigureIronPdfViewer comme ceci :

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

Ajoutez une page de visualisation de PDF

Dans cette section, nous allons apprendre comment créer une page de visualisation PDF, intégrer IronPDF Viewer et créer un onglet pour cela dans une application MAUI. Nous allons vous montrer comment faire cela avec XAML et C# ContentPage.

Étapes

  1. Ajoutez une nouvelle page à votre projet en cliquant avec le bouton droit sur votre projet, puis accédez à Add > New Item... Ajouter un nouvel élément

  2. Accédez à 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 fichier C# ContentPage à la place, ajoutez plutôt 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;
    }
}
$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 indiqué ci-dessous, et en cliquant sur l'onglet "Visualiseur PDF", vous devriez ouvrir le Visualiseur IronPDF.

 Visionneuse IronPDF par défaut

Chargez un PDF au démarrage

Au démarrage de l'application, le Visualiseur IronPDF invitera par défaut l'utilisateur à ouvrir un PDF. Il est également possible d'ouvrir un PDF automatiquement au démarrage. Il y a trois façons de charger un PDF au démarrage : par un nom de fichier, via un tableau d'octets et via un flux.

Charger par nom de fichier

Pour charger un PDF par son nom, vous pouvez spécifier la source du fichier PDF dans la balise IronPdfView du fichier XAML. Un exemple est présenté 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

Vous pouvez également charger le PDF par nom de fichier en utilisant la méthode IronPdfViewSource.FromFile dans un programme C# 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

Charger par 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 à partir de XAML, mais est possible en C#. Vous pouvez y parvenir simplement en utilisant la méthode IronPdfViewSource.FromBytes. Un exemple de l'utilisation de 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"));
$vbLabelText   $csharpLabel

Charger par flux

De même, il peut être plus souhaitable pour les PDF d'être chargés via un flux dans certains cas d'utilisation. Cela n'est pas possible à partir de XAML, mais est possible en C#. Vous pouvez y parvenir simplement en utilisant la méthode IronPdfViewSource.FromStream. Un exemple de l'utilisation de 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"));
$vbLabelText   $csharpLabel

Configurez la barre d'outils

Avec le Visualiseur IronPDF, 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
  • Ajuster à la largeur
  • Ajuster à la hauteur
  • Tourner dans le sens des aiguilles d'une montre
  • Tourner dans le sens inverse des aiguilles d'une montre
  • Ouvrir un fichier
  • Télécharger un fichier
  • Imprimer un fichier
  • Afficher les annotations
  • Vue sur deux pages

Par défaut, le Visualiseur IronPDF affichera la barre d'outils affiché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 pouvez obtenir le même résultat en C# :

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

Ce qui affichera ce qui suit :

Toute la barre d'outils

Si vous ne souhaitez rien afficher, définissez l'option sur None. La barre d'outils n'apparaîtra pas si Options sont définis sur cette valeur :

Pas de barre d'outils

Vous pouvez choisir quelles options spécifiques vous souhaitez afficher. Par exemple, si vous souhaitez afficher uniquement la miniature et les options 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;
$vbLabelText   $csharpLabel

Conclusion

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

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

Questions Fréquemment Posées

Comment puis-je afficher des fichiers PDF dans une application MAUI en utilisant C# ?

Pour afficher des fichiers PDF dans une application MAUI en utilisant C#, vous pouvez intégrer la bibliothèque IronPDF Viewer. Cela implique d'installer la bibliothèque via NuGet dans Visual Studio et de la configurer dans votre projet pour activer les fonctionnalités de visualisation des PDF.

Quel est le processus pour intégrer un visualiseur PDF dans une application MAUI ?

Intégrer un visualiseur PDF dans une application MAUI nécessite l'installation de la bibliothèque IronPDF Viewer en utilisant le gestionnaire de packages NuGet et la configuration du visualiseur dans votre projet en utilisant MauiProgram.cs et XAML ou une ContentPage C# pour l'affichage des PDF.

Le IronPDF Viewer peut-il être utilisé sur les plateformes iOS et Android dans un projet MAUI ?

Actuellement, le IronPDF Viewer est conçu pour les projets MAUI qui ne ciblent pas les plateformes iOS et Android. Il est préféré pour les projets ciblant les environnements de bureau.

Comment charger un fichier PDF au démarrage de l'application dans mon projet MAUI ?

Vous pouvez charger un fichier PDF au démarrage en utilisant les méthodes IronPDF Viewer telles que IronPDFViewSource.FromFile, FromBytes, ou FromStream dans votre application MAUI.

Quelles sont les options de configuration de la barre d'outils pour IronPDF Viewer ?

La barre d'outils IronPDF Viewer peut être personnalisée pour inclure des options telles que la vue en miniature, la recherche de texte, la navigation de page, le zoom, la rotation et les opérations sur les fichiers. Vous pouvez la configurer pour afficher toutes les options, aucune ou seulement certains outils, selon vos besoins.

Comment puis-je personnaliser la barre d'outils du visualiseur PDF pour afficher des outils spécifiques ?

Pour personnaliser la barre d'outils pour afficher des outils spécifiques, ajustez le paramètre 'Options' dans votre code XAML ou C# pour inclure uniquement les options souhaitées, telles que 'ThumbnailView,OpenFile'.

Est-il possible de masquer la barre d'outils dans IronPDF Viewer ?

Oui, vous pouvez masquer la barre d'outils en définissant le paramètre 'Options' sur 'None', ce qui supprimera la barre d'outils de l'interface du visualiseur.

Comment puis-je résoudre les problèmes de rendu PDF dans une application MAUI ?

Si vous rencontrez des problèmes de rendu PDF dans une application MAUI, assurez-vous que la bibliothèque IronPDF est correctement installée et configurée. Vérifiez également les limitations spécifiques à la plateforme ou demandez de l'aide à l'équipe technique d'IronPDF.

Où puis-je trouver de l'aide pour intégrer IronPDF Viewer dans des applications MAUI ?

Vous pouvez contacter l'équipe support d'IronPDF via leur site officiel pour toute assistance ou demande de fonctionnalité relative à l'intégration d'IronPDF Viewer dans des applications MAUI.

IronPDF Viewer est-il entièrement compatible avec les projets .NET 10 ?

Oui. IronPDF prend en charge .NET 10 sur l'ensemble de ses principales gammes de produits, y compris le composant Viewer pour les applications MAUI. Le package IronPDF Viewer est compatible avec les frameworks cibles tels que net10.0-windows et net10.0-maccatalyst, permettant ainsi aux développeurs d'intégrer la fonctionnalité de visualisation de PDF dans les projets de bureau .NET 10 sans avoir recours à des solutions de contournement.

Curtis Chau
Rédacteur technique

Curtis Chau détient un baccalauréat en informatique (Université de Carleton) et se spécialise dans le développement front-end avec expertise en Node.js, TypeScript, JavaScript et React. Passionné par la création d'interfaces utilisateur intuitives et esthétiquement plaisantes, Curtis aime travailler avec des frameworks modernes ...

Lire la suite
Prêt à commencer?
Nuget Téléchargements 17,803,474 | Version : 2026.3 vient de sortir
Still Scrolling Icon

Vous faites encore défiler ?

Vous voulez une preuve rapidement ? PM > Install-Package IronPdf
exécuter un échantillon Regardez votre code HTML se transformer en PDF.