PDF API C# (Örnek Kod Eğitimi)

ASP.NET'te IronPDF ile HTML Nasıl PDF'ye Dönüştürülür

1. Visual Studio veya tercih ettiğiniz IDE'yi kullanarak bir ASP.NET projesi oluşturun.
2. IronPDF'i yükleyin ve lisans anahtarınızı ayarlayın.
3. PDF dönüştürme işlemini gerçekleştirmek istediğiniz yeni bir denetleyici veya sayfa oluşturun.
4. Dönüşüm mantığınızı denetleyici içinde yazın.
5. PDF oluşturma işleminize erişimi sağlamak için yönlendirmeleri yapılandırın.

IronPDF'ye Genel Bakış

IronPDF, geliştiricilere PDF belgelerini okumalarını, oluşturmalarını ve düzenlemelerini sağlayan güçlü bir PDF kütüphanesidir. Zengin özellik seti ve hızlı, basit kurulum süreci ile PDF projelerinizi çok kısa sürede bir üst seviyeye taşıyabilirsiniz. Sezgisel API'si öğrenmesi kolaydır, dolayısıyla dinamik PDF belgeleri oluşturma, PDF güvenlik görevleri, PDF açıklamaları ve benzeri işlemleri doğrudan web uygulamanızdan gerçekleştirmeyi düşünüyorsanız ideal bir seçimdir.

Gereksinimler

Başlamadan önce, şunlara sahip olduğunuzdan emin olun:

• Visual Studio veya başka bir C# geliştirme ortamı kurulu.
• IronPDF kütüphanesi kurulmuş. Bunu NuGet'ten veya doğrudan IronPDF web sitesinden elde edebilirsiniz.

Yeni Bir ASP.NET Projesi Oluşturun

Visual Studio'yu başlatın ve ihtiyaçlarınıza en uygun ASP.NET proje türünü seçin. Bugünün örneği için, bir ASP.NET Core Web Uygulaması (Model-görünüm Denetleyicisi) oluşturacağım.

Ardından, projeniz için bir isim girin ve projeyi barındırmak için konumunu seçin.

Son olarak, projenin .NET Framework'ünü seçin ve doğrulama türü veya konteyner destekleme ve docker gibi ek ayarları değiştirin.

HTML'den PDF'ye Dönüştürme Kodu Ekle

Artık ASP.NET projemizi oluşturduğumuza göre, HTML dosya içeriğini PDF'ye dönüştürme kodunu yazmaya başlayabiliriz. Önce bir HTML dizesinden PDF'ye basit bir örnekle başlayacağız ve ardından özelleştirme ile HTML içeriğini dönüştürmeyi gözden geçireceğiz.

using IronPdf;
using Microsoft.AspNetCore.Mvc;

namespace IronPdfTest.Controllers
{
    public class PdfController : Controller
    {
        // Action method to generate a PDF from HTML content
        public IActionResult GeneratePdf()
        {
            // String of HTML code to be converted to PDF
            string htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF generated from HTML.</p>";

            // Creating a renderer to convert the HTML string to PDF
            ChromePdfRenderer renderer = new ChromePdfRenderer();

            // Convert HTML string to PDF
            PdfDocument pdf = renderer.RenderHtmlAsPdf(htmlContent);

            // Return the generated PDF file
            return File(pdf.BinaryData, "application/pdf", "generatedDocument.pdf");
        }
    }
}

using IronPdf;
using Microsoft.AspNetCore.Mvc;

namespace IronPdfTest.Controllers
{
    public class PdfController : Controller
    {
        // Action method to generate a PDF from HTML content
        public IActionResult GeneratePdf()
        {
            // String of HTML code to be converted to PDF
            string htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF generated from HTML.</p>";

            // Creating a renderer to convert the HTML string to PDF
            ChromePdfRenderer renderer = new ChromePdfRenderer();

            // Convert HTML string to PDF
            PdfDocument pdf = renderer.RenderHtmlAsPdf(htmlContent);

            // Return the generated PDF file
            return File(pdf.BinaryData, "application/pdf", "generatedDocument.pdf");
        }
    }
}

