Cómo convertir XAML a PDF en NET MAUI

How to Convert XAML to PDF in MAUI

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

.NET MAUI (Multi-platform App UI) es un framework multiplataforma para crear aplicaciones nativas de dispositivos. Se extiende desde Xamarin.Forms y es parte del ecosistema unificado de .NET 6. Permite a los desarrolladores de aplicaciones .NET crear aplicaciones para plataformas de escritorio, web y móviles utilizando componentes comunes de la interfaz de usuario y un solo código base. MAUI también le permite agregar código y recursos específicos de la plataforma cuando sea necesario.

IronPdf le permite generar documentos PDF a partir de páginas MAUI, haciendo posible la creación de archivos/páginas PDF en estas aplicaciones. Sin embargo, IronPdf actualmente no admite plataformas móviles.

Inicio rápido: Convertir XAML a PDF con IronPDF en .NET MAUI

Convierta fácilmente sus páginas XAML a PDF en .NET MAUI utilizando IronPDF. Con solo unas pocas líneas de código, puede transformar el contenido de la aplicación MAUI en documentos PDF de calidad profesional. Esta guía proporciona un ejemplo sencillo para comenzar rápidamente, utilizando las capacidades eficientes de renderización de IronPDF. Siga para integrar perfectamente la generación de PDF en sus aplicaciones de escritorio y web, mejorando la experiencia de sus usuarios con facilidad.

Nuget IconGet started making PDFs with NuGet now:

  1. Install IronPDF with NuGet Package Manager

    PM > Install-Package IronPdf

  2. Copy and run this code snippet.

    var pdf = new IronPdf.ChromePdfRenderer().RenderContentPageToPdf<MainPage,App>().SaveAs("page.pdf");
  3. Deploy to test on your live environment

    Start using IronPDF in your project today with a free trial
    arrow pointer
class="hsg-featured-snippet">

Flujo de trabajo mínimo (5 pasos)

  1. Descargue la biblioteca IronPdf C# para MAUI
  2. Modifique el archivo MainPage.xaml.cs para usar el método RenderContentPageToPdf
  3. Actualice el botón en el archivo MainPage.xaml para activar la nueva función
  4. Exporte el documento PDF o véalo en la aplicación MAUI usando un visor de PDF
  5. Descargue el proyecto de muestra de MAUI para un inicio rápido

Paquete de extensión IronPdf

El paquete IronPdf.Extensions.Maui es la extensión del paquete principal IronPdf. Dado que es una extensión, aún se necesita el paquete principal IronPdf para renderizar la página de contenido de una aplicación MAUI a un documento PDF.

Install-Package IronPdf.Extensions.Maui
class="products-download-section">
data-modal-id="trial-license-after-download">
class="product-image"> C# NuGet Library for PDF
class="product-info">

Instalar con NuGet

class="copy-nuget-row">
Install-Package IronPdf.Extensions.Maui
class="copy-button">
class="nuget-link">nuget.org/packages/IronPdf.Extensions.Maui/

Renderizar página MAUI a PDF

Editar archivo MainPage.xaml.cs

  • Vaya desde el archivo MainPage.xaml a su archivo de código, MainPage.xaml.cs.
  • Cambie la función llamada OnCounterClicked a PrintToPdf. Use el siguiente ejemplo de código.

Para convertir su página MAUI en un PDF, use el método RenderContentPageToPdf. Se puede acceder al método instanciando la clase ChromePdfRenderer. Este método le dará un objeto PdfDocument, que puede guardar o ver usando el método SaveAs o un visor de PDF con Ver PDFs en MAUI.

Por favor notaEl método RenderContentPageToPdf aún no admite el enlace de datos.

: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

Además, como puede haber notado, la renderización desde XAML también le brinda acceso completo a todas las funciones disponibles en RenderingOptions. Esto incluye agregar encabezados y pies de página de texto y HTML. You can also stamp images, add page numbers, and even customize the size and layout of the page. Todas estas opciones están disponibles cuando utiliza este método para crear un PDF.

Editar archivo MainPage.xaml

En el archivo MainPage.xaml, reemplace la función OnCounterClicked predeterminada con la nueva función PrintToPdf. Hacer clic en este botón ejecutará el método PrintToPdf y creará el PDF.

<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

PDF de salida

