NET MAUI'de XAML nasıl PDF'ye dönüştürülür

Converting XAML to PDF in C# MAUI

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

IronPDF, yalnızca birkaç satır kodla .NET MAUI uygulamalarında XAML sayfalarını PDF'ye dönüştürmenizi sağlar. Bu RenderContentPageToPdf metodunu kullanarak, MAUI uygulamanızın kullanıcı arayüzünü masaüstü ve web platformları için profesyonel PDF belgelerine dönüştürebilirsiniz.

.NET MAUI (Çok platformlu Uygulama Kullanıcı Arayüzü) yerel cihaz uygulamaları oluşturmak için çapraz platform bir çerçevedir. Xamarin.Forms'tan türetilmiştir ve birleşik .NET 6 ekosisteminin bir parçasıdır. .NET uygulama geliştiricilerinin, masaüstü, web ve mobil platformlar için ortak kullanıcı arabirimi bileşenleri ve tek bir kod tabanı kullanarak uygulamalar oluşturmasına olanak tanır. MAUI ayrıca gerektiğinde platforma özgü kod ve kaynaklar eklemenizi sağlar.

IronPDF, MAUI sayfalarından PDF belgeleri oluşturmanıza olanak tanır, böylece bu uygulamalarda PDF dosyaları/sayfaları oluşturmayı mümkün kılar. İster Windows ister macOS üzerinde geliştiriyor olun, IronPDF tutarlı PDF oluşturma kabiliyetleri sunar. Ancak, IronPDF şu anda mobil platformları desteklememektedir.

MAUI uygulamalarındaki PDF oluşturma süreci, IronPDF'in Chrome render motorunu kullanır ve XAML düzenlerinizin PDF formatına doğru bir şekilde çevrilmesini sağlar. Bu, raporlar, faturalar veya MAUI uygulamanızın kullanıcı arayüzünün görsel bütünlüğünü koruması gereken belgeler oluşturmak için idealdir.

Hızlı Başlangıç: IronPDF ile .NET MAUI'de XAML'i PDF'ye Dönüştürme

IronPDF kullanarak .NET MAUI'de XAML sayfalarınızı PDF'ye dönüştürün. Sadece birkaç satır kodla, MAUI uygulamanızın içeriğini profesyonel kalitede PDF belgelerine dönüştürebilirsiniz. Bu kılavuz, IronPDF'in verimli render kabiliyetlerini kullanarak hızlıca başlamanız için basit bir örnek sunar. PDF oluşturmayı masaüstü ve web uygulamalarınıza sorunsuz bir şekilde entegre etmek için adım adım ilerleyin.

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

Minimal İş Akışı (5 adım)

  1. MAUI için IronPDF C# kütüphanesini indirin
  2. MainPage.xaml.cs dosyasını RenderContentPageToPdf metodunu kullanacak şekilde değiştirin
  3. MainPage.xaml dosyasındaki butonu yeni fonksiyonu tetikleyecek şekilde güncelleyin
  4. PDF belgesini dışa aktarın veya MAUI uygulamasında bir PDF görüntüleyici kullanarak görüntüleyin
  5. Hızlı bir başlangıç için örnek MAUI projesini indirin

MAUI ile IronPDF İçin Hangi Uzantı Paketine İhtiyacım Var?

IronPdf.Extensions.Maui paketi, IronPdf ana paketinin bir uzantısıdır. Bu bir uzantı olduğundan, IronPDF ana paketi, bir MAUI uygulamasının içerik sayfasını bir PDF belgesine render etmek için hala gereklidir. Bu uzantı paketi, MAUI'nin XAML tabanlı kullanıcı arayüzü çerçevesi ile IronPDF'in PDF oluşturma yetenekleri arasındaki boşluğu özel olarak kapatır.

Uzantı paketi, MAUI ContentPage nesnelerinin PDF olarak render edilebilecek HTML'ye dönüştürülmesini sağlar. MAUI sayfalarınızın düzenini ve stilini korurken, IronPDF'in gelişmiş özelliklerine, örneğin özel kenar boşluklarına, özel kağıt boyutlarına ve PDF sıkıştırmaya erişim sağlar.

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

Uzantı paketini yükledikten sonra, MAUI sayfalarınızı dönüştürmenin anahtarı olan RenderContentPageToPdf metoduna erişim sağlayacaksınız. Bu yöntem, performans için optimize edilmiştir ve dönüşüm sürecinde XAML düzenlerinizin görsel sadakatini korur.

Bir MAUI Sayfasını PDF Olarak Nasıl Render Ederim?

