Wie man XAML in NET MAUI zu PDF konvertiert

XAML in PDF in C# MAUI konvertieren

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

Mit IronPDF können Sie XAML-Seiten in .NET MAUI-Anwendungen mit nur wenigen Codezeilen in PDF konvertieren. Mit der Methode RenderContentPageToPdf können Sie die Benutzeroberfläche Ihrer MAUI-Anwendung in professionelle PDF-Dokumente für Desktop- und Webplattformen umwandeln.

.NET MAUI (Multi-platform App UI) ist ein plattformübergreifendes Framework zum Erstellen nativer Geräteanwendungen. Es erweitert sich von Xamarin.Forms und ist Teil des einheitlichen .NET 6-Ökosystems. Es ermöglicht .NET-Anwendungsentwicklern, Anwendungen für Desktop-, Web- und mobile Plattformen mit gemeinsamen UI-Komponenten und einer einzigen Codebasis zu erstellen. MAUI ermöglicht es Ihnen außerdem, bei Bedarf plattformspezifischen Code und Ressourcen hinzuzufügen.

Mit IronPDF können Sie PDF-Dokumente aus MAUI-Seiten generieren, wodurch die Erstellung von PDF-Dateien/Seiten in diesen Anwendungen möglich wird. Egal, ob Sie auf Windows oder macOS entwickeln, IronPDF bietet konsistente PDF-Erzeugungsfunktionen. IronPDF unterstützt jedoch derzeit keine mobilen Plattformen.

Der PDF-Generierungsprozess in MAUI-Anwendungen nutzt die Chrome-Rendering-Engine von IronPDF, um sicherzustellen, dass Ihre XAML-Layouts präzise in das PDF-Format übersetzt werden. Dies macht sie ideal für die Erstellung von Berichten, Rechnungen oder anderen Dokumenten, bei denen die visuelle Integrität der Benutzeroberfläche Ihrer MAUI-Anwendung erhalten bleiben muss.

Schnellstart: XAML mit IronPDF in .NET MAUI in PDF konvertieren

Konvertieren Sie Ihre XAML-Seiten mit IronPDF in PDF in .NET MAUI. Mit nur wenigen Codezeilen können Sie die Inhalte Ihrer MAUI-Anwendung in professionelle PDF-Dokumente umwandeln. Dieser Leitfaden bietet ein einfaches Beispiel, um Ihnen einen schnellen Einstieg in die effizienten Rendering-Funktionen von IronPDF zu ermöglichen. Folgen Sie den Anweisungen, um die PDF-Generierung nahtlos in Ihre Desktop- und Webanwendungen zu integrieren.

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

Minimaler Arbeitsablauf (5 Schritte)

  1. Laden Sie die IronPDF C#-Bibliothek für MAUI herunter.
  2. Ändern Sie die Datei MainPage.xaml.cs so, dass die Methode RenderContentPageToPdf verwendet wird.
  3. Aktualisieren Sie die Schaltfläche in der Datei MainPage.xaml , um die neue Funktion auszulösen.
  4. Exportieren Sie das PDF-Dokument oder zeigen Sie es in der MAUI-App mit einem PDF-Viewer an.
  5. Laden Sie das MAUI-Beispielprojekt für einen schnellen Einstieg herunter.

Welches Erweiterungspaket benötige ich für IronPDF mit MAUI?

Das IronPdf.Extensions.Maui-Paket ist die Erweiterung des Hauptpakets IronPdf. Da es sich um eine Erweiterung handelt, wird das IronPDF-Hauptpaket weiterhin benötigt, um die Inhaltsseite einer MAUI-Anwendung in ein PDF-Dokument umzuwandeln. Dieses Erweiterungspaket schließt speziell die Lücke zwischen dem XAML-basierten UI-Framework von MAUI und den PDF-Generierungsfunktionen von IronPDF.

Das Erweiterungspaket übernimmt die Umwandlung von MAUI ContentPage-Objekten in HTML, das als PDF gerendert werden kann. Sie behält das Layout und die Gestaltung Ihrer MAUI-Seiten bei und bietet gleichzeitig Zugriff auf alle erweiterten Funktionen von IronPDF wie custom margins, custom paper sizes und PDF compression.

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

Nach der Installation des Erweiterungspakets erhalten Sie Zugriff auf die Methode RenderContentPageToPdf, die der Schlüssel zur Konvertierung Ihrer MAUI-Seiten ist. Diese Methode ist für die Leistung optimiert und erhält die visuelle Treue Ihrer XAML-Layouts während des Konvertierungsprozesses.