Imports IronPdf
Imports Microsoft.AspNetCore.Mvc

Namespace IronPdfTest.Controllers
	Public Class PdfController
		Inherits Controller

		' Action method to generate a PDF from HTML content
		Public Function GeneratePdf() As IActionResult
			' String of HTML code to be converted to PDF
			Dim htmlContent As String = "<h1>Hello, IronPDF!</h1><p>This is a PDF generated from HTML.</p>"

			' Creating a renderer to convert the HTML string to PDF
			Dim renderer As New ChromePdfRenderer()

			' Convert HTML string to PDF
			Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf(htmlContent)

			' Return the generated PDF file
			Return File(pdf.BinaryData, "application/pdf", "generatedDocument.pdf")
		End Function
	End Class
End Namespace

ASP.NET MVC, kullanıcı isteklerini işlemek için denetleyiciler kullanır. Bir kullanıcı belirli bir URL'ye gittiğinde, ASP.NET, bu rotayla ilişkili denetleyicideki bir metodu çağıracaktır.

• PdfController, Controller'dan türeyen bir sınıftır, bu demek ki web isteklerini işleyebilir ve yanıtlara gönderebilir.
• Bu denetleyici içindeki GeneratePdf metodu, HTML'yi PDF'ye dönüştürme isteğini işleyip sonucu döndürecektir.

Bir kullanıcı GeneratePdf eylemiyle ilgili bir URL'yi ziyaret ettiğinde, metod çalışacaktır.

• IActionResult: Bu, web uygulamasının kullanıcıya geri göndereceği yanıtı temsil eden dönüş türüdür. Bir görünüm (HTML sayfa), dosya indirme vb. olabilir. Bu durumda, bir PDF dosyasıdır.

  • GeneratePdf() Metodu:

  • Metodun içinde, bir PDF'ye dönüştürmek istediğiniz HTML'yi içeren htmlContent adlı bir dize tanımlarız. Örneğin, "<h1>Hello, IronPDF!</h1><p>This is a PDF generated from HTML.</p>".

  • ChromePdfRenderer adlı yeni bir örnek oluştururuz, bu HTML'yi PDF'ye dönüştürme işlemini yönetir.

  • RenderHtmlAsPdf() metodu, HTML dizesini alır ve bir PDF nesnesi döndürür.

Özel PDF Çıkışı

Artık temel bilgileri edindiğimize göre, bazı özelleştirme ayarları belirlenmiş tuşlar ile HTML içeriğinden PDF dosyası oluşturmaya bir bakalım. IronPDF, kenar boşlukları, başlıklar/altlıklar, özel PDF boyutlandırma ve daha fazlası gibi güçlü bir PDF özelleştirme araç seti sağlar.

using IronPdf;
using Microsoft.AspNetCore.Mvc;

namespace IronPdfTest.Controllers
{
    // Controller for our PDF converter
    public class PdfController : Controller
    {
        // Action method to generate a customized PDF from HTML content
        public IActionResult GeneratePdf()
        {
            // String of HTML code to be converted to PDF
            string htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF generated from HTML.</p>";

            // Creating a renderer to convert the URL to PDF
            ChromePdfRenderer renderer = new ChromePdfRenderer();

            // Creating the cover page
            PdfDocument cover = renderer.RenderHtmlAsPdf("<h1>Cover Page</h1>");

            // Adding custom options for our final PDF
            renderer.RenderingOptions.PaperOrientation = IronPdf.Rendering.PdfPaperOrientation.Landscape;
            renderer.RenderingOptions.PaperSize = IronPdf.Rendering.PdfPaperSize.A3;
            renderer.RenderingOptions.TextHeader.CenterText = "IronPDF";
            renderer.RenderingOptions.TextHeader.FontSize = 12;
            renderer.RenderingOptions.MarginTop = 20;
            renderer.RenderingOptions.FirstPageNumber = 2;

            // Creating our main PDF
            PdfDocument pdf = renderer.RenderHtmlAsPdf(htmlContent);

            // Appending the cover to the main PDF
            pdf.InsertPdf(cover, 0);

            // Return the customized generated PDF file
            return File(pdf.BinaryData, "application/pdf", "generatedDocument.pdf");
        }
    }
}

