Comment convertir XAML en PDF dans NET MAUI

Conversion de XAML en PDF avec C# MAUI

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

IronPDF vous permet de convertir des pages XAML en PDF dans les applications .NET MAUI en quelques lignes de code seulement. En utilisant la méthode RenderContentPageToPdf , vous pouvez convertir l'interface utilisateur de votre application MAUI en documents PDF professionnels pour les plateformes de bureau et web.

.NET MAUI (Interface utilisateur d'application multiplateforme) est un cadre multiplateforme pour créer des applications natives pour appareils. Il s'étend de Xamarin.Forms et fait partie de l'écosystème .NET 6 unifié. Il permet aux développeurs d'applications .NET de créer des applications pour les plateformes de bureau, web et mobiles en utilisant des composants d'interface utilisateur communs et une base de code unique. MAUI vous permet également d'ajouter du code et des ressources spécifiques à la plateforme lorsque cela est nécessaire.

IronPDF vous permet de générer des documents PDF à partir de pages MAUI, rendant ainsi possible la création de fichiers/pages PDF dans ces applications. Que vous développiez sur Windows ou macOS, IronPDF offre des capacités de génération de PDF cohérentes. Toutefois, IronPDF ne prend actuellement pas en charge les plateformes mobiles.

Le processus de génération de PDF dans les applications MAUI utilise le moteur de rendu Chrome d'IronPDF, garantissant ainsi que vos mises en page XAML sont traduites avec précision au format PDF. Elle est donc idéale pour générer des rapports, des factures ou tout autre document qui doit préserver l'intégrité visuelle de l'interface utilisateur de votre application MAUI.

Démarrage rapide : Convertir du XAML en PDF avec IronPDF dans .NET MAUI

Convertissez vos pages XAML en PDF dans .NET MAUI à l'aide d'IronPDF. En quelques lignes de code seulement, vous pouvez transformer le contenu de votre application MAUI en documents PDF de qualité professionnelle. Ce guide fournit un exemple simple pour vous permettre de démarrer rapidement, en utilisant les capacités de rendu efficaces d'IronPDF. Suivez les instructions pour intégrer facilement la génération de PDF à vos applications de bureau et Web.

var pdf = new IronPdf.ChromePdfRenderer().RenderContentPageToPdf<MainPage,App>().SaveAs("page.pdf");
var pdf = new IronPdf.ChromePdfRenderer().RenderContentPageToPdf<MainPage,App>().SaveAs("page.pdf");
$vbLabelText   $csharpLabel

Flux de travail minimal (5 étapes)

  1. Téléchargez la bibliothèque IronPDF C# pour MAUI
  2. Modifiez le fichier MainPage.xaml.cs pour utiliser la méthode RenderContentPageToPdf
  3. Mettez à jour le bouton dans le fichier MainPage.xaml pour déclencher la nouvelle fonction
  4. Exportez le document PDF ou visualisez-le dans l'application MAUI à l'aide d'une visionneuse PDF.
  5. Téléchargez l'exemple de projet MAUI pour une prise en main rapide.

De quel pack d'extension ai-je besoin pour IronPDF avec MAUI?

Le package IronPdf.Extensions.Maui est l'extension du package principal IronPdf. Étant donné qu'il s'agit d'une extension, le package principal IronPDF est toujours nécessaire pour rendre la page de contenu d'une application MAUI en un document PDF. Ce module d'extension comble spécifiquement le fossé entre le framework d'interface utilisateur basé sur XAML de MAUI et les capacités de génération de PDF d'IronPDF.

Le paquet d'extension gère la conversion des objets MAUI ContentPage en HTML qui peut être rendu en PDF. Elle préserve la mise en page et le style de vos pages MAUI tout en donnant accès à toutes les fonctionnalités avancées d'IronPDF telles que marges personnalisées, tailles de papier personnalisées, et compression PDF.

Install-Package IronPdf.Extensions.Maui
Install-Package IronPdf.Extensions.Maui
SHELL

Après avoir installé le paquet d'extension, vous aurez accès à la méthode RenderContentPageToPdf, qui est la clé de la conversion de vos pages MAUI. Cette méthode est optimisée pour les performances et préserve la fidélité visuelle de vos mises en page XAML au cours du processus de conversion.

Comment convertir une page MAUI en PDF?

Quel fichier de code dois-je modifier en premier?

  • Passez du fichier MainPage.xaml à son fichier de code, MainPage.xaml.cs.
  • Changez la fonction nommée OnCounterClicked en PrintToPdf. Utilisez l'exemple de code ci-dessous.

Pour transformer votre page MAUI en PDF, utilisez la méthode RenderContentPageToPdf. La méthode peut être accédée en instanciant la classe ChromePdfRenderer. Cette méthode vous donnera un objet PdfDocument, que vous pouvez enregistrer ou visualiser en utilisant la méthode SaveAs ou un visualiseur de PDF avec Visualiser des PDFs dans MAUI.

La classe ChromePdfRenderer offre des options de personnalisation étendues grâce à sa propriété RenderingOptions. Vous pouvez définir les marges des pages, l'orientation du papier, activer l'exécution de JavaScript, et bien plus encore. Ces options permettent de s'assurer que votre fichier PDF correspond exactement à vos besoins.

:path=/static-assets/pdf/content-code-examples/how-to/xaml-to-pdf-maui-mainpage-xaml-cs.cs
using IronPdf.Extensions.Maui;

namespace mauiSample;

public partial class MainPage : ContentPage
{
    public MainPage()
    {
        InitializeComponent();
    }

    private void PrintToPdf(object sender, EventArgs e)
    {
        ChromePdfRenderer renderer = new ChromePdfRenderer();

        // Apply HTML header
        renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter()
        {
            HtmlFragment = "<h1>Header</h1>",
        };

        // Render PDF from Maui Page
        PdfDocument pdf = renderer.RenderContentPageToPdf<MainPage, App>().Result;

        pdf.SaveAs(@"C:\Users\lyty1\Downloads\contentPageToPdf.pdf");
    }
}
$vbLabelText   $csharpLabel

De plus, comme vous l'avez peut-être remarqué, le rendu à partir de XAML vous donne également un accès complet à toutes les fonctionnalités disponibles dans RenderingOptions. Cela inclut l'ajout de en-têtes et pieds de page en texte et HTML. Vous pouvez également estampiller des images, ajouter des numéros de page, et même personnaliser la taille et la mise en page de la page. Toutes ces options sont disponibles lorsque vous utilisez cette méthode pour créer un PDF.

La méthode RenderContentPageToPdf est asynchrone par défaut et renvoie une tâchePdfDocument>. La traduction doit rester professionnelle et préserver l'exactitude technique tout en expliquant les caractéristiques et les avantages de ces outils de développement. La méthode gère automatiquement la conversion des éléments visuels XAML en leurs équivalents PDF, en préservant les couleurs, les polices et les structures de mise en page.

Quelles sont les modifications à apporter au fichier XAML?

Dans le fichier MainPage.xaml, remplacez la fonction par défaut OnCounterClicked par la nouvelle fonction PrintToPdf. Cliquer sur ce bouton exécutera la méthode PrintToPdf et créera le PDF. Cette simple modification transforme votre application MAUI en générateur de PDF avec un minimum de changements dans le code.

<Button
    x:Name="PrintToPdfBtn"
    Text="Print to pdf"
    SemanticProperties.Hint="Click to print page as PDF"
    Clicked="PrintToPdf"
    HorizontalOptions="Center" />
<Button
    x:Name="PrintToPdfBtn"
    Text="Print to pdf"
    SemanticProperties.Hint="Click to print page as PDF"
    Clicked="PrintToPdf"
    HorizontalOptions="Center" />
XML

Le bouton peut être stylisé à l'aide des propriétés de style MAUI standard, et vous pouvez ajouter des informations visuelles supplémentaires telles que des indicateurs de chargement pendant la génération du PDF. Cela garantit une expérience fluide pour l'utilisateur pendant le processus de création du PDF.

À quoi ressemble le PDF de sortie?

Avant d'enregistrer votre fichier PDF, vous pouvez y apporter d'autres modifications à l'aide des méthodes disponibles pour PdfDocument. Vous pouvez fusionner des pages, les séparer, ou les faire pivoter. Vous pouvez également ajouter des annotations et des signets à votre PDF. En outre, vous pouvez définir des métadonnées PDF telles que l'auteur, le titre et les mots-clés afin d'améliorer l'organisation du document et les possibilités de recherche.

Le PDF généré conserve la hiérarchie visuelle et le style de votre page MAUI, y compris les polices, les couleurs et les contraintes de mise en page. Elle est donc parfaite pour créer des versions imprimables des écrans de votre application ou pour générer des rapports basés sur l'interface utilisateur de votre application.

Où puis-je télécharger un exemple de projet MAUI complet?

Vous pouvez télécharger le code complet pour ce guide. Il vient sous forme d'un fichier zippé que vous pouvez ouvrir dans Visual Studio en tant que projet d'application .NET MAUI. L'exemple de projet inclut toutes les dépendances nécessaires et démontre les meilleures pratiques pour intégrer IronPDF dans vos applications MAUI.

L'exemple de projet est configuré pour fonctionner sur les plateformes de bureau Windows et macOS, mettant en valeur les capacités multiplateformes de MAUI et d'IronPDF. Elle comprend des exemples de divers scénarios de génération de PDF et montre comment gérer différentes mises en page et différents types de contenu.

Télécharger le projet complet d'exemple MAUI

Explorez davantage de possibilités grâce à notre page de tutoriels ici : Convertir des PDF . Vous pourriez également être intéressé par la consultation de nos guides sur la compression PDF afin d'améliorer vos PDF générés pour la distribution Web, ou par l'apprentissage de la création de PDF dans les serveurs Blazor pour les scénarios de génération de PDF basés sur le Web.

Questions Fréquemment Posées

Qu'est-ce que .NET MAUI et quel est son rapport avec la génération de PDF ?

.NET MAUI (Multi-platform App UI) est un cadre multiplateforme pour la création d'applications pour appareils natifs qui s'étend de Xamarin.Forms. IronPDF s'intègre aux applications .NET MAUI pour permettre la génération de PDF à partir de pages XAML à l'aide de la méthode RenderContentPageToPdf, ce qui permet aux développeurs de transformer l'interface utilisateur de leur application MAUI en documents PDF professionnels.

Quelles sont les plateformes prises en charge pour la génération de PDF dans les applications MAUI ?

IronPDF prend actuellement en charge la génération de PDF dans les applications MAUI sur les plateformes de bureau (Windows et macOS) et web. Les plateformes mobiles ne sont actuellement pas prises en charge par IronPDF pour la génération de PDF MAUI.

Quelle extension est nécessaire pour convertir XAML en PDF dans MAUI ?

Vous avez besoin du package IronPdf.Extensions.Maui en plus du package principal IronPDF. Le package d'extension fait spécifiquement le lien entre le cadre d'interface utilisateur basé sur XAML de MAUI et les capacités de génération de PDF d'IronPDF, en gérant la conversion des objets ContentPage de MAUI en HTML qui peut être rendu en PDF.

Comment convertir une page MAUI XAML en PDF en C# ?

La conversion d'une page MAUI XAML en PDF avec IronPDF est simple. Vous pouvez utiliser la méthode RenderContentPageToPdf avec une seule ligne de code : var pdf = new IronPDF.ChromePdfRenderer().RenderContentPageToPdf().SaveAs('page.pdf'). Cette méthode tire parti du moteur de rendu Chrome d'IronPdf pour traduire avec précision les mises en page XAML au format PDF.

Quelles sont les étapes de base pour mettre en œuvre la génération de PDF dans une application MAUI ?

Le flux de travail de base comprend ce qui suit 1) Télécharger la bibliothèque C# IronPDF pour MAUI, 2) Modifier le fichier MainPage.xaml.cs pour utiliser la méthode RenderContentPageToPdf, 3) Mettre à jour le bouton dans MainPage.xaml pour déclencher la fonction, 4) Exporter le document PDF ou l'afficher dans l'app MAUI, et 5) En option, télécharger l'exemple de projet MAUI d'IronPDF pour une mise en route rapide.

Quel moteur de rendu le processus de conversion PDF utilise-t-il ?

IronPDF utilise son moteur de rendu Chrome pour le processus de génération de PDF dans les applications MAUI. Cela garantit que vos mises en page XAML sont traduites avec précision au format PDF tout en préservant l'intégrité visuelle de l'interface utilisateur de votre application MAUI.

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,012,929 | Version : 2025.12 vient de sortir