IronPDF Kullanarak .NET MAUI'de PDF Dosyası Oluşturma

IronPDF Özellikleri

IronPDF, tarayıcıların üstesinden gelebileceği hemen hemen her görevin üstesinden gelebilen güçlü bir PDF dönüştürücüdür. Geliştiriciler için .NET kütüphanesi, PDF dosyaları oluşturmayı, okumayı ve manipüle etmeyi basitleştirir. IronPDF, HTML'yi PDF dosyalarına dönüştürmek için Google Chrome motorunu kullanır. Diğer web teknolojilerinin yanı sıra IronPDF, HTML, ASPX, Razor Sayfalarını IronPDF ile PDF'ye Dönüştürme ve MVC Görünümünü destekler. IronPDF, Microsoft .NET uygulamalarını (hem ASP.NET Web Uygulamaları hem de geleneksel Windows Uygulamaları) destekler. IronPDF, dikkat çekici PDF belgeleri oluşturmak için de kullanılabilir.

IronPDF, JavaScript ve CSS içeren HTML dosyalarından PDF dosyaları oluşturabilir.

Sadece HTML dosyalarını IronPDF ile PDF'ye dönüştürebilmekle kalmaz, aynı zamanda görüntü dosyalarını PDF'ye dönüştürebilirsiniz.

IronPDF, etkileşimli PDF belgeleri oluşturabilir, etkileşimli formları IronPDF ile doldurup gönderebilir, PDF belgelerini birleştirebilir ve ayırabilir, PDF belgelerinden metin ve görüntüler çıkarabilir, PDF belgelerinde metin arayabilir, PDF sayfalarını görüntülere dönüştürebilir, PDF'yi HTML'ye dönüştürebilir ve IronPrint kullanarak PDF belgelerini yazdırabilir.

IronPDF, bir URL'den belge oluşturabilir. Giriş formları için IronPDF kullanımı için, özelleştirilmiş ağ giriş kimlik bilgileri, kullanıcı ajanları, proxyler, çerezler, HTTP başlıkları ve form değişkenlerini de kullanmayı sağlar.

IronPDF, PDF belgelerini okuyabilen ve belge içerisindeki görüntüleri çıkarabilen bir kütüphanedir. PDF dosyalarına başlık ve alt başlık, metin, fotoğraflar, daha kolay gezinme için yer imleri, su işaretleri ve daha fazlasını dokümanlara eklememizi sağlar. Ayrıca yeni veya mevcut bir belgede sayfaları birleştirip ayırmamıza da olanak tanır. IronPDF, Acrobat görüntüleyici kullanmadan belgeleri PDF nesnelerine dönüştürebilecek yeteneğe sahiptir. CSS dosyasını bir PDF belgesine dönüştürmek ve CSS medya türü dosyalarını belgeler haline getirmek de mümkündür.

Visual Studio'da Yeni Proje Oluşturma

İlk olarak, hem Visual Studio Code hem de Visual Studio kullanarak bir proje oluşturun. Visual Studio Code kullanırken, proje türü şablonunu yüklemek için komut satırı aracını kullanmanız gerekmektedir.

Microsoft Visual Studio yazılımını açın ve Dosya menüsüne gidin. "Yeni proje"yi seçin ve yeni proje penceresinde ".NET MAUI Uygulaması"nı seçin. Bu makalede, PDF belgeleri oluşturup uygun bir yere kaydetmek için bir .NET MAUI Uygulaması kullanılacaktır.

Visual Studio'da yeni proje oluşturma

Proje adını girin ve ilgili metin kutusunda dosya yolunu seçin. Ardından, aşağıdaki ekran görüntüsündeki gibi Oluştur düğmesine tıklayın.

Projeyi yapılandırın

Visual Studio projesi şimdi .NET MAUI Uygulama platformuna uygun olarak seçilen uygulamanın yapısını oluşturacaktır. Şimdi uygulama oluşturup/çalıştırmak için kod eklemek üzere MainPage.cs dosyası açılacak.

MainPage.cs dosyasına kod ekleme