using IronPdf;
using Microsoft.AspNetCore.Mvc;

namespace IronPdfTest.Controllers
{
    // Controller for our PDF converter
    public class PdfController : Controller
    {
        // Action method to generate a customized PDF from HTML content
        public IActionResult GeneratePdf()
        {
            // String of HTML code to be converted to PDF
            string htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF generated from HTML.</p>";

            // Creating a renderer to convert the URL to PDF
            ChromePdfRenderer renderer = new ChromePdfRenderer();

            // Creating the cover page
            PdfDocument cover = renderer.RenderHtmlAsPdf("<h1>Cover Page</h1>");

            // Adding custom options for our final PDF
            renderer.RenderingOptions.PaperOrientation = IronPdf.Rendering.PdfPaperOrientation.Landscape;
            renderer.RenderingOptions.PaperSize = IronPdf.Rendering.PdfPaperSize.A3;
            renderer.RenderingOptions.TextHeader.CenterText = "IronPDF";
            renderer.RenderingOptions.TextHeader.FontSize = 12;
            renderer.RenderingOptions.MarginTop = 20;
            renderer.RenderingOptions.FirstPageNumber = 2;

            // Creating our main PDF
            PdfDocument pdf = renderer.RenderHtmlAsPdf(htmlContent);

            // Appending the cover to the main PDF
            pdf.InsertPdf(cover, 0);

            // Return the customized generated PDF file
            return File(pdf.BinaryData, "application/pdf", "generatedDocument.pdf");
        }
    }
}

Imports IronPdf
Imports Microsoft.AspNetCore.Mvc

Namespace IronPdfTest.Controllers
	' Controller for our PDF converter
	Public Class PdfController
		Inherits Controller

		' Action method to generate a customized PDF from HTML content
		Public Function GeneratePdf() As IActionResult
			' String of HTML code to be converted to PDF
			Dim htmlContent As String = "<h1>Hello, IronPDF!</h1><p>This is a PDF generated from HTML.</p>"

			' Creating a renderer to convert the URL to PDF
			Dim renderer As New ChromePdfRenderer()

			' Creating the cover page
			Dim cover As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Cover Page</h1>")

			' Adding custom options for our final PDF
			renderer.RenderingOptions.PaperOrientation = IronPdf.Rendering.PdfPaperOrientation.Landscape
			renderer.RenderingOptions.PaperSize = IronPdf.Rendering.PdfPaperSize.A3
			renderer.RenderingOptions.TextHeader.CenterText = "IronPDF"
			renderer.RenderingOptions.TextHeader.FontSize = 12
			renderer.RenderingOptions.MarginTop = 20
			renderer.RenderingOptions.FirstPageNumber = 2

			' Creating our main PDF
			Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf(htmlContent)

			' Appending the cover to the main PDF
			pdf.InsertPdf(cover, 0)

			' Return the customized generated PDF file
			Return File(pdf.BinaryData, "application/pdf", "generatedDocument.pdf")
		End Function
	End Class
End Namespace

Sonuç

Bugün ASP.NET ile HTML'den PDF'ye dönüşümün nasıl kullanılabileceğine yakından baktık ve bir ASP.NET projesindeki HTML ile PDF dosyaları oluşturma sürecini inceleyip keşfettik. Yukarıda belirtilen adımları izleyerek, PDF oluşturmayı web uygulamalarınıza kolayca entegre edebilir ve HTML içeriğinden yüksek kaliteli, yazdırılabilir belgeler oluşturabilirsiniz.

IronPDF, yüksek kaliteli PDF belgeleri üretmek için kullanılabilecek zengin bir özellik setine sahiptir. Daha gelişmiş özellikler ve ayrıntılı özelleştirme için, IronPDF dokümantasyonuna başvurun. Hızlı kurulumu ile IronPDF'i projenize kısa sürede dâhil edebilirsiniz.