Wie rendere ich eine MAUI-Seite in PDF?

Welche Code-Datei sollte ich zuerst ändern?

  • Gehen Sie von der Datei MainPage.xaml zu ihrer Codedatei, MainPage.xaml.cs.
  • Ändern Sie die Funktion namens OnCounterClicked zu PrintToPdf. Verwenden Sie das folgende Codebeispiel.

Um Ihre MAUI-Seite in ein PDF zu verwandeln, verwenden Sie die Methode RenderContentPageToPdf. Die Methode kann durch Instanziieren der Klasse ChromePdfRenderer aufgerufen werden. Diese Methode liefert Ihnen ein PdfDocument-Objekt, das Sie mit der Methode SaveAs oder einem PDF-Viewer speichern oder anzeigen können mit PDFs in MAUI anzeigen.

Die Klasse ChromePdfRenderer bietet über ihre Eigenschaft RenderingOptions umfangreiche Anpassungsmöglichkeiten. Sie können die Seitenränder und die Papierausrichtung einstellen, die Ausführung von JavaScript aktivieren und vieles mehr. Diese Optionen stellen sicher, dass Ihre PDF-Ausgabe genau Ihren Anforderungen entspricht.

: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

Darüber hinaus bietet Ihnen das Rendering von XAML, wie Sie vielleicht bemerkt haben, vollen Zugriff auf alle Funktionen in RenderingOptions. Dies beinhaltet das Hinzufügen von Text- und HTML-Kopf- und Fußzeilen. Sie können auch Bilder stempeln, Seitennummern hinzufügen und sogar die Größe und das Layout der Seite anpassen. Alle diese Optionen stehen Ihnen zur Verfügung, wenn Sie diese Methode zur Erstellung eines PDFs verwenden.

Die Methode RenderContentPageToPdf ist standardmäßig asynchron und gibt einen Task<PdfDocument> zurück. Dies ermöglicht eine blockierungsfreie PDF-Erzeugung, was besonders bei komplexen Layouts oder bei der gleichzeitigen Erzeugung mehrerer PDFs nützlich ist. Die Methode übernimmt automatisch die Konvertierung von visuellen XAML-Elementen in ihre PDF-Entsprechungen, wobei Farben, Schriftarten und Layout-Strukturen beibehalten werden.

Welche Änderungen muss ich an der XAML-Datei vornehmen?

Ersetzen Sie in der Datei MainPage.xaml die Standardfunktion OnCounterClicked durch die neue Funktion PrintToPdf. Das Klicken auf diesen Button ruft die Methode PrintToPdf aus und erstellt das PDF. Diese einfache Modifikation verwandelt Ihre MAUI-Anwendung mit minimalen Code-Änderungen in einen PDF-Generator.

<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

Die Schaltfläche kann mit Standard-MAUI-Styling-Eigenschaften gestaltet werden, und Sie können zusätzliche visuelle Rückmeldungen wie Ladeanzeigen hinzufügen, während die PDF-Datei generiert wird. Dies gewährleistet eine reibungslose Benutzererfahrung während des PDF-Erstellungsprozesses.

Wie sieht die PDF-Ausgabe aus?

Bevor Sie Ihre PDF-Datei speichern, können Sie sie mit den für PdfDocument verfügbaren Methoden weiter bearbeiten. Sie können Seiten zusammenführen, aufteilen oder drehen. Sie können auch Anmerkungen und Lesezeichen zu Ihrem PDF hinzufügen. Außerdem können Sie PDF-Metadaten wie Autor, Titel und Schlüsselwörter festlegen, um die Organisation und Durchsuchbarkeit von Dokumenten zu verbessern.

Die generierte PDF-Datei behält die visuelle Hierarchie und das Styling Ihrer MAUI-Seite bei, einschließlich Schriftarten, Farben und Layout-Einschränkungen. Dies macht sie perfekt für die Erstellung druckbarer Versionen der Bildschirme Ihrer Anwendung oder die Erstellung von Berichten auf der Grundlage der Benutzeroberfläche Ihrer Anwendung.

Wo kann ich ein vollständiges MAUI-Beispielprojekt herunterladen?

Sie können den vollständigen Code für diesen Leitfaden herunterladen. Er kommt als gezippte Datei, die Sie in Visual Studio als .NET MAUI App-Projekt öffnen können. Das Beispielprojekt enthält alle erforderlichen Abhängigkeiten und demonstriert die besten Praktiken für die Integration von IronPDF in Ihre MAUI-Anwendungen.

