IronPDF, Chrome'un işleme motorunu kullanarak ASP.NET Core'da HTML'i PDF'e dönüştürmeyi kolaylaştırır, böylece dinamik web içeriklerini, raporları ve faturaları sadece birkaç satır kodla, tüm CSS stillerini ve JavaScript işlevselliğini koruyarak kesin PDF'lere dönüştürebilirsiniz.
ASP.NET Core uygulamanızdan pürüzsüz, piksel mükemmeliğinde raporlar ve faturalar elde etmekte zorlanıyor musunuz? Yalnız değilsiniz.
Her geliştirici sonunda dinamik web içeriklerini — raporlar veya sipariş onayları gibi — güvenilir, indirilebilir PDF'lere dönüştürme ihtiyacı duyar. Bu, faturalar ve ayrıntılı raporlardan, güvenli, arşivlenebilir belge formatlarını üretmeye kadar her şeyi oluşturmak için temel bir gereksinimdir. Zorlu kısım, tüm CSS ve JavaScript'i iletmek ve mükemmel bir şekilde PDF çıktısı olarak işlemek.
İşte burada IronPDF devreye giriyor. Kaputun altında Chrome'un işleme motorunu kullanıyor, böylece tarayıcıda ne görüyorsanız, PDF çıktısında tıpkı onu elde ediyorsunuz. ASPX sayfaları, modern Razor görünümleri veya ham HTML dizeleri üzerinde çalışıp çalışmadığınız önemli değil, dönüştürme süreci tutarlı ve öngörülebilirdir.
Bu kılavuz, URL'den PDF'e dönüştürme, HTML dizesi işleme ve HTML dosyası işleme gibi en yaygın ASP.NET Core HTML'den PDF'e senaryolarını — her yaklaşıma uygun çalışan C# kod örnekleriyle — ele alır.
Ücretsiz denemenize başlayın ve bugün HTML'den PDF belgeleri dönüştürmeye başlayın.
IronPDF'in yüklenmesi, NuGet Paket Yöneticisi Konsolu'ndaki veya .NET CLI'daki tek bir komuttan oluşur. IronPDF NuGet paketi olarak mevcuttur ve .NET 6, 7, 8 ve 10'u hedefler:
Yüklendikten sonra IronPDF, modern HTML öğelerini, CSS stillerini ve JavaScript yürütmesini destekleyen tam HTML işleme yetenekleri sağlar. Kütüphane, Bootstrap ve Flex düzenleri de dahil olmak üzere, karmaşık HTML yapıları ve CSS özelliklerini güvenilir bir şekilde işler.
IronPDF, geniş bir ortam yelpazesi üzerinde dağıtımı destekler:
| Ortam | Destek Seviyesi | Açıklamalar |
|---|---|---|
| Windows | Tam | IIS ve self-hosted, tüm sürümler |
| Linux | Tam | Ubuntu, Debian, CentOS, Alpine |
| macOS | Tam | Arm ve x64 mimarileri |
| Azure | Tam | Uygulama Hizmeti, Fonksiyonlar, Konteynerler |
| AWS Lambda | Tam | Sunucusuz PDF oluşturma |
| Docker | Tam | Uzaktan IronPDF Motoru seçeneği içerir |
Kurulumdan sonra, ChromePdfRenderer sınıfı ana giriş noktanızdır. Burada kağıt boyutu, kenar boşlukları, üstbilgiler, JavaScript çalıştırma ve çok daha fazlasını kontrol ettiğiniz bir RenderingOptions özelliği sunar. Aşağıdaki bölümler, tipik bir ASP.NET Core uygulamasında kullanacağınız üç ana dönüştürme yöntemini kapsamaktadır.
Bir HTML dizisini doğrudan PDF dosyasına dönüştürmek en doğrudan yaklaşımdır ve dosya sistemine erişim gerektirmez. Bu, dinamik olarak bir araya getirilen HTML'den PDF oluşturmak için idealdir — örneğin sipariş onayları, faturalar veya veritabanından doldurulan rapor şablonları gibi.
Aşağıdaki kod, bir HTML dizesini IronPDF kullanarak PDF'e dönüştüren, tam bir ASP.NET Core denetleyici eylemi gösterir:
using Microsoft.AspNetCore.Mvc;
using IronPdf;
namespace HtmlToPdf.Controllers
{
public class PdfController : Controller
{
public IActionResult Index()
{
return View();
}
[HttpGet]
public IActionResult ConvertHtmlStringToPdf()
{
string htmlContent = @"
<html>
<head>
<title>IronPDF Test</title>
<style>
body { font-family: Arial; margin: 40px; }
h1 { color: #2b5797; }
table { border-collapse: collapse; width: 100%; margin-top: 20px; }
th, td { border: 1px solid #ccc; padding: 8px; }
th { background: #f0f0f0; }
</style>
</head>
<body>
<h1>IronPDF HTML to PDF Test</h1>
<p>This is a simple test of converting an HTML string to PDF using IronPDF.</p>
<table>
<tr><th>Item</th><th>Price</th></tr>
<tr><td>Apples</td><td>$1.50</td></tr>
<tr><td>Bananas</td><td>$0.90</td></tr>
</table>
<p><em>End of test document.</em></p>
</body>
</html>";
// Initialize the PDF converter
var renderer = new ChromePdfRenderer();
// Configure page size and margins
renderer.RenderingOptions.PaperSize = IronPdf.Rendering.PdfPaperSize.A4;
renderer.RenderingOptions.MarginTop = 20;
renderer.RenderingOptions.MarginBottom = 20;
// Convert the HTML string to a PDF document
var pdfDocument = renderer.RenderHtmlAsPdf(htmlContent);
// Return the PDF file as a download
return File(pdfDocument.BinaryData, "application/pdf", "output.pdf");
}
}
}Imports Microsoft.AspNetCore.Mvc
Imports IronPdf
Namespace HtmlToPdf.Controllers
Public Class PdfController
Inherits Controller
Public Function Index() As IActionResult
Return View()
End Function
<HttpGet>
Public Function ConvertHtmlStringToPdf() As IActionResult
Dim htmlContent As String = "
<html>
<head>
<title>IronPDF Test</title>
<style>
body { font-family: Arial; margin: 40px; }
h1 { color: #2b5797; }
table { border-collapse: collapse; width: 100%; margin-top: 20px; }
th, td { border: 1px solid #ccc; padding: 8px; }
th { background: #f0f0f0; }
</style>
</head>
<body>
<h1>IronPDF HTML to PDF Test</h1>
<p>This is a simple test of converting an HTML string to PDF using IronPDF.</p>
<table>
<tr><th>Item</th><th>Price</th></tr>
<tr><td>Apples</td><td>$1.50</td></tr>
<tr><td>Bananas</td><td>$0.90</td></tr>
</table>
<p><em>End of test document.</em></p>
</body>
</html>"
' Initialize the PDF converter
Dim renderer = New ChromePdfRenderer()
' Configure page size and margins
renderer.RenderingOptions.PaperSize = IronPdf.Rendering.PdfPaperSize.A4
renderer.RenderingOptions.MarginTop = 20
renderer.RenderingOptions.MarginBottom = 20
' Convert the HTML string to a PDF document
Dim pdfDocument = renderer.RenderHtmlAsPdf(htmlContent)
' Return the PDF file as a download
Return File(pdfDocument.BinaryData, "application/pdf", "output.pdf")
End Function
End Class
End Namespace
ChromePdfRenderer sınıfı, HTML dizginizi uygun biçimlendirilmiş, çok sayfalı bir PDF'ye dönüştüren tüm dönüşüm hattını yönetir. Sonuçta ortaya çıkan belge, kaynak HTML'de tanımlandığı şekilde tüm stil düzenlemelerini — satır içi CSS, gömülü stil sayfaları ve hatta yazı tipi kurallarını — aynen korur. Bu model, faturalar, ekstreler ve düzenini uçtan uca kod ile kontrol ettiğiniz belgeler oluşturmak için özellikle etkilidir.
Bu deseni her sayfaya başlıklar ve altbilgiler eklemek veya özel filigranlar eklemek için genişletebilirsiniz. IronPDF, görsel kaliteden kaybetmeden dosya boyutlarını azaltmak için PDF sıkıştırmayı da destekler.
Sunucuda saklanan mevcut HTML şablon dosyaları ile çalışırken IronPDF, tüm bağlı kaynaklar (dış stil sayfaları, yerel görüntüler ve JavaScript dosyaları gibi) korunarak onları okuyup dönüştürebilir. Bu yaklaşım, tasarımcıların HTML dosyalarını uygulama kodundan bağımsız olarak sürdüğü şablon tabanlı doküman oluşturma hatları için iyi çalışır:
using IronPdf;
using Microsoft.AspNetCore.Mvc;
using System.IO;
namespace YourApp.Controllers
{
public class DocumentController : Controller
{
private readonly IWebHostOrtam _environment;
public DocumentController(IWebHostOrtam environment)
{
_environment = environment;
}
[HttpGet]
public IActionResult GeneratePdfFromTemplate(string templateName)
{
// Resolve the full path to the HTML template
string htmlFilePath = Path.Combine(_environment.WebRootPath, "templates", $"{templateName}.html");
var renderer = new ChromePdfRenderer();
// Use print media type for print-optimized CSS rules
renderer.RenderingOptions.EnableJavaScript = true;
renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print;
// Add a header to every generated page
renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter
{
Height = 25,
HtmlFragment = "<div style='text-align:center'>Company Report</div>"
};
// Convert the HTML file to a PDF document
var pdf = renderer.RenderHtmlFileAsPdf(htmlFilePath);
return File(pdf.BinaryData, "application/pdf", $"{templateName}_generated.pdf");
}
}
}Imports IronPdf
Imports Microsoft.AspNetCore.Mvc
Imports System.IO
Namespace YourApp.Controllers
Public Class DocumentController
Inherits Controller
Private ReadOnly _environment As IWebHostOrtam
Public Sub New(environment As IWebHostOrtam)
_environment = environment
End Sub
<HttpGet>
Public Function GeneratePdfFromTemplate(templateName As String) As IActionResult
' Resolve the full path to the HTML template
Dim htmlFilePath As String = Path.Combine(_environment.WebRootPath, "templates", $"{templateName}.html")
Dim renderer As New ChromePdfRenderer()
' Use print media type for print-optimized CSS rules
renderer.RenderingOptions.EnableJavaScript = True
renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print
' Add a header to every generated page
renderer.RenderingOptions.HtmlHeader = New HtmlHeaderFooter With {
.Height = 25,
.HtmlFragment = "<div style='text-align:center'>Company Report</div>"
}
' Convert the HTML file to a PDF document
Dim pdf = renderer.RenderHtmlFileAsPdf(htmlFilePath)
Return File(pdf.BinaryData, "application/pdf", $"{templateName}_generated.pdf")
End Function
End Class
End Namespace
Bu yaklaşım, HTML belgelerini diskten okur ve tüm belge yapısını koruyarak dönüştürür. Tüm CSS özellikleri, resim referansları ve tablolar ve iç içe geçmiş konteynerler gibi karmaşık HTML öğeleri çıktı olarak korunur. IronPDF, kaynak dosyanın konumuna bağıl kaynak yollarını çözümler, bu nedenle bağlı stil sayfaları ve görüntüler ekstra yapılandırma gerektirmeden yüklenir.
IronPDF ayrıca CSS baskı medya sorgularını doğru bir şekilde destekler, bu da HTML şablonlarınızda sadece PDF oluşturulurken - sayfa yüklendiğinde değil - sadece yazdırma sırasında uygulanacak baskı özel kuralları - gezinme çubuklarını gizlemek, yazı tipi boyutlarını ayarlamak veya sayfa kırılma ipuçları etkinleştirme - tanımlamanızı sağlar.
ASP.NET Core uygulamaları genellikle içeriği form kimlik doğrulaması ile korur. Geçerli bir oturum gerektiren sayfaları dönüştürürken, IronPDF, kimlik doğrulama çerezlerini HTTP isteğiyle birlikte iletebilir, böylece oluşturulan sayfa, kimliği doğrulanmış bir kullanıcının göreceği gibi yansır:
[Authorize]
public IActionResult ConvertAuthenticatedPage()
{
var renderer = new ChromePdfRenderer();
// Build the URL for the protected resource
string currentUrl = $"{Request.Scheme}://{Request.Host}/SecureContent";
// Forward the authentication cookie to IronPDF
var authCookie = Request.Cookies[".AspNetCore.Cookies"];
if (!string.IsNullOrEmpty(authCookie))
{
renderer.RenderingOptions.CustomCookies = new System.Collections.Generic.Dictionary<string, string>
{
{ ".AspNetCore.Cookies", authCookie }
};
}
// Convert the authenticated page to a PDF file
var pdf = renderer.RenderUrlAsPdf(currentUrl);
return File(pdf.BinaryData, "application/pdf", "secure_document.pdf");
}Imports System.Collections.Generic
Imports IronPdf
<Authorize>
Public Function ConvertAuthenticatedPage() As IActionResult
Dim renderer As New ChromePdfRenderer()
' Build the URL for the protected resource
Dim currentUrl As String = $"{Request.Scheme}://{Request.Host}/SecureContent"
' Forward the authentication cookie to IronPDF
Dim authCookie As String = Request.Cookies(".AspNetCore.Cookies")
If Not String.IsNullOrEmpty(authCookie) Then
renderer.RenderingOptions.CustomCookies = New Dictionary(Of String, String) From {
{".AspNetCore.Cookies", authCookie}
}
End If
' Convert the authenticated page to a PDF file
Dim pdf = renderer.RenderUrlAsPdf(currentUrl)
Return File(pdf.BinaryData, "application/pdf", "secure_document.pdf")
End FunctionBu teknik, giriş duvarının arkasında bulunan sayfaların tam işlenmiş çıktısını yakalar. Hedef URL aynı uygulamaya ait olduğunda, tüm göreceli kaynak yolları doğru bir şekilde çözülür çünkü renderleyici aynı temel URL bağlamını devralır. Özel HTTP istek başlıklarını API anahtarı doğrulaması veya diğer başlık tabanlı güvenlik şemaları için de yapılandırabilirsiniz.
Belge oluşturulduktan sonra daha güçlü güvenlik için, PDF şifreleri ve izinleri uygulamayı veya yetkisiz değişiklikleri önlemek için PDF'lerinizi dijital olarak imzalamayı düşünün. IronPDF ayrıca düzenlemeye tabi endüstriler için önemli olabilecek uzun süreli arşivleme için PDF/A uyumluluğu ve erişilebilirlik gereksinimleri için PDF/UA formatını destekler.
Eski ASPX sayfa dönüşümü veya çalışma zamanında içerik doldurmak için JavaScript'e bağlı belgeler için IronPDF, işleme sürecini güvenilir bir şekilde yönetir. JavaScript'in çalışmayı tamamlamasına izin vermek için sayfa yakalanmadan önce bir render gecikmesi yapılandırabilirsiniz:
public IActionResult ConvertDynamicContent()
{
var renderer = new ChromePdfRenderer();
// Enable JavaScript so dynamic content renders correctly
renderer.RenderingOptions.EnableJavaScript = true;
// Wait 1 second after page load for JavaScript to complete
renderer.RenderingOptions.WaitFor.RenderDelay(1000);
// Generate your dynamic HTML string
string dynamicHtml = GenerateDynamicHtml();
var pdf = renderer.RenderHtmlAsPdf(dynamicHtml);
return File(pdf.BinaryData, "application/pdf", "dynamic.pdf");
}Imports IronPdf
Public Function ConvertDynamicContent() As IActionResult
Dim renderer As New ChromePdfRenderer()
' Enable JavaScript so dynamic content renders correctly
renderer.RenderingOptions.EnableJavaScript = True
' Wait 1 second after page load for JavaScript to complete
renderer.RenderingOptions.WaitFor.RenderDelay(1000)
' Generate your dynamic HTML string
Dim dynamicHtml As String = GenerateDynamicHtml()
Dim pdf = renderer.RenderHtmlAsPdf(dynamicHtml)
Return File(pdf.BinaryData, "application/pdf", "dynamic.pdf")
End Function
HTML'den PDF'ye dönüştürmede yaygın bir sorun, başlıkları içeriklerinden ayıran veya tablo satırlarını ortadan bölen istenmeyen sayfa kesmeleridir. IronPDF, standart CSS page-break-before ve page-break-inside kuralları ile birlikte IronPDF'in WaitFor APIsını kullanarak yapılandırılabilir sayfa sonu kontrolü ile bunu ele alır. Kütüphane ayrıca, yoğun trafik senaryolarında daha iyi işlem hacmi sağlamak için asenkron PDF oluşturmayı da destekler.
Gelişmiş JavaScript uygulamaları için -- D3.js tarafından oluşturulan grafikler veya React bileşenleri gibi -- anlık görüntü alınmadan önce özel JavaScript enjekte edebilir ve çalıştırabilirsiniz, böylece grafik veya bileşen tam olarak monte edilmiş olur ve PDF üretilir.
IronPDF'nin dönüştürme motoru, tam dönüştürme seçenekleri API'si aracılığıyla gelişmiş CSS ve HTML5 özelliklerini destekler. HTML'yi PDF'ye dönüştürürken, kütüphane Flexbox, CSS Grid ile oluşturulmuş karmaşık düzenler ve duyarlı medya sorguları dahil olmak üzere CSS özelliklerini doğru bir şekilde yorumlar. PDF çıktısı, kaynak sayfanın görsel doğruluğunu korur ve bu, sayfa yakalanmadan önce DOM'u değiştiren dış stil sayfalarını, yerleşik stilleri ve JavaScript ile oluşturulan içeriği içerir.
Dönüştürme süreci, çok sayfalı belgeleri, boş sayfa bastırmayı ve otomatik sayfa boyutu ayarlamasını manuel yapılandırma olmadan yönetir. Özel sayfalara farklı başlıklar veya altbilgiler uygulamak ya da bir raporda onlarca sayfa boyunca uzanan içeriği sorunsuzca yönetmek gibi özel senaryoları da yönetir.
Bilinmesi gereken ek işleme yetenekleri:
Bu yetenekler, IronPDF'yi temel bir dönüştürücünün çıktı kalitesinin üretim gereksinimlerini karşılamadığı, belge yoğun uygulamalar için pratik bir seçim haline getirir. .NET içerisinde PDF oluşturma konusunda yeni olan ekipler için, Microsoft'un ASP.NET Core belgeleri kontrolcü eylemleri ve ara katman hakkında iyi bir zemin sağlar ve bu, herhangi bir PDF kütüphanesini bir web uygulamasına entegre ederken kullanışlı bir bağlam sunar.
IronPDF, HTML'den PDF'ye dönüştürme için üretime hazır bir .NET kütüphanesidir ve Aspose, iText ve Syncfusion gibi alternatiflere göre güvenilir performans sunar. Temel PDF dönüştürücülerinin aksine, modern web standartları için tam destek sağlar -- basit HTML metinlerinden JavaScript ile render edilen içerik ve form kimlik doğrulama içeren karmaşık web uygulamalarına kadar her şeyi işler.
Kütüphane, Blazor uygulamaları ve MAUI projeleri için eşit derecede iyi çalışır ve C#'a ek olarak F# ile kullanılabilir. Kurumsal ortamlar için, IronPDF IIS barındırma, Azure Functions ve Docker konteynerlerini destekler.
IronPDF, geliştirme sırasında ücretsiz olarak denenebilir. Bugün IronPDF indirin ve HTML içeriğini profesyonel PDF belgelerine dönüştürmeye başlayın. ASP.NET Core uygulamalarınızda HTML'den PDF'ye dönüşümün tüm avantajlarından yararlanmak için tam belgelendirmeyi, kod örneklerini ve API referansını keşfedin.
Curtis Chau, Bilgisayar Bilimleri alanında Lisans Derecesine (Carleton Üniversitesi) sahip ve Node.js, TypeScript, JavaScript ve React konularında uzmanlaşmış ön uç geliştirmeyle ilgileniyor. Sezgisel ve estetik açıdan hoş kullanıcı arayüzleri oluşturma tutkunu, Curtis modern çerçevelerle çalışmayı ve iyi yapılandırılmış, görsel olarak çekici kılavuzlar oluşturmayı seviyor.
IronPDF, IRONSUITE'in bir parçasıdır
Ofis belgeleriniz için 10 .NET API ürünü
PDF'nizin HTML gibi görünmesine ihtiyaç duyduğunuzda, hızlı.
