Wie man XAML in NET MAUI zu PDF konvertiert

Converting XAML to PDF in C# MAUI

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

IronPDF ermöglicht die Konvertierung von XAML-Seiten in PDF in .NET MAUI-Anwendungen mit nur wenigen Codezeilen. 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 Entwicklern von .NET-Anwendungen die Erstellung von Anwendungen für Desktop-, Web- und mobile Plattformen unter Verwendung gemeinsamer UI-Komponenten und einer einzigen Codebasis. Mit MAUI können Sie bei Bedarf auch plattformspezifischen Code und Ressourcen hinzufügen.

IronPDF ermöglicht die Erstellung von PDF-Dokumenten aus MAUI-Seiten, so dass die Erstellung von PDF-Dateien/Seiten in diesen Anwendungen möglich ist. 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 verwendet die Chrome-Rendering-Engine von IronPDF, die sicherstellt, 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 in PDF konvertieren mit IronPDF in .NET MAUI

Konvertieren Sie Ihre XAML-Seiten mit IronPDF in PDF in .NET MAUI. Mit nur wenigen Zeilen Code können Sie den Inhalt Ihrer MAUI-Anwendung in PDF-Dokumente in professioneller Qualität umwandeln. Dieser Leitfaden enthält ein einfaches Beispiel für einen schnellen Einstieg, das die effizienten Rendering-Funktionen von IronPDF nutzt. So können Sie die PDF-Erzeugung reibungslos in Ihre Desktop- und Webanwendungen 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. Download der IronPDF C#-Bibliothek für MAUI
  2. Ändern Sie die Datei MainPage.xaml.cs , um die Methode RenderContentPageToPdf zu verwenden.
  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 Start herunter

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

Das Paket IronPdf.Extensions.Maui 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-Erzeugungsfunktionen 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?

  • Gehe von der Datei MainPage.xaml zur zugehörigen Code-Datei MainPage.xaml.cs.
  • Ändern Sie die Funktion mit dem Namen OnCounterClicked in PrintToPdf. Verwenden Sie das folgende Codebeispiel.

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

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 haben Sie, wie Sie vielleicht bemerkt haben, durch das Rendern aus XAML vollen Zugriff auf alle Funktionen, die in RenderingOptions verfügbar sind. 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 ein 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. Durch Klicken dieser Schaltfläche wird die Methode PrintToPdf ausgeführt und die PDF-Datei erstellt. 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 mit den unter PdfDocument verfügbaren Methoden weitere Änderungen daran vornehmen. 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

Erkunden Sie weitere Möglichkeiten auf unserer Tutorial-Seite hier: PDFs konvertieren. Vielleicht interessieren Sie sich auch für unsere Leitfäden zur PDF-Komprimierung, um Ihre generierten PDFs für die Verbreitung im Internet zu verbessern, oder für die Erstellung von PDFs in Blazor Servern für webbasierte PDF-Erzeugungsszenarien.

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,803,474 | Version: 2026.3 gerade veröffentlicht
Still Scrolling Icon

Scrollst du immer noch?

Sie brauchen schnell einen Beweis? PM > Install-Package IronPdf
Führen Sie eine Probe aus Sehen Sie zu, wie Ihr HTML-Code in eine PDF-Datei umgewandelt wird.