Jak przekształcić XAML w PDF w NET MAUI

Konwertowanie XAML na PDF w C# MAUI

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

IronPDF pozwala na przekształcanie stron XAML na PDF w aplikacjach .NET MAUI za pomocą zaledwie kilku linii kodu. Używając metody RenderContentPageToPdf, możesz zmienić UI aplikacji MAUI na profesjonalne dokumenty PDF dla platform desktopowych i internetowych.

.NET MAUI (Wielopłatformowy Interfejs Aplikacji) to wielopłatformowy 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 do 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.

:path=/static-assets/pdf/content-code-examples/how-to/xaml-to-pdf-maui-1.cs
var pdf = new IronPdf.ChromePdfRenderer().RenderContentPageToPdf<MainPage,App>().Result.SaveAs("page.pdf");
Dim pdf = New IronPdf.ChromePdfRenderer().RenderContentPageToPdf(Of MainPage, App)().Result.SaveAs("page.pdf")
$vbLabelText   $csharpLabel

Minimalny przebieg pracy (5 kroków)

  1. Pobierz bibliotekę IronPDF C# dla MAUI
  2. Zmodyfikuj plik MainPage.xaml.cs, aby użyć metody RenderContentPageToPdf
  3. Zaktualizuj przycisk w pliku MainPage.xaml, aby wywołać nową funkcję
  4. Wyeksportuj dokument PDF lub przeglądaj go w aplikacji MAUI za pomocą przeglądarki PDF
  5. Pobierz przykładowy projekt MAUI, aby szybko zacząć

Jakie rozszerzenie potrzebuję dla IronPDF z MAUI?

Pakiet IronPdf.Extensions.Maui jest rozszerzeniem głównego pakietu IronPdf. Ponieważ jest to rozszerzenie, główny pakiet IronPdf nadal jest potrzebny do renderowania strony zawartości aplikacji MAUI do 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 odpowiada za konwersję obiektów MAUI ContentPage na HTML, który może być renderowany 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

Po zainstalowaniu pakietu rozszerzeniowego uzyskasz dostęp do metody RenderContentPageToPdf, która jest kluczem do konwersji twojego strony MAUI. Tą metodę zoptymalizowano pod kątem wydajności i utrzymuje ona wizualną dokładność układów XAML podczas procesu konwersji.

Icon Quote related to Jakie rozszerzenie potrzebuję dla IronPDF z MAUI?

Moją ulubioną biblioteką tego typu jest IronPDF. Umożliwia ona szybkie i efektywne manipulowanie plikami PDF. Posiada także wiele cennych funkcji, takich jak eksport do formatu PDF/A i cyfrowe podpisywanie dokumentów PDF.

Milan Jovanovic related to Jakie rozszerzenie potrzebuję dla IronPDF z MAUI?

Milan Jovanovic

Microsoft MVP

Zobacz studium przypadku
Icon Quote related to Jakie rozszerzenie potrzebuję dla IronPDF z MAUI?

IronOCR pozwala nam oszczędzić 40 000 USD rocznie na ręcznym przetwarzaniu, jednocześnie zwiększając produktywność i uwalniając zasoby do zadań o wysokim wpływie. Gorąco polecam.

Brent Matzelle related to Jakie rozszerzenie potrzebuję dla IronPDF z MAUI?

Brent Matzelle

Dyrektor technologiczny, OPYN

Zobacz studium przypadku
Icon Quote related to Jakie rozszerzenie potrzebuję dla IronPDF z MAUI?

IronSuite odgrywa kluczową rolę w naszej działalności. Są to narzędzia zwiększające wydajność w całej firmie, w tym tworzenie planów pięter i poprawa zarządzania zapasami.

David Jones related to Jakie rozszerzenie potrzebuję dla IronPDF z MAUI?

David Jones

Główny inżynier oprogramowania, Agorus Build

Zobacz studium przypadku

Jak wyrenderować stronę MAUI do PDF?

Który plik kodu należy zmodyfikować jako pierwszy?

  • Przejdź z pliku MainPage.xaml do jego pliku kodu, MainPage.xaml.cs.
  • Zmień funkcję o nazwie OnCounterClicked na PrintToPdf. Użyj przykładowego kodu poniżej.

Aby przekonwertować stronę MAUI na PDF, użyj metody RenderContentPageToPdf. Do tej funkcjonalności dostęp można uzyskać, instancjonując klasę ChromePdfRenderer. Ta metoda da ci obiekt PdfDocument, który możesz zapisać lub wyświetlić, korzystając z metody SaveAs lub przeglądarki PDF z Przeglądanie PDF w MAUI.

Klasa ChromePdfRenderer oferuje rozbudowane opcje dostosowywania poprzez jej właściwość RenderingOptions. Możesz ustawić marginesy stron, orientację papieru, włączyć wykonywanie JavaScript i wiele więcej. Te opcje zapewniają, że Twoje wyjście PDF spełnia Twoje dokładne wymagania.

