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

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

en-tête:2(Démarrage rapide : Mise en œuvre du Visualiseur IronPDF 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.

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.

    var viewer = 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">

Workflow minimal (5 étapes)

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

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

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

Première étape :
green arrow pointer

Visual Studio - Gestionnaire de paquets NuGet

Dans Visual Studio, cliquez avec le bouton droit sur votre projet dans l'explorateur de solutions et sélectionnez Gérer les paquets NuGet.... 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 paquets NuGet en naviguant vers Outils > Gestionnaire de paquets NuGet > Console du gestionnaire de paquets et en entrant 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();
    }
}
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, 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 ainsi :

: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 visualisation de PDF

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

Étapes

  1. Ajoutez une nouvelle page à votre projet en cliquant avec le bouton droit sur votre projet, puis en naviguant vers Ajouter > Nouvel élément... 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 Ajouter. .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 indiqué ci-dessous, et en cliquant sur l'onglet "Visualiseur PDF", vous devriez ouvrir le Visualiseur IronPDF.

Visualiseur 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 nom de fichier, vous pouvez spécifier la source du fichier PDF dans la balise IronPdfView dans le fichier XAML. Un exemple de cela 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 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 réaliser cela en utilisant simplement 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"));
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 réaliser cela en utilisant simplement 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"));
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;
pdfView.Options = IronPdfViewOptions.All
$vbLabelText   $csharpLabel

Ce qui affichera ce qui suit :

Toutes les barres d'outils

Si vous ne voulez rien afficher, définissez l'option sur None. La barre d'outils n'apparaîtra pas si Options sont définies sur ceci :

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 vignettes et de fichier ouvert, 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 vignettes et options de fichier ouvert

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 16,154,058 | Version : 2025.11 vient de sortir