Hangi Kod Dosyasını İlk Olarak Değiştirmeliyim?

  • MainPage.xaml dosyasından onun kod dosyasına, MainPage.xaml.cs, gidin.
  • OnCounterClicked adlı işlevi PrintToPdf olarak değiştirin. Aşağıdaki kod örneğini kullanın.

MAUI sayfanızı PDF'ye çevirmek için RenderContentPageToPdf metodunu kullanın. Metoda, ChromePdfRenderer sınıfını örnekleyerek erişilebilir. Bu metod size PdfDocument nesnesi verecek olup, bu nesneyi SaveAs metodunu veya MAUI'de PDF Görüntüleme ile bir PDF görüntüleyici kullanarak kaydedebilir veya görüntüleyebilirsiniz.

ChromePdfRenderer sınıfı, RenderingOptions özelliği aracılığıyla geniş özelleştirme seçenekleri sunar. Sayfa kenar boşluklarını ayarlayabilir, kâğıt yönünü belirleyebilir, JavaScript çalıştırmayı etkinleştirebilir ve daha fazlasını yapabilirsiniz. Bu seçenekler, PDF çıktınızın tam olarak gereksinimlerinizi karşılamasını sağlar.

: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

Dahası, fark etmiş olabileceğiniz gibi, XAML'den görüntüleme de RenderingOptions içinde mevcut olan tüm özelliklere tam erişim sağlar. Bu, metin ve HTML başlıkları ve altbilgileri eklemeyi içerir. Ayrıca resim damgalayabilir, sayfa numaraları ekleyebilir ve hatta sayfanın boyutunu ve düzenini özelleştirebilirsiniz. Bu yöntemi kullanarak bir PDF oluşturduğunuzda tüm bu seçenekler mevcuttur.

RenderContentPageToPdf metodu varsayılan olarak asenkron olup Task<PdfDocument> döndürür. Bu, özellikle karışık düzenlerle uğraşırken veya aynı anda birden fazla PDF oluştururken faydalı olan bloke etmeyen PDF oluşturma sağlar. Yöntem, XAML görsel öğelerinin PDF eşdeğerlerine dönüşümünü, renkleri, yazı tiplerini ve yerleşim yapılarını koruyarak otomatik olarak yönetir.

XAML Dosyasında Hangi Değişiklikleri Yapmam Gerekiyor?

MainPage.xaml dosyasında, varsayılan OnCounterClicked işlevini yeni PrintToPdf işleviyle değiştirin. Bu düğmeye tıklamak, PrintToPdf metodunu çalıştıracak ve PDF oluşturacaktır. Bu basit değişiklik, MAUI uygulamanızı minimal kod değişiklikleriyle bir PDF oluşturucuya dönüştürür.

<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

Buton, standart MAUI stil özelliklerini kullanarak stillenebilir ve PDF oluşturulurken yükleme göstergeleri gibi ek görsel geri bildirimler ekleyebilirsiniz. Bu, PDF oluşturma süreci sırasında sorunsuz bir kullanıcı deneyimi sağlar.

Çıktı PDF Nasıl Görünür?

PDF dosyanızı kaydetmeden önce, PdfDocument için mevcut yöntemleri kullanarak daha fazla değişiklik yapabilirsiniz. Sayfaları birleştirin, ayırın veya döndürün. Ayrıca PDF'nize açıklamalar ve yer işaretleri ekleyebilirsiniz. Ek olarak, yazar, başlık ve anahtar kelimeler gibi PDF meta verilerini ayarlayarak belge organizasyonunu ve aranabilirliğini artırabilirsiniz.

Oluşturulan PDF, MAUI sayfanızın görsel hiyerarşisini ve stilini, yazı tipleri, renkler ve yerleşim kısıtlamaları dahil olmak üzere korur. Bu, uygulamanızın ekranlarının çıktısını almaya uygun ya da uygulamanızın kullanıcı arayüzüne dayalı raporlar oluşturmaya mükemmel bir şekilde uygundur.

Tam MAUI Örnek Projesini Nerede İndirebilirim?

Bu rehber için tamamlanmış kodu indirebilirsiniz. Açık bir Visual Studio'da bir .NET MAUI Uygulama projesi olarak açabileceğiniz sıkıştırılmış bir dosya ile birlikte gelir. Örnek proje, tüm gerekli bağımlılıkları içerir ve MAUI uygulamalarınıza IronPDF entegrasyonunu en iyi uygulamalar ile gösterir.