Daha sonra, kodu test etmek için kütüphaneyi yükleyin.

IronPDF Kütüphanesini Yükleme

IronPDF Kütüphanesi dört şekilde indirilebilir ve kurulabilir.

Bunlar su sekildedir:

• Visual Studio kullanarak.
• Visual Studio Komut Satirini Kullanma.
• NuGet web sitesinden doğrudan indirilebilir.
• IronPDF web sitesinden doğrudan indirin.

Install-Package IronPdf

IronPDF kullanarak bir .NET MAUI uygulamasında PDF oluşturma

Bir proje oluşturulduğunda, MainPage.xaml adlı otomatik oluşturulmuş bir dosya olacaktır. Bu dosya, .NET MAUI uygulamasının UI'sini koyacağınız yerdir.

Aşağıdaki kodu takip edin.

<?xml version="1.0" encoding="utf-8" ?>
<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             x:Class="MAUI_PDF.MainPage"
            >

    <ScrollView>
        <VerticalStackLayout
            Spacing="25"
            Padding="30,0"
            VerticalOptions="Center">

            <Image
                Source="dotnet_bot.png"
                SemanticProperties.Description="Cute .NET bot waving hi to you!"
                HeightRequest="200"
                HorizontalOptions="Center" />

            <Label
                Text="Welcome to IronPDF!"
                SemanticProperties.HeadingLevel="Level1"
                FontSize="32"
                HorizontalOptions="Center" />

            <Button
                x:Name="PdfBtn"
                Text="Click me to generate PDF"
                SemanticProperties.Hint="Click button to generate PDF"
                Clicked="GeneratePDF"
                HorizontalOptions="Center" />
        </VerticalStackLayout>
    </ScrollView>

</ContentPage>

<?xml version="1.0" encoding="utf-8" ?>
<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             x:Class="MAUI_PDF.MainPage"
            >

    <ScrollView>
        <VerticalStackLayout
            Spacing="25"
            Padding="30,0"
            VerticalOptions="Center">

            <Image
                Source="dotnet_bot.png"
                SemanticProperties.Description="Cute .NET bot waving hi to you!"
                HeightRequest="200"
                HorizontalOptions="Center" />

            <Label
                Text="Welcome to IronPDF!"
                SemanticProperties.HeadingLevel="Level1"
                FontSize="32"
                HorizontalOptions="Center" />

            <Button
                x:Name="PdfBtn"
                Text="Click me to generate PDF"
                SemanticProperties.Hint="Click button to generate PDF"
                Clicked="GeneratePDF"
                HorizontalOptions="Center" />
        </VerticalStackLayout>
    </ScrollView>

</ContentPage>

Yukarıdaki kod MainPage.xaml dosyasına eklendikten sonra, MainPage.xaml.cs dosyasını açın ve aşağıdaki yöntemi MainPage sınıfının içine dahil edin:

private void GeneratePDF(object sender, EventArgs e)
{
    ChromePdfRenderer renderer = new ChromePdfRenderer();
    var doc = renderer.RenderHtmlAsPdf("<h1>Hello IronPDF!</h1> <p>I'm using IronPDF MAUI!</p>");

    // Saves the memory stream as file.
    SaveService saveService = new SaveService();
    saveService.SaveAndView("IronPDF HTML string.pdf", "application/pdf", doc.Stream);
}

private void GeneratePDF(object sender, EventArgs e)
{
    ChromePdfRenderer renderer = new ChromePdfRenderer();
    var doc = renderer.RenderHtmlAsPdf("<h1>Hello IronPDF!</h1> <p>I'm using IronPDF MAUI!</p>");

    // Saves the memory stream as file.
    SaveService saveService = new SaveService();
    saveService.SaveAndView("IronPDF HTML string.pdf", "application/pdf", doc.Stream);
}

