Voir les PDF dans MAUI pour C# ; .NET

Cette section explique comment créer une page de visualisation de PDF, intégrer IronPDF Viewer et créer un onglet à cet effet dans une application MAUI. Nous en faisons la démonstration à l'aide d'une ContentPage XAML et C#. Choisissez l'approche qui correspond le mieux à votre style de développement et aux exigences de votre projet.

Quelles sont les étapes pour ajouter une page de visualisation?

1. Ajoutez une nouvelle page à votre projet en cliquant avec le bouton droit de la souris sur votre projet, puis en naviguant vers Ajouter > Nouvel élément... Menu Add de Visual Studio affichant New Item, références et composants de projet pour le développement d'applications MAUI

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.
   Dans la boîte de dialogue Ajout d'un nouvel élément de Visual Studio, la page de contenu .NET MAUI (C#) est sélectionnée et le nom de fichier PdfViewerPage.cs est saisi

3. Dans le fichier XAML, ajoutez le code suivant et enregistrez :

<?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 version="1.0" encoding="utf-8" ?>
<ContentPage ...
    xmlns:ipv="clr-namespace:IronPdf.Viewer.Maui;assembly=IronPdf.Viewer.Maui"
    ...>
    <ipv:IronPdfView x:Name="pdfView"/>
</ContentPage>

Si vous avez plutôt créé une ContentPage en C#, 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

4. Dans votre fichier AppShell.xaml, ajoutez les éléments suivants pour créer des onglets de navigation :

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

5. Enregistrez votre projet, puis construisez et exécutez. Vous devriez voir des onglets dans le coin supérieur gauche, comme indiqué ci-dessous. En cliquant sur l'onglet "PDF Viewer", la visionneuse IronPDF s'ouvre. La visionneuse offre une interface riche en fonctionnalités pour l'interaction avec les documents PDF.

Interface par défaut d'IronPDF Viewer avec un thème sombre montrant la zone de téléchargement des fichiers et le bouton Parcourir les fichiers

Au démarrage de l'application, IronPDF Viewer invite l'utilisateur à ouvrir un PDF par défaut. Toutefois, elle peut ouvrir un PDF automatiquement au démarrage, ce qui améliore l'expérience de l'utilisateur pour les applications qui ont besoin d'afficher immédiatement des documents spécifiques. Vous pouvez charger un PDF au démarrage de trois manières : par nom de fichier, via un tableau d'octets et via un flux. Chaque méthode offre des avantages différents en fonction de votre source de données et de l'architecture de votre application.

Comment charger par nom de fichier?

Pour charger un PDF par nom de fichier, spécifiez la source du fichier PDF dans la balise IronPdfView du fichier XAML. Il s'agit de l'approche la plus simple lorsque vous travaillez avec des fichiers locaux :

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

Vous pouvez également charger le PDF par nom de fichier de manière programmatique à l'aide de la méthode IronPdfViewSource.FromFile dans une ContentPage C#. Cette approche offre une plus grande flexibilité pour le chargement dynamique des fichiers :

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

Comment charger un tableau d'octets?

Lorsque vous travaillez avec des PDF stockés dans des bases de données ou reçus de services web, vous pouvez avoir besoin de charger un tableau d'octets d'un PDF. Cela n'est pas possible à partir de XAML, mais vous pouvez y parvenir en C# à l'aide de la méthode IronPdfViewSource.FromBytes :

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

Cette méthode est utile lors de l'intégration avec des systèmes de gestion de documents ou lorsque les PDF sont générés dynamiquement à l'aide des fonctionnalités HTML to PDF d'IronPdf.

Comment charger un flux ?

Pour les PDF chargés via un flux, notamment lorsque vous travaillez avec des ressources réseau ou que vous mettez en œuvre un chargement progressif, utilisez la méthode IronPdfViewSource.FromStream en C# :

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

Le chargement par flux est idéal pour traiter efficacement les PDF volumineux ou travailler avec des flux de documents cryptés.