Antes de guardar su archivo PDF, puede hacer más cambios en él usando los métodos disponibles en PdfDocument. Puede fusionar páginas, dividirlas o rotarlas. You can also add annotations and bookmarks to your PDF.

Descargar proyecto de aplicación .NET MAUI

Puede descargar el código completo de esta guía. Viene como un archivo comprimido que puede abrir en Visual Studio como un proyecto de aplicación .NET MAUI.

Descargar el proyecto completo de muestra de MAUI

¿Listo para ver qué más puedes hacer? Consulta nuestra página de tutoriales aquí: Convertir PDFs

Preguntas Frecuentes

¿Cómo puedo convertir una página XAML a PDF en .NET MAUI?

Puede convertir una página XAML a PDF en .NET MAUI usando la biblioteca IronPdf. Primero, descargue la biblioteca IronPdf C# para MAUI y modifique el archivo MainPage.xaml.cs para usar el método RenderContentPageToPdf. Reemplace la función predeterminada en el archivo MainPage.xaml con la función PrintToPdf para permitir la creación de PDF a través de un clic en el botón.

¿Qué limitaciones existen para usar IronPdf con .NET MAUI?

Actualmente, IronPdf solo admite la generación de PDFs desde aplicaciones MAUI para plataformas de escritorio y web, no para plataformas móviles. Esto significa que la biblioteca se puede usar con aplicaciones MAUI que se ejecutan en Windows, macOS y entornos web.

¿Cuál es el propósito del paquete IronPdf.Extensions.Maui?

El paquete IronPdf.Extensions.Maui amplía la funcionalidad del paquete principal de IronPdf, permitiéndole renderizar las páginas de contenido de una aplicación MAUI en documentos PDF con opciones de renderizado avanzadas, como la adición de encabezados, pies de página y números de página.

¿Cómo puede ver o guardar un PDF generado en una aplicación MAUI?

Después de generar el PDF utilizando la clase ChromePdfRenderer en IronPdf, puede ver o guardar el objeto PdfDocument utilizando el método SaveAsAsync, especificando la ruta de archivo deseada para el almacenamiento.

¿Puedo personalizar el diseño del PDF generado desde una página MAUI?

Sí, puede personalizar el diseño del PDF generado utilizando características de IronPdf como modificar el tamaño de la página, la orientación, y agregar texto personalizado, encabezados HTML, pies de página y números de página.

¿Qué cambios son necesarios en el archivo MainPage.xaml para la conversión a PDF?

En el archivo MainPage.xaml, necesita reemplazar la función predeterminada OnCounterClicked con la función PrintToPdf. Este cambio habilitará el botón para activar el método PrintToPdf, facilitando la creación de PDF.

¿Existe un proyecto de muestra disponible para convertir páginas MAUI a PDF?

Sí, un proyecto de muestra completo de MAUI está disponible para descarga, proporcionando una guía de código comprensiva en formato de archivo comprimido. Este ejemplo se puede abrir en Visual Studio como un proyecto de aplicación .NET MAUI, ayudándole a implementar funcionalidades de PDF en sus aplicaciones MAUI.

¿Qué funcionalidades ofrece la clase PdfDocument?

La clase PdfDocument de IronPdf ofrece funcionalidades como la fusión de páginas, su división, rotación, y la adición de anotaciones y marcadores para mejorar la interactividad y utilidad de sus PDFs.

¿IronPdf es compatible con .NET 10 y qué significa eso para los desarrolladores de MAUI?

Sí, IronPdf es totalmente compatible con .NET 10, incluidos los proyectos MAUI. Esto significa que puede usar IronPdf en aplicaciones MAUI .NET 10 sin necesidad de soluciones alternativas ni API obsoletas. Es compatible con las últimas mejoras de .NET y .NET 10 ahora es una versión con soporte a largo plazo (LTS).

Chaknith Bin
Ingeniero de Software
Chaknith trabaja en IronXL e IronBarcode. Tiene un profundo conocimiento en C# y .NET, ayudando a mejorar el software y apoyar a los clientes. Sus conocimientos derivados de las interacciones con los usuarios contribuyen a mejores productos, documentación y experiencia en general.
¿Listo para empezar?
Nuget Descargas 16,154,058 | Versión: 2025.11 recién lanzado