Ünlü bir C# kütüphanesi olan IronPDF, Blazor uygulamalarıyla çalışır. Bu inceleme, IronPDF'yi bir Blazor uygulamasında PDF raporunu gömmek için nasıl kullanacağınız konusunda size rehberlik edecek ve entegrasyonunun ve etkinliğinin sorunsuz bir şekilde olduğunu gösterecektir.

1. IronPDF Özellikleri

Geliştiriciler, güçlü IronPDF .NET PDF kütüphanesi sayesinde hızla bir PDF belgesi oluşturabilir, okuyabilir ve işleyebilir. IronPDF, yerleşik bir Chrome motoruna sahiptir ve bol miktarda pratik ve güçlü yetenekler sunar. Bunlar arasında HTML5, JavaScript, CSS ve görüntüleri PDF'ye dönüştürme, PDF belgelerine benzersiz başlıklar ve altbilgiler ekleme, ve web tarayıcısında göründüğü gibi hassas PDF oluşturma becerisi bulunmaktadır. IronPDF, HTML, ASPX, Razor Pages ve MVC çatıları dahil çeşitli web teknolojilerini destekler.

IronPDF'nin temel özellikleri şunlardır:

• IronPDF, .NET C# uygulamaları içinde PDF dosyalarının oluşturulması ve değiştirilmesi üzerinde tam kontrol sunar
• IronPDF, belirli Kullanıcı-Aracısı, Proxy, Başlık ve Çerez yapılandırmalarını kullanarak web sayfalarının URL'den PDF dosyaları oluşturabilir.
• IronPDF, form değişkenlerini kullanarak giriş formları arkasında konumlanmış web sayfaları için PDF dosyaları oluşturabilir
• IronPDF, mevcut PDF dosyalarından fotoğraflar çıkarabilir ve/veya kaldırabilir
• IronPDF, PDF belgelerine metin, fotoğraflar, yer imleri, filigranlar ve diğer unsurlar ekleyebilir
• IronPDF, bir veya daha fazla PDF belgesinin sayfalarını birleştirmeyi ve ayırmayı kolaylaştırır.
• IronPDF, JavaScript, CSS ve medya dosyaları gibi web sayfası varlıklarını işleyebilir ve tarayıcıda görüneceği şekilde PDF belgelerine dönüştürebilir.
• IronPDF, .NET Core, .NET Standard ve benzeri dahil tüm .NET Çerçevelerini destekler.

2. Blazor Nedir?

Blazor, C# ve HTML kullanarak Web Yığınını kullanarak istemci tarafı Web Uygulamaları yaratmayı mümkün kılan bir Web Uygulama Çerçevesidir.

Web Yığını uygulamaları, neredeyse yerel hızda çalışabilen bir ikili talimat formatında tarayıcıya gönderilir. Bu, C# gibi dillerin tarayıcı içinde çalışması için yeni potansiyeller yaratmıştır.

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. IronPDF Kütüphanesini Yükleyin

IronPDF Kütüphanesi dört yolla indirilebilir ve kurulabilir:

• Visual Studio'nun NuGet Paket Yöneticisi'ni kullanarak
• Visual Studio'nun Komut Satırını kullanarak
• NuGet web sitesinden doğrudan indirme
• IronPDF web sitesinden doğrudan indirerek

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}");
        }
    }
}

@Code
    ' <summary>
    ' This method exports data by converting a URL to a PDF file and initiating its download.
    ' </summary>
    Public Async Function ExportData() As Task
        Try
            Dim fileName As String = "Demo.pdf"
            Dim renderer As New ChromePdfRenderer()

            ' Render the contents of the URL as a PDF document
            Dim 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 ex As Exception
            ' Handle any exceptions that may occur
            Console.Error.WriteLine($"Error in ExportData: {ex.Message}")
        End Try
    End Function

@Code
    ' <summary>
    ' This method exports data by converting a URL to a PDF file and initiating its download.
    ' </summary>
    Public Async Function ExportData() As Task
        Try
            Dim fileName As String = "Demo.pdf"
            Dim renderer As New ChromePdfRenderer()

            ' Render the contents of the URL as a PDF document
            Dim 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 ex As Exception
            ' Handle any exceptions that may occur
            Console.Error.WriteLine($"Error in ExportData: {ex.Message}")
        End Try
    End Function

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.

5. HTML Dizelerinden PDF Belgesi Oluşturun

Aşağıdaki kod parçacığı, bir HTML dizesini belgeye nasıl dönüştüreceğini gösterir.

@using IronPdf

@code {
    /// <summary>
    /// Demonstrates turning an HTML string into a PDF document.
    /// </summary>
    public void GeneratePdfFromHtmlString()
    {
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderHtmlAsPdf("<h1>Hello world!!</h1>");
        
        // You can save the generated PDF locally
        pdf.SaveAs("HelloWorld.pdf");
    }
}

@using IronPdf

@code {
    /// <summary>
    /// Demonstrates turning an HTML string into a PDF document.
    /// </summary>
    public void GeneratePdfFromHtmlString()
    {
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderHtmlAsPdf("<h1>Hello world!!</h1>");
        
        // You can save the generated PDF locally
        pdf.SaveAs("HelloWorld.pdf");
    }
}

@Using IronPdf

@Code
    ''' <summary>
    ''' Demonstrates turning an HTML string into a PDF document.
    ''' </summary>
    Public Sub GeneratePdfFromHtmlString()
        Dim renderer As New ChromePdfRenderer()
        Dim pdf = renderer.RenderHtmlAsPdf("<h1>Hello world!!</h1>")
        
        ' You can save the generated PDF locally
        pdf.SaveAs("HelloWorld.pdf")
    End Sub

@Using IronPdf

@Code
    ''' <summary>
    ''' Demonstrates turning an HTML string into a PDF document.
    ''' </summary>
    Public Sub GeneratePdfFromHtmlString()
        Dim renderer As New ChromePdfRenderer()
        Dim pdf = renderer.RenderHtmlAsPdf("<h1>Hello world!!</h1>")
        
        ' You can save the generated PDF locally
        pdf.SaveAs("HelloWorld.pdf")
    End Sub

Önceki örnek, herhangi bir HTML dizesini PDF içeriğine dönüştürmek için RenderHtmlAsPdf örnek yöntemini kullanır. Ayrıca, bu içeriği kullanıcının bilgisayarına kaydetmek için daha önce açıklanan prosedürlerde SaveAs metodu kullanılabilir.

Bu eğitimde oluşturulan Blazor PDF Oluşturma Uygulaması

Yukarıdaki ekran görüntüsü, bu eğitimde geliştirilen Web Uygulamasını gösterir. İndir butonuna tıklamak, C# kodunu PDF içeriğini oluşturmak ve müşteri tarafında PDF içeriğini indirmek için bir JavaScript fonksiyonunu tetikleyecektir.

Sonuç

Bu makale, web sayfalarından PDF dosyaları oluşturmak için IronPDF PDF kütüphanesini kullanan bir Blazor Web Uygulaması geliştirmenin nasıl yapıldığını gösterdi.

IronPDF açık kaynak değil, ancak bir ücretsiz deneme anahtarı ile üretimde su işareti olmadan kullanılabilir.