Private Sub GeneratePDF(ByVal sender As Object, ByVal e As EventArgs)
	Dim renderer As New ChromePdfRenderer()
	Dim doc = renderer.RenderHtmlAsPdf("<h1>Hello IronPDF!</h1> <p>I'm using IronPDF MAUI!</p>")

	' Saves the memory stream as file.
	Dim saveService As New SaveService()
	saveService.SaveAndView("IronPDF HTML string.pdf", "application/pdf", doc.Stream)
End Sub

GeneratePDF yöntemi, 'Merhaba, IronPDF!...' metnini içeren yeni bir PDF belgesi oluşturur ve belirtilen bir konumda kullanıcıların bilgisayarına kaydeder.

Yukarıdaki yöntemde, yeni bir ChromePdfRenderer nesnesi oluşturulur ve RenderHtmlAsPdf yöntemi çağrılarak "Merhaba IronPDF!" kelimelerini içeren yeni bir PDF belgesi üretilir. ..." bir HTML işaretleme dizesinden. Bir sonraki adımda, dosyanın kullanıcı cihazına kaydedilmesi işlemi SaveService adlı ayrı bir sınıfa devredilecektir. Bu sınıf bir sonraki adımda oluşturulacaktır.

Tam MainPage.xaml.cs dosyası aşağıda verilmiştir. Bir sonraki adıma devam etmeden önce dosya içeriğinin aşağıda gösterilenlerle eşleştiğinden emin olun:

// Change the namespace as desired, but make sure that all source files use this same namespace,
// or there will be errors!
namespace MAUI_IronPDF;    

// This namespace is required to make use of IronPDF functionality
using IronPdf;

public partial class MainPage : ContentPage
{
    public MainPage()
    {
        InitializeComponent();
    }

    private void GeneratePDF(object sender, EventArgs e)
    {
        ChromePdfRenderer renderer = new ChromePdfRenderer();
        var doc = renderer.RenderHtmlAsPdf("<h1>Hello IronPDF!</h1> <p>I'm using IronPDF MAUI!</p>");
        // Saves the memory stream as file.
        SaveService saveService = new SaveService();
        saveService.SaveAndView("IronPDF HTML string.pdf", "application/pdf", doc.Stream);
    }
}

// Change the namespace as desired, but make sure that all source files use this same namespace,
// or there will be errors!
namespace MAUI_IronPDF;    

// This namespace is required to make use of IronPDF functionality
using IronPdf;

public partial class MainPage : ContentPage
{
    public MainPage()
    {
        InitializeComponent();
    }

    private void GeneratePDF(object sender, EventArgs e)
    {
        ChromePdfRenderer renderer = new ChromePdfRenderer();
        var doc = renderer.RenderHtmlAsPdf("<h1>Hello IronPDF!</h1> <p>I'm using IronPDF MAUI!</p>");
        // Saves the memory stream as file.
        SaveService saveService = new SaveService();
        saveService.SaveAndView("IronPDF HTML string.pdf", "application/pdf", doc.Stream);
    }
}

Imports IronPdf

' Change the namespace as desired, but make sure that all source files use this same namespace,
' or there will be errors!
Namespace MAUI_IronPDF

	' This namespace is required to make use of IronPDF functionality

	Partial Public Class MainPage
		Inherits ContentPage

		Public Sub New()
			InitializeComponent()
		End Sub

		Private Sub GeneratePDF(ByVal sender As Object, ByVal e As EventArgs)
			Dim renderer As New ChromePdfRenderer()
			Dim doc = renderer.RenderHtmlAsPdf("<h1>Hello IronPDF!</h1> <p>I'm using IronPDF MAUI!</p>")
			' Saves the memory stream as file.
			Dim saveService As New SaveService()
			saveService.SaveAndView("IronPDF HTML string.pdf", "application/pdf", doc.Stream)
		End Sub
	End Class
End Namespace

Şimdi, projenin kök klasöründe SaveService.cs adlı yeni bir sınıf dosyası oluşturun ve aşağıdaki kaynak kodunu ekleyin:

// Change the namespace as desired, but make sure that all source files use this same namespace,
// or there will be errors!
namespace MAUI_IronPDF
{
    // SaveService partial class declaration ... this allows a layer of abstraction
    // as we implement the save file details specially for each platform on which this app will
    // operate! 
    public partial class SaveService
    {
        public void SaveAndView(string filename, string contentType, MemoryStream stream)
        {
            SaveFile(filename, contentType, stream);
        }

