Jak przekształcić XAML w PDF w NET MAUI

Konwersja XAML do PDF w C# MAUI

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

IronPDF pozwala konwertować strony XAML do formatu PDF w aplikacjach .NET MAUI za pomocą zaledwie kilku wierszy kodu. Korzystając z metody RenderContentPageToPdf, możesz przekształcić interfejs użytkownika swojej aplikacji MAUI w profesjonalne dokumenty PDF przeznaczone dla platform stacjonarnych i internetowych.

.NET MAUI (Multi-platform App UI) to wieloplatformowy framework do tworzenia natywnych aplikacji na urządzenia. Jest to rozszerzenie Xamarin.Forms i stanowi część ujednoliconego ekosystemu .NET 6. Pozwala to programistom aplikacji .NET na tworzenie aplikacji na platformy stacjonarne, internetowe i mobilne przy użyciu wspólnych komponentów interfejsu użytkownika i jednej bazy kodu. MAUI pozwala również na dodawanie kodu i zasobów specyficznych dla danej platformy, gdy jest to konieczne.

IronPDF pozwala generować dokumenty PDF ze stron MAUI, umożliwiając tworzenie plików/stron PDF w tych aplikacjach. Niezależnie od tego, czy tworzysz oprogramowanie w systemie Windows czy macOS, IronPDF zapewnia spójne możliwości generowania plików PDF. Jednak IronPDF obecnie nie obsługuje platform mobilnych.

Proces generowania plików PDF w aplikacjach MAUI wykorzystuje silnik renderujący IronPDF dla przeglądarki Chrome, co gwarantuje, że układy XAML są dokładnie przekształcane do formatu PDF. Dzięki temu idealnie nadaje się do generowania raportów, faktur lub wszelkich dokumentów, które wymagają zachowania wizualnej spójności interfejsu użytkownika aplikacji MAUI.

Szybki start: Konwersja XAML do PDF za pomocą IronPDF w .NET MAUI

Konwertuj strony XAML do formatu PDF w .NET MAUI za pomocą IronPDF. Wystarczy kilka wierszy kodu, aby przekształcić zawartość aplikacji MAUI w profesjonalnej jakości dokumenty PDF. Ten przewodnik zawiera prosty przykład, który pomoże Ci szybko rozpocząć pracę, wykorzystując wydajne możliwości renderowania IronPDF. Zapoznaj się z instrukcją, aby płynnie zintegrować generowanie plików PDF ze swoimi aplikacjami desktopowymi i internetowymi.

var pdf = new IronPdf.ChromePdfRenderer().RenderContentPageToPdf<MainPage,App>().SaveAs("page.pdf");
var pdf = new IronPdf.ChromePdfRenderer().RenderContentPageToPdf<MainPage,App>().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żywać metody RenderContentPageToPdf
  3. Zaktualizuj przycisk w pliku MainPage.xaml, aby uruchamiał nową funkcję
  4. Wyeksportuj dokument PDF lub wyświetl go w aplikacji MAUI za pomocą przeglądarki plików PDF
  5. Pobierz przykładowy projekt MAUI, aby szybko rozpocząć pracę

Jakiego pakietu rozszerzeń potrzebuję do IronPDF z MAUI?

Pakiet IronPdf.Extensions.Maui stanowi rozszerzenie głównego pakietu IronPdf. Ponieważ jest to rozszerzenie, główny pakiet IronPdf jest nadal potrzebny do renderowania strony treści aplikacji MAUI do dokumentu PDF. Ten pakiet rozszerzeń w szczególności wypełnia lukę między opartym na XAML frameworkiem interfejsu użytkownika MAUI a możliwościami generowania plików PDF przez IronPDF.

Pakiet rozszerzeń obsługuje konwersję obiektów MAUI ContentPage na HTML, który może być renderowany jako PDF. Zachowuje układ i styl stron MAUI, zapewniając jednocześnie dostęp do wszystkich zaawansowanych funkcji IronPDF, takich jak niestandardowe marginesy, niestandardowe rozmiary papieru i kompresja plików PDF.

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

Po zainstalowaniu pakietu rozszerzeń uzyskasz dostęp do metody RenderContentPageToPdf, która jest kluczem do konwersji stron MAUI. Ta metoda jest zoptymalizowana pod kątem wydajności i zachowuje wierność wizualną układów XAML podczas procesu konwersji.

Jak przekonwertować stronę MAUI do formatu PDF?