: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
$vbLabelText   $csharpLabel

Co więcej, jak być może zauważyłeś, renderowanie z XAML również daje pełen 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 asynchroniczna domyślnie i zwraca 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 zamień domyślną funkcję OnCounterClicked na nową funkcję PrintToPdf. Kliknięcie tego przycisku uruchomi metodę PrintToPdf i utworzy PDF. Ta prosta modyfikacja przekształca Twoją 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" />
XML

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?

Zanim zapiszesz swój plik PDF, możesz wprowadzić więcej zmian, korzystając z 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 wielopłatformowe 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 naszej stronie z przewodnikami: Konwertuj PDF. Mogą Cię również zainteresować nasze przewodniki dotyczące kompresji PDF, aby poprawić generowane PDF do dystrybucji internetowej, lub dowiedz się o tworzeniu PDF w Blazor Servers dla scenariuszy generacji PDF opartych na sieci.

Często Zadawane Pytania

Czym jest .NET MAUI i jak ma się do generacji PDF?

.NET MAUI (Multi-platform App UI) to wieloplatformowy framework do budowy natywnych aplikacji na urządzenia, rozszerzający Xamarin.Forms. IronPDF integruje się z aplikacjami .NET MAUI, aby umożliwić generację PDF ze stron XAML przy użyciu metody RenderContentPageToPdf, pozwalając deweloperom przekształcać interfejs aplikacji MAUI w profesjonalne dokumenty PDF.

Jakie platformy są wspierane dla generacji PDF w aplikacjach MAUI?

IronPDF obecnie wspiera generację PDF w aplikacjach MAUI na platformach desktopowych (Windows i macOS) oraz sieciowych. Platformy mobilne nie są obecnie wspierane przez IronPDF dla generacji PDF MAUI.

Jaki pakiet rozszerzeń jest potrzebny do konwersji XAML na PDF w MAUI?

Potrzebujesz pakietu IronPdf.Extensions.Maui wraz z głównym pakietem IronPDF. Pakiet rozszerzeń specjalnie łączy framework interfejsu użytkownika opartego na XAML w MAUI z możliwościami generacji PDF IronPDF, zajmując się konwersją obiektów MAUI ContentPage na HTML, który można renderować jako PDF.

Jak przekonwertować stronę XAML z MAUI na PDF w C#?

Konwersja strony XAML z MAUI na PDF z IronPDF jest prosta. Możesz użyć metody RenderContentPageToPdf zaledwie w jednej linijce kodu: var pdf = new IronPdf.ChromePdfRenderer().RenderContentPageToPdf().SaveAs('page.pdf'). To wykorzystuje silnik renderowania Chrome IronPDF, aby precyzyjnie przełożyć układy XAML na format PDF.

Jakie są podstawowe kroki do wdrożenia generacji PDF w aplikacji MAUI?

Podstawowy przepływ pracy obejmuje: 1) Pobierz bibliotekę IronPDF C# dla MAUI, 2) Zmodyfikuj plik MainPage.xaml.cs, aby użyć metody RenderContentPageToPdf, 3) Zaktualizuj przycisk w MainPage.xaml, aby wywołać funkcję, 4) Wyeksportuj dokument PDF lub wyświetl go w aplikacji MAUI, oraz 5) Opcjonalnie pobierz przykładowy projekt MAUI IronPDF, aby szybko rozpocząć.

Jaki silnik renderujący jest używany w procesie konwersji PDF?

IronPDF używa swojego silnika renderowania Chrome do procesu generowania PDF w aplikacjach MAUI. Zapewnia to, że Twoje układy XAML są dokładnie tłumaczone na format PDF, zachowując integralność wizualną interfejsu użytkownika aplikacji MAUI.

Curtis Chau
Autor tekstów technicznych

Curtis Chau posiada tytuł licencjata z informatyki (Uniwersytet Carleton) i specjalizuje się w front-endowym rozwoju, z ekspertką w Node.js, TypeScript, JavaScript i React. Pasjonuje się tworzeniem intuicyjnych i estetycznie przyjemnych interfejsów użytkownika, Curtis cieszy się pracą z nowoczesnymi frameworkami i tworzeniem dobrze zorganizowanych, atrakcyjnych wizualnie podrę...

Czytaj więcej
Gotowy, aby rozpocząć?
Nuget Pliki do pobrania 19,936,792 | Wersja: 2026.7 właśnie wydany
Still Scrolling Icon

Wciąż przewijasz?

Czy chcesz szybko dowodu? PM > Install-Package IronPdf
Uruchom przykład i zobacz, jak Twój kod HTML zamienia się w plik PDF.