        // Additional partial files will provide implementations for this method specifically.
        partial void SaveFile(string filename, string contentType, MemoryStream stream);
    }
}

// Change the namespace as desired, but make sure that all source files use this same namespace,
// or there will be errors!
namespace MAUI_IronPDF
{
    // SaveService partial class declaration ... this allows a layer of abstraction
    // as we implement the save file details specially for each platform on which this app will
    // operate! 
    public partial class SaveService
    {
        public void SaveAndView(string filename, string contentType, MemoryStream stream)
        {
            SaveFile(filename, contentType, stream);
        }

        // Additional partial files will provide implementations for this method specifically.
        partial void SaveFile(string filename, string contentType, MemoryStream stream);
    }
}

' Change the namespace as desired, but make sure that all source files use this same namespace,
' or there will be errors!
Namespace MAUI_IronPDF
	' SaveService partial class declaration ... this allows a layer of abstraction
	' as we implement the save file details specially for each platform on which this app will
	' operate! 
	Partial Public Class SaveService
		Public Sub SaveAndView(ByVal filename As String, ByVal contentType As String, ByVal stream As MemoryStream)
			SaveFile(filename, contentType, stream)
		End Sub

		' Additional partial files will provide implementations for this method specifically.
		Partial Private Sub SaveFile(ByVal filename As String, ByVal contentType As String, ByVal stream As MemoryStream)
		End Sub
	End Class
End Namespace

Kullanıcı cihazlarındaki içeriği kaydetmenin uygulama detayları her platformda (Windows, Android, macOS, vb.) farklı olduğundan, uygulamanın destekleyeceği her cihaz türü için platforma özgü kod yazmak gereklidir. Bunu mümkün kılmak için, SaveService'yi (soyutlama amacıyla) bir parsiyel sınıf olarak tanımlıyoruz ve içinde SaveAndView adlı bir parsiyel yöntem yer alıyor. Bunu takiben, bu yöntemin uygulaması, Solutions Explorer içinde Platformlar klasörü içinde iç içe geçmiş bir veya daha fazla klasör için ayrı bir SaveService.cs parsiyel sınıfta tanımlanacaktır (aşağıdaki görüntüye bakın):

Çapraz platformu uygulamak için klasör yapısı

Basitlik açısından, bu eğitimde yalnızca Windows platformu için bahsedilen kısmi dosya tanımlanacaktır. Windows platform klasörünün altında, aşağıda gösterilen kodu içeren yeni bir SaveService.cs dosyası oluşturun:

using Windows.Storage;
using Windows.Storage.Pickers;
using Windows.Storage.Streams;
using Windows.UI.Popups;

namespace MAUI_IronPDF;

