Blazor Eğitimi ile PDF Dosyası Oluşturma

Visual Studio'da Yeni Proje Oluşturma

Başlamak için, Microsoft Visual Studio uygulamasını açın ve Dosya menüsünden "Yeni Proje" seçeneğini seçin. Sonra "Blazor Sunucu Uygulaması"nı seçin.

Visual Studio'da Yeni Proje Oluşturma

Bir proje adı girin ve bir dosya yolu seçin. Sonra, Oluştur düğmesine tıklayın.

Yeni Blazor Uygulamasının adı ve konumunun seçimi

İstenen .NET Çerçevesini seçin (bu eğitimde .NET 6.0 kullanacağız), aşağıdaki ekran görüntüsünde gösterildiği gibi:

.NET 6.0 Çerçevesi ile Visual Studio'da Yeni Proje Oluşturma

Microsoft Visual Studio, artık bu Blazor uygulaması için yapıyı oluşturacaktır.

Sonraki adım, bu yeni projeye IronPDF kütüphanesini eklemektir.

3.1 Visual Studio'nun NuGet Paket Yöneticisini Kullanma

Visual Studio, kütüphaneleri doğrudan projelere yüklemeye yardımcı olmak için NuGet Paket Yöneticisini sağlar. Aşağıdaki ekran resmi, NuGet Paket Yöneticisini nasıl açacağınızı göstermektedir.

Visual Studio'nun NuGet Paket Yöneticisine Erişim

Aşağıdaki ekran görüntüsünde gösterildiği gibi, "IronPDF" için Ara sekmesi altındaki arama alanını kullanarak arama yapın:

NuGet Paket Yöneticisi GUI'de IronPDF kütüphanesini arama

Yukarıdaki resimde, ilgili arama sonuçlarının listesini gösteriyor. Paketi projenize kurmak için gereken seçenekleri seçin.

3.2 Visual Studio Komut Satırını Kullanma

Visual Studio'da Araçlar > NuGet Paket Yöneticisi > Paket Yöneticisi Konsolu bölümüne gidin

Paket Yöneticisi Konsolu sekmesine aşağıdaki satırı girin:

Install-Package IronPdf

Paket şimdi mevcut projeye indirilecek ve yüklenecek.

NuGet Paket Yöneticisi Konsolu kullanarak IronPDF kütüphanesini kurma

3.3 NuGet Web Sitesinden Doğrudan İndirme

IronPDF kütüphanesini kurmanın üçüncü yolu, NuGet paketini doğrudan web sitesinden indirmektir.

IronPDF için NuGet web sitesine gidin.

• Sağda yer alan menüden "Paket İndir" seçeneğine tıklayın.
• İndirilen paketi dosya sisteminizde açın. Otomatik olarak yüklenecektir.
• Çözümü yeniden yükleyin ve projenizde kullanmaya başlayın.

3.4 IronPDF Web Sitesinden Doğrudan İndirme

IronPDF paketini doğrudan IronPDF web sitesinden indirin.

İndirdikten sonra, paketi projenize eklemek için bu adımları izleyin:

• Çözüm penceresinden projeyi sağ tıklayın.
• "Ekle" > "Referans" seçeneğini seçin ve daha önce indirdiğiniz kütüphanenin konumuna gidin.
• Kütüphaneyi referans olarak eklemek için Tamam'a tıklayın.

4. Blazor Sunucu Uygulaması'nda PDF Belgeleri Oluşturma

Bu eğitimdeki Blazor uygulaması, bir web sayfasının HTML içeriğini URL'siyle alıp PDF belgesine dönüştürmek için IronPDF kullanacaktır.

Projede yer alan .razor dosyasına aşağıdaki kaynak kodunu girin.

@using IronPdf

@code {
    /// <summary>
    /// This method exports data by converting a URL to a PDF file and initiating its download.
    /// </summary>
    public async Task ExportData()
    {
        try
        {
            string fileName = "Demo.pdf";
            var renderer = new ChromePdfRenderer();

            // Render the contents of the URL as a PDF document
            var pdf = renderer.RenderUrlAsPdf("https://localhost:7018/fetchdata");

            // Save the PDF using a JavaScript function
            await JSRuntime.InvokeVoidAsync("saveAsFile", fileName, Convert.ToBase64String(pdf.Stream.ToArray()));
        }
        catch (Exception ex)
        {
            // Handle any exceptions that may occur
            Console.Error.WriteLine($"Error in ExportData: {ex.Message}");
        }
    }
}

@using IronPdf