Örnek proje, hem Windows hem de macOS masaüstü platformlarında çalışacak şekilde yapılandırılmış olup, hem MAUI hem de IronPDF'nin çapraz platform yeteneklerini sergilemektedir. Çeşitli PDF oluşturma senaryolarının örneklerini içerir ve farklı sayfa düzenlerini ve içerik türlerini nasıl ele alacağınızı gösterir.

Tam MAUI Örnek Projesini İndirin

Daha fazla olasılığı dosyaları PDF'ye dönüştür eğitim sayfamızla keşfedin. PDF sıkıştırma kılavuzumuzu keşfetmek, web dağıtımı için oluşturduğunuz PDF'lerinizi iyileştirmek veya Blazor Sunucularında PDF oluşturma hakkında bir şeyler öğrenmek de ilginizi çekebilir.

Sıkça Sorulan Sorular

.NET MAUI nedir ve PDF oluşturmayla nasıl ilişkilidir?

.NET MAUI (Çok platformlu Uygulama UI), yerel cihaz uygulamaları oluşturmak için Xamarin.Forms'dan genişleyen, çapraz platform bir çerçevedir. IronPDF, .NET MAUI uygulamalarına entegre edilerek, RenderContentPageToPdf yöntemiyle XAML sayfalarından PDF oluşturmayı sağlar, geliştiricilerin MAUI uygulama arayüzlerini profesyonel PDF belgelerine dönüştürmesine izin verir.

MAUI uygulamalarında PDF oluşturma için hangi platformlar desteklenmektedir?

IronPDF, şu anda masaüstü (Windows ve macOS) ve web platformlarında MAUI uygulamalarında PDF oluşturmayı desteklemektedir. Mobil platformlar, şu anda IronPDF tarafından MAUI PDF oluşturma için desteklenmemektedir.

MAUI'de XAML'ı PDF'ye dönüştürmek için hangi genişletme paketi gereklidir?

IronPdf.Extensions.Maui paketi, ana IronPdf paketine ek olarak gereklidir. Genişletme paketi, özellikle MAUI'nin XAML tabanlı UI çerçevesini IronPDF'in PDF oluşturma yetenekleriyle birleştirir ve MAUI ContentPage nesnelerinin PDF olarak oluşturulabilecek HTML'ye dönüştürülmesini sağlar.

MAUI XAML sayfasını C#'ta PDF'ye nasıl dönüştürürüm?

IronPDF ile bir MAUI XAML sayfasını PDF'ye dönüştürmek basittir. Tek bir satır kodla RenderContentPageToPdf yöntemini kullanabilirsiniz: var pdf = new IronPdf.ChromePdfRenderer().RenderContentPageToPdf().SaveAs('page.pdf'). Bu, IronPDF'in Chrome işleme motorunu kullanarak XAML düzenlerini doğru bir şekilde PDF formatına çevrir.

MAUI uygulamasında PDF oluşturmayı uygulamak için temel adımlar nelerdir?

Temel iş akışı şunları içerir: 1) MAUI için IronPDF C# kütüphanesini indirin, 2) RenderContentPageToPdf yöntemini kullanmak için MainPage.xaml.cs dosyasını değiştirin, 3) Fonksiyonu tetiklemek için MainPage.xaml içindeki butonu güncelleyin, 4) PDF belgesini dışa aktarın veya MAUI uygulamasında görüntüleyin ve 5) İsteğe bağlı olarak IronPDF'in örnek MAUI projesini hızlı bir başlangıç için indirin.

PDF dönüştürme süreci hangi işleme motorunu kullanır?

IronPDF, MAUI uygulamalarında PDF oluşturma süreci için Chrome işleme motorunu kullanır. Bu, XAML düzenlerinizin, MAUI uygulamanızın kullanıcı arabiriminin görsel bütünlüğünü korurken doğru bir şekilde PDF formatına çevrilmesini sağlar.

Curtis Chau
Teknik Yazar

Curtis Chau, Bilgisayar Bilimleri alanında lisans derecesine sahiptir (Carleton Üniversitesi) ve Node.js, TypeScript, JavaScript ve React konularında uzmanlaşmış ön uç geliştirme üzerine uzmanlaşmıştır. Kullanıcı dostu ve estetik açıdan hoş arayüzler tasarlamaya tutkuyla bağlı olan Curtis, modern çerç...

Daha Fazlasını Oku
Başlamaya Hazır mısınız?
Nuget Indirmeler 18,332,619 | Sürüm: 2026.4 yeni yayınlandı
Still Scrolling Icon

Hala Kaydiriyor musunuz?

Hızlı bir kanit mi istiyorsunuz? PM > Install-Package IronPdf
bir örnek çalıştır HTML'nizin PDF olduğunu izleyin.