public partial class SaveService
{
    async partial void SaveFile(string filename, string contentType, MemoryStream stream)
    {
        StorageFile stFile;
        string extension = Path.GetExtension(filename);
        // Gets process windows handle to open the dialog in application process.
        IntPtr windowHandle = System.Diagnostics.Process.GetCurrentProcess().MainWindowHandle;
        if (!Windows.Foundation.Metadata.ApiInformation.IsTypePresent("Windows.Phone.UI.Input.HardwareButtons"))
        {
            // Creates file save picker to save a file.
            FileSavePicker savePicker = new();
            savePicker.DefaultFileExtension = ".pdf";
            savePicker.SuggestedFileName = filename;
            // Saves the file as PDF file.
            savePicker.FileTypeChoices.Add("PDF", new List<string>() { ".pdf" });

            WinRT.Interop.InitializeWithWindow.Initialize(savePicker, windowHandle);
            stFile = await savePicker.PickSaveFileAsync();
        }
        else
        {
            StorageFolder local = ApplicationData.Current.LocalFolder;
            stFile = await local.CreateFileAsync(filename, CreationCollisionOption.ReplaceExisting);
        }
        if (stFile != null)
        {
            using (IRandomAccessStream zipStream = await stFile.OpenAsync(FileAccessMode.ReadWrite))
            {
                // Writes compressed data from memory to file.
                using Stream outstream = zipStream.AsStreamForWrite();
                outstream.SetLength(0);
                // Saves the stream as file.
                byte [] buffer = stream.ToArray();
                outstream.Write(buffer, 0, buffer.Length);
                outstream.Flush();
            }
            // Create message dialog box.
            MessageDialog msgDialog = new("Do you want to view the document?", "File has been created successfully");
            UICommand yesCmd = new("Yes");
            msgDialog.Commands.Add(yesCmd);
            UICommand noCmd = new("No");
            msgDialog.Commands.Add(noCmd);

            WinRT.Interop.InitializeWithWindow.Initialize(msgDialog, windowHandle);

            // Showing a dialog box.
            IUICommand cmd = await msgDialog.ShowAsync();
            if (cmd.Label == yesCmd.Label)
            {
                // Launch the saved file.
                await Windows.System.Launcher.LaunchFileAsync(stFile);
            }
        }
    }
}

using Windows.Storage;
using Windows.Storage.Pickers;
using Windows.Storage.Streams;
using Windows.UI.Popups;

namespace MAUI_IronPDF;

public partial class SaveService
{
    async partial void SaveFile(string filename, string contentType, MemoryStream stream)
    {
        StorageFile stFile;
        string extension = Path.GetExtension(filename);
        // Gets process windows handle to open the dialog in application process.
        IntPtr windowHandle = System.Diagnostics.Process.GetCurrentProcess().MainWindowHandle;
        if (!Windows.Foundation.Metadata.ApiInformation.IsTypePresent("Windows.Phone.UI.Input.HardwareButtons"))
        {
            // Creates file save picker to save a file.
            FileSavePicker savePicker = new();
            savePicker.DefaultFileExtension = ".pdf";
            savePicker.SuggestedFileName = filename;
            // Saves the file as PDF file.
            savePicker.FileTypeChoices.Add("PDF", new List<string>() { ".pdf" });

            WinRT.Interop.InitializeWithWindow.Initialize(savePicker, windowHandle);
            stFile = await savePicker.PickSaveFileAsync();
        }
        else
        {
            StorageFolder local = ApplicationData.Current.LocalFolder;
            stFile = await local.CreateFileAsync(filename, CreationCollisionOption.ReplaceExisting);
        }
        if (stFile != null)
        {
            using (IRandomAccessStream zipStream = await stFile.OpenAsync(FileAccessMode.ReadWrite))
            {
                // Writes compressed data from memory to file.
                using Stream outstream = zipStream.AsStreamForWrite();
                outstream.SetLength(0);
                // Saves the stream as file.
                byte [] buffer = stream.ToArray();
                outstream.Write(buffer, 0, buffer.Length);
                outstream.Flush();
            }
            // Create message dialog box.
            MessageDialog msgDialog = new("Do you want to view the document?", "File has been created successfully");
            UICommand yesCmd = new("Yes");
            msgDialog.Commands.Add(yesCmd);
            UICommand noCmd = new("No");
            msgDialog.Commands.Add(noCmd);

            WinRT.Interop.InitializeWithWindow.Initialize(msgDialog, windowHandle);

            // Showing a dialog box.
            IUICommand cmd = await msgDialog.ShowAsync();
            if (cmd.Label == yesCmd.Label)
            {
                // Launch the saved file.
                await Windows.System.Launcher.LaunchFileAsync(stFile);
            }
        }
    }
}

Imports Windows.Storage
Imports Windows.Storage.Pickers
Imports Windows.Storage.Streams
Imports Windows.UI.Popups

