Conversion de XAML en PDF en C# MAUI
IronPDF vous permet de convertir des pages XAML en PDF dans des applications .NET MAUI en quelques lignes de code seulement. En utilisant la méthode RenderContentPageToPdf, vous pouvez transformer l'interface utilisateur de votre application MAUI en documents PDF professionnels pour les plateformes de bureau et web.
.NET MAUI (Multi-platform App UI) est un framework multiplateforme permettant de créer des applications natives pour appareils. Elle s'étend à partir de Xamarin.Forms et fait partie de l'écosystème .NET 6 unifié. Elle permet aux développeurs d'applications .NET de créer des applications pour les plateformes de bureau, web et mobiles à l'aide de composants d'interface utilisateur communs et d'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 sous Windows ou macOS, IronPDF offre des fonctionnalités de génération de PDF cohérentes. Cependant, 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 que vos mises en page XAML sont fidèlement converties au format PDF. Cela en fait l'outil idéal pour générer des rapports, des factures ou tout autre document nécessitant de préserver l'intégrité visuelle de l'interface utilisateur de votre application MAUI.
Guide de 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 ces étapes pour intégrer facilement la génération de PDF dans 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");
Workflow minimal (5 étapes)
- Télécharger la bibliothèque IronPDF C# pour MAUI
- Modifiez le fichier
MainPage.xaml.cspour utiliser la méthodeRenderContentPageToPdf - Mettez à jour le bouton dans le fichier
MainPage.xamlpour déclencher la nouvelle fonction - Exportez le document PDF ou consultez-le dans l'application MAUI à l'aide d'un lecteur de PDF
- Téléchargez l'exemple de projet MAUI pour un démarrage rapide
De quel package d'extension ai-je besoin pour IronPDF avec MAUI ?
Le package IronPdf.Extensions.Maui est une extension du package principal IronPdf. Comme il s'agit d'une extension, le package principal IronPdf reste nécessaire pour convertir la page de contenu d'une application MAUI en document PDF. Ce package 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 package d'extension gère la conversion des objets MAUI ContentPage en HTML pouvant être rendu au format 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 les marges personnalisées, les formats de papier personnalisés et la compression PDF.
Install-Package IronPdf.Extensions.Maui
Install-Package IronPdf.Extensions.Maui
Après avoir installé le package d'extension, vous aurez accès à la méthode RenderContentPageToPdf, qui est la clé pour convertir 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 pendant le 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. - Remplacer la fonction nommée
OnCounterClickedparPrintToPdf. Utilisez l'exemple de code ci-dessous.
Pour convertir votre page MAUI en PDF, utilisez la méthode RenderContentPageToPdf. La méthode est accessible en instanciant la classe ChromePdfRenderer. Cette méthode vous donnera un objet PdfDocument, que vous pouvez économiser ou afficher à l'aide de la méthode SaveAs ou d'une visionneuse PDF avec Affichage de fichiers PDF dans MAUI.
La classe ChromePdfRenderer offre de nombreuses options de personnalisation grâce à sa propriété RenderingOptions. Vous pouvez définir les marges de la page, l'orientation du papier, activer l'exécution de JavaScript, et bien plus encore. Ces options garantissent que votre fichier PDF final correspond exactement à vos exigences.
: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");
}
}
Imports IronPdf.Extensions.Maui
Namespace mauiSample
Partial Public Class MainPage
Inherits ContentPage
Public Sub New()
InitializeComponent()
End Sub
Private Sub PrintToPdf(ByVal sender As Object, ByVal e As EventArgs)
Dim renderer As New ChromePdfRenderer()
' Apply HTML header
renderer.RenderingOptions.HtmlHeader = New HtmlHeaderFooter() With {.HtmlFragment = "<h1>Header</h1>"}
' Render PDF from Maui Page
Dim pdf As PdfDocument = renderer.RenderContentPageToPdf(Of MainPage, App)().Result
pdf.SaveAs("C:\Users\lyty1\Downloads\contentPageToPdf.pdf")
End Sub
End Class
End Namespace
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 d'en-têtes et de pieds de page au format texte et HTML. Vous pouvez également apposer des filigranes sur les images, ajouter des numéros de page et même personnaliser la taille et la mise en 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 un Task<PdfDocument>. Cela permet une génération de PDF sans blocage, ce qui est particulièrement utile lorsqu'il s'agit de mises en page complexes ou lors de la génération simultanée de plusieurs PDF. La méthode gère automatiquement la conversion des éléments visuels XAML en leurs équivalents PDF, en conservant les couleurs, les polices et les structures de mise en page.
Quelles modifications dois-je 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 lancera la méthode PrintToPdf et créera le PDF. Cette simple modification transforme votre application MAUI en un générateur de PDF avec un minimum de modifications du 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" />
Le bouton peut être stylisé à l'aide des propriétés de style MAUI standard, et vous pouvez ajouter des retours visuels supplémentaires, tels que des indicateurs de chargement, pendant la génération du PDF. Cela garantit une expérience utilisateur fluide pendant le processus de création de PDF.
À quoi ressemble le fichier PDF final ?
Avant d'économiser votre fichier PDF, vous pouvez y apporter d'autres modifications à l'aide des méthodes disponibles dans PdfDocument. Vous pouvez fusionner des pages, les séparer ou les faire pivoter. Vous pouvez également ajouter des annotations et des signets à votre PDF. De plus, 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 et la facilité de recherche des documents.
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. Cela en fait l'outil idéal pour créer des versions imprimables des écrans de votre application ou 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 de ce guide. Il se présente sous la forme d'un fichier ZIP que vous pouvez ouvrir dans Visual Studio en tant que projet d'application .NET MAUI. Le projet d'exemple comprend toutes les dépendances nécessaires et présente les meilleures pratiques pour intégrer IronPDF dans vos applications MAUI.
Le projet d'exemple est configuré pour fonctionner à la fois sur les plateformes de bureau Windows et macOS, mettant en avant 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 d'exemple MAUI complet
Découvrez d'autres possibilités sur notre page de tutoriels ici : Convertir des PDF. Vous pourriez également être intéressé par nos guides sur la compression de PDF afin d'améliorer vos fichiers PDF générés pour la distribution sur le Web, ou par la création de PDF dans Blazor Servers pour des scénarios de génération de PDF 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.

