Converting XAML to PDF in C# MAUI
IronPDF pozwala na przekształcanie stron XAML na PDF w aplikacjach .NET MAUI za pomocą zaledwie kilku linii kodu. Korzystając z metody RenderContentPageToPdf, można zmienić interfejs aplikacji MAUI w profesjonalne dokumenty PDF dla platform desktopowych i webowych.
.NET MAUI (Wieloplatformowy Interfejs Aplikacji) to wieloplatformowy framework do tworzenia natywnych aplikacji urządzeń. Rozszerza się on od Xamarin.Forms i jest częścią zjednoczonego ekosystemu .NET 6. Pozwala programistom aplikacji .NET tworzyć aplikacje na platformy desktopowe, webowe i mobilne, używając wspólnych komponentów interfejsu użytkownika i jednej bazy kodu. MAUI umożliwia także dodawanie kodu i zasobów specyficznych dla platformy, gdy jest to konieczne.
IronPDF pozwala generować dokumenty PDF ze stron MAUI, co umożliwia tworzenie plików/stron PDF w tych aplikacjach. Niezależnie od tego, czy rozwijasz projekt na Windows czy macOS, IronPDF zapewnia spójne możliwości generowania PDF. Jednakże IronPDF obecnie nie obsługuje platform mobilnych.
Proces generowania PDF w aplikacjach MAUI używa silnika renderującego Chrome od IronPDF, zapewniając, że układy XAML są dokładnie tłumaczone na format PDF. To sprawia, że jest idealny do generowania raportów, faktur lub dowolnych dokumentów, które muszą zachować spójność wizualną interfejsu użytkownika aplikacji MAUI.
Szybki start: Konwertowanie XAML na PDF z IronPDF w .NET MAUI
Konwertuj strony XAML na PDF w .NET MAUI przy użyciu IronPDF. Za pomocą zaledwie kilku linii kodu, można zamienić treść aplikacji MAUI na profesjonalnej jakości dokumenty PDF. Ten przewodnik oferuje prosty przykład, aby szybko rozpocząć, wykorzystując wydajne możliwości renderujące IronPDF. Postępuj zgodnie z instrukcjami, aby płynnie zintegrować generowanie PDF w swoich aplikacjach desktopowych i webowych.
var pdf = new IronPdf.ChromePdfRenderer().RenderContentPageToPdf<MainPage,App>().SaveAs("page.pdf");
var pdf = new IronPdf.ChromePdfRenderer().RenderContentPageToPdf<MainPage,App>().SaveAs("page.pdf");
Minimalny przebieg pracy (5 kroków)
- Pobierz bibliotekę IronPDF C# dla MAUI
- Zmodyfikuj plik MainPage.xaml.cs, aby użyć metody
RenderContentPageToPdf - Zaktualizuj przycisk w pliku MainPage.xaml, aby uruchomić nową funkcję
- Wyeksportuj dokument PDF lub przeglądaj go w aplikacji MAUI za pomocą przeglądarki PDF
- Pobierz przykładowy projekt MAUI, aby szybko zacząć
Jakie rozszerzenie potrzebuję dla IronPDF z MAUI?
Pakiet IronPdf.Extensions.Maui to rozszerzenie głównego pakietu IronPdf. Ponieważ jest to rozszerzenie, główny pakiet IronPDF jest nadal potrzebny do renderowania strony treści aplikacji MAUI jako dokumentu PDF. To rozszerzenie bridge'uje lukę pomiędzy opartym na XAML frameworkiem interfejsu MAUI, a możliwościami generowania PDF przez IronPDF.
Pakiet rozszerzenia obsługuje konwersję obiektów MAUI ContentPage na HTML, który można renderować jako PDF. Zachowuje układ i stylizację stron MAUI, jednocześnie umożliwiając dostęp do zaawansowanych funkcji IronPDF, takich jak dostosowane marginesy, dostosowane rozmiary papieru i kompresja PDF.
Install-Package IronPdf.Extensions.Maui
Install-Package IronPdf.Extensions.Maui
Po zainstalowaniu rozszerzenia, uzyskasz dostęp do metody RenderContentPageToPdf, która jest kluczem do konwersji stron MAUI. Tą metodę zoptymalizowano pod kątem wydajności i utrzymuje ona wizualną dokładność układów XAML podczas procesu konwersji.
Jak wyrenderować stronę MAUI do PDF?
Który plik kodu należy zmodyfikować jako pierwszy?
- Przejdź od pliku
MainPage.xamldo jego pliku kodu,MainPage.xaml.cs. - Zmień funkcję nazwaną
OnCounterClickednaPrintToPdf. Użyj przykładowego kodu poniżej.
Aby zamienić stronę MAUI na PDF, użyj metody RenderContentPageToPdf. Metoda ta jest dostępna poprzez zainicjowanie klasy ChromePdfRenderer. Ta metoda da Ci obiekt PdfDocument, który możesz zapisać lub przeglądać za pomocą metody SaveAs lub przeglądarki PDF z Wyświetlanie PDF w MAUI.
Klasa ChromePdfRenderer oferuje szerokie możliwości dostosowywania przez swoje właściwości RenderingOptions. Można ustawić marginesy stron, orientację papieru, włączyć wykonywanie JavaScript i wiele więcej. Te opcje zapewniają, że wyjście PDF spełnia dokładne wymagania projektu.
: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
Co więcej, jak mogłeś zauważyć, renderowanie z XAML daje pełny dostęp do wszystkich funkcji dostępnych w RenderingOptions. Obejmuje to dodawanie tekstowych i HTMLowych nagłówków i stopki. Możesz również stemplować obrazy, dodawać numery stron, a nawet dostosowywać rozmiar i układ strony. Wszystkie te opcje są dostępne, gdy używasz tej metody do tworzenia PDF.
Metoda RenderContentPageToPdf jest domyślnie asynchroniczna, zwracając Task<PdfDocument>. Pozwala to na nieblokujące generowanie PDF, co jest szczególnie przydatne w przypadku skomplikowanych układów lub przy jednoczesnym generowaniu wielu PDF. Metoda automatycznie obsługuje konwersję wizualnych elementów XAML do ich odpowiedników PDF, zachowując kolory, czcionki i struktury układu.
Jakie zmiany są potrzebne w pliku XAML?
W pliku MainPage.xaml, zastąp domyślną funkcję OnCounterClicked nową funkcją PrintToPdf. Kliknięcie tego przycisku uruchomi metodę PrintToPdf i utworzy PDF. Ta prosta modyfikacja przekształca aplikację MAUI w generator PDF z minimalnymi zmianami kodu.
<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" />
Przycisk można stylizować przy użyciu standardowych właściwości stylizacji MAUI i można dodać dodatkowe wizualne informacje zwrotne, takie jak wskaźniki ładowania podczas generowania PDF. Zapewnia to płynne doświadczenie użytkownika podczas procesu tworzenia PDF.
Jak wygląda wynikowy PDF?
Przed zapisaniem pliku PDF, możesz dokonać więcej zmian, używając metod dostępnych w PdfDocument. Możesz scalić strony, rozdzielić je lub obrócić. Możesz także dodać adnotacje i zakładki do swojego PDF. Dodatkowo możesz ustawić metadane PDF, takie jak autor, tytuł i słowa kluczowe, aby poprawić organizację i wyszukiwalność dokumentu.
Generowany PDF utrzymuje hierarchię wizualną i stylizację strony MAUI, w tym czcionki, kolory i ograniczenia układu. To sprawia, że jest idealny do tworzenia wersji do druku ekranów aplikacji lub generowania raportów na podstawie interfejsu aplikacji.
Gdzie mogę pobrać pełny przykład projektu MAUI?
Możesz pobrać pełny kod do tego przewodnika. Jest dostępny jako spakowany plik, który możesz otworzyć w Visual Studio jako projekt .NET MAUI App. Przykładowy projekt zawiera wszystkie niezbędne zależności i pokazuje najlepsze praktyki integracji IronPDF w aplikacjach MAUI.
Przykładowy projekt jest skonfigurowany do pracy zarówno na platformach desktopowych Windows, jak i macOS, prezentując możliwości wieloplatformowe zarówno MAUI, jak i IronPDF. Zawiera przykłady różnych scenariuszy generowania PDF i pokazuje, jak obsługiwać różne układy stron i typy treści.
Pobierz pełny przykładowy projekt MAUI
Odkryj więcej możliwości na stronie z przewodnikami: Konwertuj PDF. Warto również zapoznać się z przewodnikami dotyczącymi kompresji PDF, aby poprawić generowane PDF do dystrybucji internetowej, lub dowiedzieć się o tworzeniu PDF w Blazor Servers dla scenariuszy generacji PDF opartych na sieci.
Często Zadawane Pytania
What is .NET MAUI and how does it relate to PDF generation?
.NET MAUI (Multi-platform App UI) is a cross-platform framework for building native device applications that extends from Xamarin.Forms. IronPDF integrates with .NET MAUI applications to enable PDF generation from XAML pages using the RenderContentPageToPdf method, allowing developers to transform their MAUI application's UI into professional PDF documents.
Which platforms are supported for PDF generation in MAUI applications?
IronPDF currently supports PDF generation in MAUI applications on desktop (Windows and macOS) and web platforms. Mobile platforms are not currently supported by IronPDF for MAUI PDF generation.
What extension package is required for converting XAML to PDF in MAUI?
You need the IronPdf.Extensions.Maui package along with the main IronPdf package. The extension package specifically bridges MAUI's XAML-based UI framework with IronPDF's PDF generation capabilities, handling the conversion of MAUI ContentPage objects into HTML that can be rendered as PDF.
How do I convert a MAUI XAML page to PDF in C#?
Converting a MAUI XAML page to PDF with IronPDF is simple. You can use the RenderContentPageToPdf method with just one line of code: var pdf = new IronPdf.ChromePdfRenderer().RenderContentPageToPdf().SaveAs('page.pdf'). This leverages IronPDF's Chrome rendering engine to accurately translate XAML layouts into PDF format.
What are the basic steps to implement PDF generation in a MAUI application?
The basic workflow includes: 1) Download the IronPDF C# library for MAUI, 2) Modify the MainPage.xaml.cs file to use the RenderContentPageToPdf method, 3) Update the button in MainPage.xaml to trigger the function, 4) Export the PDF document or view it in the MAUI app, and 5) Optionally download IronPDF's sample MAUI project for a quick start.
What rendering engine does the PDF conversion process use?
IronPDF uses its Chrome rendering engine for the PDF generation process in MAUI applications. This ensures that your XAML layouts are accurately translated into PDF format while preserving the visual integrity of your MAUI application's user interface.