Das Beispielprojekt ist so konfiguriert, dass es sowohl auf Windows- als auch auf macOS-Desktop-Plattformen funktioniert, um die plattformübergreifenden Fähigkeiten von MAUI und IronPDF zu demonstrieren. Sie enthält Beispiele für verschiedene Szenarien der PDF-Erzeugung und zeigt, wie verschiedene Seitenlayouts und Inhaltstypen gehandhabt werden können.

Laden Sie das vollständige MAUI-Beispielprojekt herunter

Entdecken Sie weitere Möglichkeiten auf unserer Tutorialseite hier: PDFs konvertieren . Vielleicht interessieren Sie sich auch für unsere Leitfäden zur PDF-Komprimierung, um die Qualität Ihrer generierten PDFs für die Webverteilung zu verbessern, oder für die Erstellung von PDFs auf Blazor-Servern für webbasierte PDF-Generierungsszenarien.

Häufig gestellte Fragen

Was ist .NET MAUI und wie hängt es mit der PDF-Erstellung zusammen?

.NET MAUI (Multi-platform App UI) ist ein plattformübergreifendes Framework für die Erstellung nativer Geräteanwendungen, das auf Xamarin.Forms aufbaut. IronPDF integriert sich in .NET MAUI-Anwendungen, um die PDF-Generierung aus XAML-Seiten mit der RenderContentPageToPdf-Methode zu ermöglichen, so dass Entwickler die Benutzeroberfläche ihrer MAUI-Anwendung in professionelle PDF-Dokumente umwandeln können.

Welche Plattformen werden für die PDF-Erzeugung in MAUI-Anwendungen unterstützt?

IronPDF unterstützt derzeit die PDF-Erzeugung in MAUI-Anwendungen auf Desktop- (Windows und macOS) und Web-Plattformen. Mobile Plattformen werden derzeit von IronPDF für die MAUI-PDF-Erzeugung nicht unterstützt.

Welches Erweiterungspaket ist für die Konvertierung von XAML in PDF in MAUI erforderlich?

Sie benötigen das IronPdf.Extensions.Maui-Paket zusammen mit dem IronPdf-Hauptpaket. Das Erweiterungspaket verbindet das XAML-basierte UI-Framework von MAUI mit den PDF-Generierungsfunktionen von IronPDF und wandelt MAUI ContentPage-Objekte in HTML um, das als PDF gerendert werden kann.

Wie konvertiere ich eine MAUI XAML-Seite in C# in PDF?

Die Konvertierung einer MAUI XAML-Seite in PDF mit IronPDF ist einfach. Sie können die Methode RenderContentPageToPdf mit nur einer Codezeile verwenden: var pdf = new IronPdf.ChromePdfRenderer().RenderContentPageToPdf().SaveAs('page.pdf'). Damit wird die Chrome-Rendering-Engine von IronPDF genutzt, um XAML-Layouts präzise in das PDF-Format zu übersetzen.

Was sind die grundlegenden Schritte zur Implementierung der PDF-Generierung in einer MAUI-Anwendung?

Der grundlegende Arbeitsablauf umfasst: 1) Herunterladen der C#-Bibliothek von IronPDF für MAUI, 2) Ändern der Datei MainPage.xaml.cs, um die Methode RenderContentPageToPdf zu verwenden, 3) Aktualisieren der Schaltfläche in MainPage.xaml, um die Funktion auszulösen, 4) Exportieren des PDF-Dokuments oder Anzeigen des Dokuments in der MAUI-App und 5) Optionales Herunterladen des MAUI-Beispielprojekts von IronPDF für einen schnellen Start.

Welche Rendering-Engine wird bei der PDF-Konvertierung verwendet?

IronPDF verwendet seine Chrome-Rendering-Engine für die PDF-Generierung in MAUI-Anwendungen. Dadurch wird sichergestellt, dass Ihre XAML-Layouts genau in das PDF-Format übersetzt werden, während die visuelle Integrität der Benutzeroberfläche Ihrer MAUI-Anwendung erhalten bleibt.

Curtis Chau
Technischer Autor

Curtis Chau hat einen Bachelor-Abschluss in Informatik von der Carleton University und ist spezialisiert auf Frontend-Entwicklung mit Expertise in Node.js, TypeScript, JavaScript und React. Leidenschaftlich widmet er sich der Erstellung intuitiver und ästhetisch ansprechender Benutzerschnittstellen und arbeitet gerne mit modernen Frameworks sowie der Erstellung gut strukturierter, optisch ansprechender ...

Weiterlesen
Bereit anzufangen?
Nuget Downloads 17,012,929 | Version: 2025.12 gerade veröffentlicht