ASP.NET Kullanarak C#'da PDF Nasıl Oluşturulur

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"yi seçin. Daha sonra, "Blazor Sunucu Uygulaması"nı seçin.

Visual Studio'da Yeni Proje Oluşturma

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

Yeni Blazor Uygulamasının Adını ve Konumunu Seçme

İstenilen .NET Çerçevesini seçin (bu eğitimde .NET 6.0 kullanacağız), aşağıdaki ekranda gösterildiği gibi:

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

Microsoft Visual Studio, bu Blazor uygulamasının yapısını şimdi oluşturacak.

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

3.1 Visual Studio'nun NuGet Paket Yöneticisi'ni Kullanarak

Visual Studio, kütüphaneleri doğrudan projelere yüklemeyi desteklemek için NuGet Paket Yöneticisi sağlar. Aşağıdaki ekran görüntüsü, NuGet Paket Yöneticisi'ni nasıl açacağınızı gösterir.

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

Aşağıdaki ekranda gösterildiği gibi, "IronPDF" araması yapmak için Gözat sekmesinin altındaki arama alanını kullanın:

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

Yukarıdaki resim, ilgili arama sonuçlarının listesini göstermektedir. Projenize paketi yüklemek için gereken seçenekleri seçin.

3.2 Visual Studio Komut Satırını Kullanarak

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, şu anki projeye indirilecek ve yüklenecek.

NuGet Paket Yöneticisi Konsolu'nu kullanarak IronPDF kütüphanesini yükleme

3.3 NuGet Web Sitesinden Doğrudan İndirerek

IronPDF kütüphanesini yüklemenin üçüncü yolu, NuGet paketini web sitesinden doğrudan indirmektir.

IronPDF NuGet web sitesine gidin.

• Sağ taraftaki menüden "Paket İndir" seçeneğine tıklayın.
• Dosya sisteminizde indirilen paketi açın. Otomatik olarak yüklenecek.
• Çözümü yeniden yükleyin ve projenizde kullanmaya başlayın.

3.4 IronPDF Web Sitesinden Doğrudan İndirerek

IronPDF web sitesini ziyaret ederek IronPDF paketini doğrudan indirin.

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

• Çözüm penceresinden projeye 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şturun

Bu eğitimdeki Blazor uygulaması, bir web sayfasının URL üzerinden HTML içeriğini IronPDF kullanarak alacak ve bunu PDF belgesine dönüştürecektir.

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 oluşturmak için iki yöntem kullanır. İlk yöntem, verilen bir URL'den HTML içeriğini indirip PDF formatına dönüştüren IronPDF'nin RenderUrlAsPdf metodudur.

İkinci yöntem ise, PDF içeriğini istemcinin dosya sistemine kaydeden web sayfası kapsamında bir JavaScript fonksiyonunu çalıştırmak için bir tarayıcının JavaScript motorunu tetikleyen statik JSRuntime.InvokeVoidAsync metodudur.

Bu JavaScript fonksiyonu aşağıda dahil edilmiştir:

<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 fonksiyonu, Blazor'dan Base64 verilerini alır ve bunu müşteri tarafı konumuna kaydetmeden önce bir blob'ye dönüştürür.

Alternatif olarak, SaveAs metodunu ve ChromePdfRenderer sınıfından PDF belgelerini tarayıcının yerel depolamasına kaydetmek için de kullanılabilir.