@code {
    /// <summary>
    /// This method exports data by converting a URL to a PDF file and initiating its download.
    /// </summary>
    public async Task ExportData()
    {
        try
        {
            string fileName = "Demo.pdf";
            var renderer = new ChromePdfRenderer();

            // Render the contents of the URL as a PDF document
            var pdf = renderer.RenderUrlAsPdf("https://localhost:7018/fetchdata");

            // Save the PDF using a JavaScript function
            await JSRuntime.InvokeVoidAsync("saveAsFile", fileName, Convert.ToBase64String(pdf.Stream.ToArray()));
        }
        catch (Exception ex)
        {
            // Handle any exceptions that may occur
            Console.Error.WriteLine($"Error in ExportData: {ex.Message}");
        }
    }
}

[using] ReadOnly Property code() As IronPdf
	''' <summary>
	''' This method exports data by converting a URL to a PDF file and initiating its download.
	''' </summary>
'INSTANT VB TODO TASK: Local functions are not converted by Instant VB:
'	public async Task ExportData()
'	{
'		try
'		{
'			string fileName = "Demo.pdf";
'			var renderer = New ChromePdfRenderer();
'
'			' Render the contents of the URL as a PDF document
'			var pdf = renderer.RenderUrlAsPdf("https://localhost:7018/fetchdata");
'
'			' Save the PDF using a JavaScript function
'			await JSRuntime.InvokeVoidAsync("saveAsFile", fileName, Convert.ToBase64String(pdf.Stream.ToArray()));
'		}
'		catch (Exception ex)
'		{
'			' Handle any exceptions that may occur
'			Console.@Error.WriteLine(string.Format("Error in ExportData: {0}", ex.Message));
'		}
'	}
End Property

Yukarıdaki kod parçacığı, HTML'den PDF belgeleri üretmek için iki yöntem kullanır. İlk yöntem, belirli bir URL'den HTML içeriğini indirip PDF formatına dönüştüren IronPDF'nin RenderUrlAsPdf yöntemidir.

İkinci yöntem, tarayıcının JavaScript motorunu bir JavaScript fonksiyonunu çağırmaya tetikleyen statik JSRuntime.InvokeVoidAsync yöntemidir ve bu, PDF içeriğini istemcinin dosya sistemine kaydeder.

Aşağıda bu JavaScript işlevi yer almaktadır:

<script type="text/javascript">
    /**
     * Saves the PDF data as a file on the client's system.
     * @param {string} filename - The name of the file to be created.
     * @param {string} bytesBase64 - The Base64 encoded string of the PDF data.
     */
    function saveAsFile(filename, bytesBase64) {
        if (navigator.msSaveBlob) {
            // Download the document in Microsoft Edge browser
            var data = window.atob(bytesBase64);
            var bytes = new Uint8Array(data.length);
            for (var i = 0; i < data.length; i++) {
                bytes[i] = data.charCodeAt(i);
            }
            var blob = new Blob([bytes.buffer], { type: "application/octet-stream" });
            navigator.msSaveBlob(blob, filename);
            window.navigator.msSaveOrOpenBlob(blob);
        }
        else {
            var link = document.createElement('a');
            link.download = filename;
            link.href = "data:application/octet-stream;base64," + bytesBase64;
            document.body.appendChild(link); // Needed for Firefox
            link.click();
            document.body.removeChild(link);
        }
    }
</script>

<script type="text/javascript">
    /**
     * Saves the PDF data as a file on the client's system.
     * @param {string} filename - The name of the file to be created.
     * @param {string} bytesBase64 - The Base64 encoded string of the PDF data.
     */
    function saveAsFile(filename, bytesBase64) {
        if (navigator.msSaveBlob) {
            // Download the document in Microsoft Edge browser
            var data = window.atob(bytesBase64);
            var bytes = new Uint8Array(data.length);
            for (var i = 0; i < data.length; i++) {
                bytes[i] = data.charCodeAt(i);
            }
            var blob = new Blob([bytes.buffer], { type: "application/octet-stream" });
            navigator.msSaveBlob(blob, filename);
            window.navigator.msSaveOrOpenBlob(blob);
        }
        else {
            var link = document.createElement('a');
            link.download = filename;
            link.href = "data:application/octet-stream;base64," + bytesBase64;
            document.body.appendChild(link); // Needed for Firefox
            link.click();
            document.body.removeChild(link);
        }
    }
</script>

Yukarıdaki JavaScript işlevi, Base64 verilerini Blazor'dan alır ve istemci tarafı konumuna kaydetmeden önce bir blob'a dönüştürür.

Alternatif olarak, ChromePdfRenderer sınıfından SaveAs yöntemi de PDF belgelerini tarayıcının yerel deposuna kaydetmek için kullanılabilir.