Który plik kodu powinienem zmodyfikować w pierwszej kolejności?

  • Przejdź z pliku MainPage.xaml do jego pliku kodu, MainPage.xaml.cs.
  • Zmień nazwę funkcji OnCounterClicked na PrintToPdf. Skorzystaj z poniższego przykładowego kodu.

Aby przekształcić stronę MAUI do formatu PDF, użyj metody RenderContentPageToPdf. Dostęp do tej metody można uzyskać poprzez instancjonowanie klasy ChromePdfRenderer. Ta metoda zwróci obiekt PdfDocument, który można zapisać lub wyświetlić za pomocą metody SaveAs lub przeglądarki PDF w ramach funkcji Wyświetlanie plików PDF w MAUI.

Klasa ChromePdfRenderer zapewnia szerokie możliwości dostosowywania poprzez swoją właściwość RenderingOptions. Można ustawić marginesy strony, orientację papieru, włączyć wykonywanie kodu JavaScript i wiele więcej. Te opcje gwarantują, że plik PDF będzie dokładnie odpowiadał Twoim wymaganiom.

: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

Ponadto, jak zapewne zauważyłeś, renderowanie z XAML zapewnia również pełny dostęp do wszystkich funkcji dostępnych w RenderingOptions. Obejmuje to dodanie nagłówków i stopek tekstowych oraz HTML. Można również umieszczać na obrazach pieczątki, dodawać numery stron, a nawet dostosowywać rozmiar i układ strony. Wszystkie te opcje są dostępne podczas tworzenia pliku PDF przy użyciu tej metody.

Metoda RenderContentPageToPdf jest domyślnie asynchroniczna i zwraca obiekt typu Task<PdfDocument>. Umożliwia to generowanie plików PDF bez blokowania, co jest szczególnie przydatne w przypadku złożonych układów lub generowania wielu plików PDF jednocześnie. Metoda ta automatycznie obsługuje konwersję elementów wizualnych XAML na ich odpowiedniki w formacie PDF, zachowując kolory, czcionki i struktury układu.

Jakie zmiany muszę wprowadzić 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 plik PDF. Ta prosta modyfikacja przekształca aplikację MAUI w generator plików PDF przy minimalnych zmianach w kodzie.

<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

Styl przycisku można dostosować za pomocą standardowych właściwości stylizacyjnych MAUI, a podczas generowania pliku PDF można dodać dodatkowe elementy wizualne, takie jak wskaźniki ładowania. Zapewnia to płynne działanie podczas procesu tworzenia plików PDF.

Jak wygląda plik PDF z tłumaczeniem?

Przed zapisaniem pliku PDF można wprowadzić w nim dodatkowe zmiany, korzystając z metod dostępnych w PdfDocument. Możesz łączyć strony, dzielić je lub obracać. Możesz również dodawać adnotacje i zakładki do pliku PDF. Dodatkowo można ustawić metadane pliku PDF, takie jak autor, tytuł i słowa kluczowe, aby poprawić organizację dokumentu i ułatwić wyszukiwanie.

Wygenerowany plik PDF zachowuje hierarchię wizualną i styl strony MAUI, w tym czcionki, kolory i ograniczenia dotyczące układu. Dzięki temu idealnie nadaje się do tworzenia wersji ekranów aplikacji do wydruku lub generowania raportów na podstawie interfejsu użytkownika aplikacji.

Gdzie mogę pobrać kompletny przykładowy projekt MAUI?

Możesz pobrać pełny kod do tego przewodnika. Jest on dostępny w postaci pliku ZIP, który można otworzyć w Visual Studio jako projekt aplikacji .NET MAUI. Przykładowy projekt zawiera wszystkie niezbędne zależności i pokazuje najlepsze praktyki dotyczące integracji IronPDF z aplikacjami MAUI.

Przykładowy projekt jest skonfigurowany do pracy zarówno na platformach stacjonarnych Windows, jak i macOS, co pokazuje możliwości wieloplatformowe zarówno MAUI, jak i IronPDF. Zawiera przykłady różnych scenariuszy generowania plików PDF i pokazuje, jak radzić sobie z różnymi układami stron i typami treści.

Pobierz pełny przykładowy projekt MAUI

Odkryj więcej możliwości na naszej stronie z samouczkami: Konwersja plików PDF. Możesz również zapoznać się z naszymi przewodnikami dotyczącymi kompresji plików PDF, aby ulepszyć generowane pliki PDF do dystrybucji w Internecie, lub dowiedzieć się więcej o tworzeniu plików PDF w Blazor Servers w scenariuszach generowania plików PDF w 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 18,926,724 | Wersja: 2026.5 just released
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.