Namespace MAUI_IronPDF

	Partial Public Class SaveService
		Private Async Sub SaveFile(ByVal filename As String, ByVal contentType As String, ByVal stream As MemoryStream)
			Dim stFile As StorageFile
			Dim extension As String = Path.GetExtension(filename)
			' Gets process windows handle to open the dialog in application process.
			Dim windowHandle As IntPtr = System.Diagnostics.Process.GetCurrentProcess().MainWindowHandle
			If Not Windows.Foundation.Metadata.ApiInformation.IsTypePresent("Windows.Phone.UI.Input.HardwareButtons") Then
				' Creates file save picker to save a file.
				Dim savePicker As New FileSavePicker()
				savePicker.DefaultFileExtension = ".pdf"
				savePicker.SuggestedFileName = filename
				' Saves the file as PDF file.
				savePicker.FileTypeChoices.Add("PDF", New List(Of String)() From {".pdf"})

				WinRT.Interop.InitializeWithWindow.Initialize(savePicker, windowHandle)
				stFile = Await savePicker.PickSaveFileAsync()
			Else
				Dim local As StorageFolder = ApplicationData.Current.LocalFolder
				stFile = Await local.CreateFileAsync(filename, CreationCollisionOption.ReplaceExisting)
			End If
			If stFile IsNot Nothing Then
				Using zipStream As IRandomAccessStream = Await stFile.OpenAsync(FileAccessMode.ReadWrite)
					' Writes compressed data from memory to file.
					Using outstream As Stream = zipStream.AsStreamForWrite()
						outstream.SetLength(0)
						' Saves the stream as file.
						Dim buffer() As Byte = stream.ToArray()
						outstream.Write(buffer, 0, buffer.Length)
						outstream.Flush()
					End Using
				End Using
				' Create message dialog box.
				Dim msgDialog As New MessageDialog("Do you want to view the document?", "File has been created successfully")
				Dim yesCmd As New UICommand("Yes")
				msgDialog.Commands.Add(yesCmd)
				Dim noCmd As New UICommand("No")
				msgDialog.Commands.Add(noCmd)

				WinRT.Interop.InitializeWithWindow.Initialize(msgDialog, windowHandle)

				' Showing a dialog box.
				Dim cmd As IUICommand = Await msgDialog.ShowAsync()
				If cmd.Label = yesCmd.Label Then
					' Launch the saved file.
					Await Windows.System.Launcher.LaunchFileAsync(stFile)
				End If
			End If
		End Sub
	End Class
End Namespace

MAUI uygulamasını derleyip çalıştırın. Aşağıda gösterilen arabirim içeren bir pencere görünecektir:

MAUI Uygulamasının UI'si

"PDF Oluştur" düğmesine tıklayın. Birkaç saniye sonra, oluşturulan PDF dosyasının konumunu seçmek için bir açılır pencere görünecektir.

PDF dosyasını kaydetmek için bir konum seçin

Sonuç

IronPDF, PDF'leri oluşturma, okuma, düzenleme ve biçimlendirme konularında en sık kullanılan PDF dönüştürücü kütüphanelerinden biridir. IronPDF kütüphanesi, verilen bir URL'i PDF dosyasına dönüştürmeye yardımcı olacak bir tarayıcı motoru, HTML dizelerine CSS ekleyip bunları PDF dosyalarına dönüştürme ve ayrıca PDF formları doldurma gibi birçok fayda ve işlev sunar. IronPDF'nin tüm özellikleri tek bir kütüphane içinde yer almaktadır.

IronPDF, çeşitli fiyat yapıları ile gelir. IronPDF için temel fiyat $799'dan başlamaktadır. Ürün desteği ve güncellemeleri de bir yıllık ücret karşılığında sunulmaktadır. Telif ücretsiz yeniden dağıtim kapsami de bir ek ürün olarak satın alınabilir.

Özetle, IronPDF önerilmektedir, çünkü PDF'lerle çalışan geliştiriciler için mükemmel bir performans ve çok sayıda özellik sunmaktadır. Evrensel platformlar olan .NET MAUI'nin desteklediği evrensel platformlara destek verir. IronPDF kütüphanesinin geniş yelpazesi ve birçok özelliğini tam olarak kullanmanızı sağlayacak mükemmel bir yardım ve dokümantasyonla birlikte gelir.