HTML'den PDF'ye dönüştürmek, raporlar, faturalar oluşturma veya web sayfalarını PDF olarak kaydetme gibi birçok yazılım uygulamasında yaygın bir gereksinimdir. Bu makalede, C#'da HTML'den PDF'ye dönüştürme için üç popüler açık kaynak kütüphanesini inceleyeceğiz, güçlü ve zayıf yönlerini değerlendireceğiz ve neden IronPDF'in birçok durumda daha iyi bir alternatif olduğunu tartışacağız.
PuppeteerSharp, headless Chromium tarayıcısı olan Puppeteer için bir .NET örtücüsüdür. Bu, geliştiricilere Chromium render motorunu kullanarak HTML belgelerini PDF'lere dönüştürme olanağı sağlar.
PuppeteerSharp, render süreci üzerinde hassas kontrol sağlar. İşte bir örnek:
using PuppeteerSharp;
using System.Threading.Tasks;
class Program
{
static async Task Main(string[] args)
{
// Download Chromium to ensure compatibility with PuppeteerSharp
await new BrowserFetcher().DownloadAsync(BrowserFetcher.DefaultChromiumRevision);
// Launch a headless instance of Chromium browser
using (var browser = await Puppeteer.LaunchAsync(new LaunchOptions { Headless = true }))
{
// Open a new browser page
var page = await browser.NewPageAsync();
// Set the HTML content for the page
await page.SetContentAsync("<html><body><h1>Hello, PuppeteerSharp!</h1></body></html>");
// Generate a PDF from the rendered HTML content
await page.PdfAsync("output.pdf");
Console.WriteLine("PDF Generated Successfully!");
}
}
}Imports PuppeteerSharp
Imports System.Threading.Tasks
Friend Class Program
Shared Async Function Main(ByVal args() As String) As Task
' Download Chromium to ensure compatibility with PuppeteerSharp
Await (New BrowserFetcher()).DownloadAsync(BrowserFetcher.DefaultChromiumRevision)
' Launch a headless instance of Chromium browser
Using browser = Await Puppeteer.LaunchAsync(New LaunchOptions With {.Headless = True})
' Open a new browser page
Dim page = Await browser.NewPageAsync()
' Set the HTML content for the page
Await page.SetContentAsync("<html><body><h1>Hello, PuppeteerSharp!</h1></body></html>")
' Generate a PDF from the rendered HTML content
Await page.PdfAsync("output.pdf")
Console.WriteLine("PDF Generated Successfully!")
End Using
End Function
End ClassChromium'u İndir: PuppeteerSharp, uyumluluğu sağlamak için gereken Chromium sürümünü otomatik olarak indirir.
Tarayıcı Başlat: Bir başsız Chromium örneğini Puppeteer.LaunchAsync() kullanarak başlatın.
HTML İçeriği Ayarla: İstenilen HTML'i tarayıcı sayfasına page.SetContentAsync() kullanarak yükleyin.
PDF Oluştur: Raporlanan içeriğin PDF'sini oluşturmak için page.PdfAsync() yöntemini kullanın.
Sonuç, HTML yapısını ve tasarımını doğru bir şekilde kopyalayan yüksek kaliteli bir PDF'dir (output.pdf).
PDFSharp, C# dilinde PDF dosyaları oluşturma ve işleme için güçlü bir açık kaynak kütüphanedir. HTML render etmeyi doğrudan desteklemese de, geliştiricilere PDF belgeleri programatik olarak oluşturup düzenlemek için araçlar sağlamada üstündür.
PDF Oluşturma: PDFSharp, geliştiricilerin, sayfa boyutlarını belirleyerek, metin, şekil, görüntü vb. ekleyerek sıfırdan yeni PDF dosyaları oluşturmasına olanak tanır.
Mevcut PDF'lerin Manipülasyonu: Mevcut PDF belgelerini birleştirme, ayırma veya içerik çıkarma gibi işlemler yapabilirsiniz.
Çizim Yetenekleri: PDFSharp, XGraphics sınıfını kullanarak PDF dosyalarına özel tasarımlar eklemek için sağlam grafik yetenekleri sağlar.
Hafif: Bu, basitlik ve hızın öncelik olduğu projeler için ideal olan hafif bir kütüphanedir.
using PdfSharp.Pdf;
using PdfSharp.Drawing;
using HtmlAgilityPack;
class Program
{
static void Main(string[] args)
{
// Example HTML content
string htmlContent = "<html><body><h1>Hello, PdfSharp!</h1><p>This is an example of HTML to PDF.</p></body></html>";
// Parse HTML using HtmlAgilityPack (You need to add HtmlAgilityPack via NuGet)
var htmlDoc = new HtmlDocument();
htmlDoc.LoadHtml(htmlContent);
// Create a new PDF document
PdfDocument pdfDocument = new PdfDocument
{
Info = { Title = "HTML to PDF Example" }
};
// Add a new page to the document
PdfPage page = pdfDocument.AddPage();
XGraphics gfx = XGraphics.FromPdfPage(page);
XFont titleFont = new XFont("Arial", 20, XFontStyle.Bold);
XFont textFont = new XFont("Arial", 12, XFontStyle.Regular);
// Draw the parsed HTML content
int yPosition = 50; // Starting Y position
foreach (var node in htmlDoc.DocumentNode.SelectNodes("//h1 | //p"))
{
if (node.Name == "h1")
{
gfx.DrawString(node.InnerText, titleFont, XBrushes.Black, new XRect(50, yPosition, page.Width - 100, page.Height - 100), XStringFormats.TopLeft);
yPosition += 30; // Adjust spacing
}
else if (node.Name == "p")
{
gfx.DrawString(node.InnerText, textFont, XBrushes.Black, new XRect(50, yPosition, page.Width - 100, page.Height - 100), XStringFormats.TopLeft);
yPosition += 20; // Adjust spacing
}
}
// Save the PDF document
string outputFilePath = "HtmlToPdf.pdf";
pdfDocument.Save(outputFilePath);
System.Console.WriteLine($"PDF file created: {outputFilePath}");
}
}Imports PdfSharp.Pdf
Imports PdfSharp.Drawing
Imports HtmlAgilityPack
Friend Class Program
Shared Sub Main(ByVal args() As String)
' Example HTML content
Dim htmlContent As String = "<html><body><h1>Hello, PdfSharp!</h1><p>This is an example of HTML to PDF.</p></body></html>"
' Parse HTML using HtmlAgilityPack (You need to add HtmlAgilityPack via NuGet)
Dim htmlDoc = New HtmlDocument()
htmlDoc.LoadHtml(htmlContent)
' Create a new PDF document
Dim pdfDocument As New PdfDocument With {
.Info = { Title = "HTML to PDF Example" }
}
' Add a new page to the document
Dim page As PdfPage = pdfDocument.AddPage()
Dim gfx As XGraphics = XGraphics.FromPdfPage(page)
Dim titleFont As New XFont("Arial", 20, XFontStyle.Bold)
Dim textFont As New XFont("Arial", 12, XFontStyle.Regular)
' Draw the parsed HTML content
Dim yPosition As Integer = 50 ' Starting Y position
For Each node In htmlDoc.DocumentNode.SelectNodes("//h1 | //p")
If node.Name = "h1" Then
gfx.DrawString(node.InnerText, titleFont, XBrushes.Black, New XRect(50, yPosition, page.Width - 100, page.Height - 100), XStringFormats.TopLeft)
yPosition += 30 ' Adjust spacing
ElseIf node.Name = "p" Then
gfx.DrawString(node.InnerText, textFont, XBrushes.Black, New XRect(50, yPosition, page.Width - 100, page.Height - 100), XStringFormats.TopLeft)
yPosition += 20 ' Adjust spacing
End If
Next node
' Save the PDF document
Dim outputFilePath As String = "HtmlToPdf.pdf"
pdfDocument.Save(outputFilePath)
System.Console.WriteLine($"PDF file created: {outputFilePath}")
End Sub
End ClassHTML Ayrıştırma: Örnek, HtmlAgilityPack (HTML'i ayrıştırmak ve manipüle etmek için açık kaynaklı bir kütüphane) kullanarak <h1> ve <p> etiketlerinden metin içeriği çıkarmak için kullanılır.
İçerik Çizimi: PDFSharp'ın XGraphics sınıfı, ayrıştırılmış HTML içeriğini bir PDF sayfasında metin olarak render etmek için kullanılır.
Sınırlamalar: Bu yaklaşım basit HTML yapıları için çalışır, ancak karmaşık düzenleri, stilleri veya JavaScript'i işleyemez.
Pdfium.NET, açık kaynaklı PDFium projesine dayalı, .NET uygulamalarında PDF dosyalarını görüntüleme, düzenleme ve manipüle etme amaçlı kapsamlı bir kütüphanedir. Geniş bir kullanım yelpazesine uygun, PDF'leri oluşturmak, düzenlemek ve içerik çıkarmak için geliştiricilere güçlü araçlar sunar. Temelde ücretsiz bir HTML'den PDF'ye dönüştürücü kütüphanesidir.
PDF Oluşturma ve Düzenleme:
Metin ve Görüntü Çıkarma:
PDF Görüntüleme Kontrolü:
Uyumluluk:
İleri Düzey Özellikler:
using Pdfium.Net.SDK;
using System;
class Program
{
static void Main(string[] args)
{
// Initialize Pdfium.NET SDK functionalities
PdfCommon.Initialize();
// Create a new PDF document
PdfDocument pdfDocument = PdfDocument.CreateNew();
// Add a page to the document (A4 size in points: 8.27 x 11.69 inches)
var page = pdfDocument.Pages.InsertPageAt(pdfDocument.Pages.Count, 595, 842);
// Sample HTML content to be parsed and rendered manually
var htmlContent = "<h1>Hello, Pdfium.NET SDK!</h1><p>This is an example of HTML to PDF.</p>";
// Example: Manually render text since Pdfium.NET doesn't render HTML directly
var font = PdfFont.CreateFont(pdfDocument, "Arial");
page.AddText(72, 750, font, 20, "Hello, Pdfium.NET SDK!");
page.AddText(72, 700, font, 14, "This is an example of HTML to PDF.");
// Save the document to a file
string outputFilePath = "HtmlToPdfExample.pdf";
pdfDocument.Save(outputFilePath, SaveFlags.Default);
Console.WriteLine($"PDF created successfully: {outputFilePath}");
}
}Imports Pdfium.Net.SDK
Imports System
Friend Class Program
Shared Sub Main(ByVal args() As String)
' Initialize Pdfium.NET SDK functionalities
PdfCommon.Initialize()
' Create a new PDF document
Dim pdfDocument As PdfDocument = PdfDocument.CreateNew()
' Add a page to the document (A4 size in points: 8.27 x 11.69 inches)
Dim page = pdfDocument.Pages.InsertPageAt(pdfDocument.Pages.Count, 595, 842)
' Sample HTML content to be parsed and rendered manually
Dim htmlContent = "<h1>Hello, Pdfium.NET SDK!</h1><p>This is an example of HTML to PDF.</p>"
' Example: Manually render text since Pdfium.NET doesn't render HTML directly
Dim font = PdfFont.CreateFont(pdfDocument, "Arial")
page.AddText(72, 750, font, 20, "Hello, Pdfium.NET SDK!")
page.AddText(72, 700, font, 14, "This is an example of HTML to PDF.")
' Save the document to a file
Dim outputFilePath As String = "HtmlToPdfExample.pdf"
pdfDocument.Save(outputFilePath, SaveFlags.Default)
Console.WriteLine($"PDF created successfully: {outputFilePath}")
End Sub
End ClassSDK Başlatma: PdfCommon.Initialize() yöntemi, Pdfium.NET işlevlerini başlatır.
Bir PDF Oluşturma: PdfDocument.CreateNew() kullanılarak yeni bir PDF belgesi oluşturulur.
Sayfa Ekleme: Sayfalar, belirtilen boyutlarda (örneğin, A4 boyutu) PDF'ye eklenir.
HTML İçeriğini Render Etme: Pdfium.NET SDK'sı HTML render etmeyi doğal olarak desteklemediğinden, HTML öğelerini metin, şekil veya resim olarak manuel olarak ayrıştırmanız ve render etmeniz gerekir.
PDF'yi Kaydetme: Belge, Save() yöntemi ile bir dosya yoluna kaydedilir.
IronPDF, .NET geliştiricileri için HTML içeriğini zahmetsizce yüksek kaliteli PDF'lere dönüştürmek amacıyla tasarlanmış profesyonel düzeyde bir kütüphanedir. Güvenilirliği, gelişmiş özellikleri ve kullanım kolaylığı ile tanınan IronPDF, geliştirme sürecini basitleştirirken doğru render ve sağlam işlevsellik sunar. IronPDF'in öne çıkan bir çözüm olmasının nedenleri:
Doğrudan HTML'den PDF'ye Dönüştürme: IronPDF ile HTML içeriği, CSS ve JavaScript dahil, tam formatlanmış PDF'ler olarak doğrudan PDF belgeleri oluşturun. Birkaç satır kodla, geliştiriciler web sayfalarından, ham HTML dizelerinden veya yerel HTML dosyalarından PDF oluşturabilir.
Modern Render Yetenekleri: En son web standartlarını destekleyen IronPDF, HTML sayfalarını PDF'ye dönüştürmek için karmaşık düzenlerin, stillerin ve etkileşimli öğelerin doğru şekilde render edilmesini sağlar.
Gelişmiş PDF Özellikleri: IronPDF, başlıklar, altbilgiler, filigranlar, açıklamalar ve yer imleri ekleme gibi kapsamlı özelleştirme seçenekleri sunar. Aynı zamanda mevcut PDF'leri birleştirme, ayırma ve düzenlemeyi de destekler.
Performans ve Ölçeklenebilirlik: Küçük ölçekli uygulamalardan kurumsal ortamlara kadar optimize edilmiş IronPDF, her türlü boyutta projeler için hızlı ve güvenilir performans sunar.
Kolay Entegrasyon: .NET Framework ve .NET Core için tasarlanmış olan IronPDF, C# uygulamaları ile sorunsuz entegre olur, geliştiricilere basit bir kurulum süreci ve kapsamlı dokümantasyon sunar.
IronPDF, özellik kombinasyonu, geliştirici desteği ve performansı ile diğer çözümler arasında öne çıkar. Sık sık kapsamlı yapılandırma veya harici bağımlılıklar gerektiren açık kaynak alternatiflerinin aksine, IronPDF, işlevsellikten ödün vermeden geliştirmeyi basitleştiren, kendi kendine yeten bir çözümdür. İster fatura, rapor üretiyor olun, ister web içeriğini arşivliyor olun, IronPDF, profesyonel sonuçlara hızlı ve verimli bir şekilde ulaşmanız için geliştiricileri güçlendirir.
IronPDF, HTML'den PDF'ye iş akışlarında güvenilirlik, ölçeklenebilirlik ve kullanım kolaylığına değer veren geliştiriciler için pratik bir seçimdir.
using IronPdf;
class Program
{
static void Main()
{
// Specify license key
IronPdf.License.LicenseKey = "Your Key";
// Create a new HtmlToPdf object using ChromePdfRenderer
var Renderer = new ChromePdfRenderer();
// Define the HTML string to be converted
string htmlContent = "<html><body><h1>IronPDF: Better than Open source</h1></body></html>";
// Convert the HTML string to a PDF document
var document = Renderer.RenderHtmlAsPdf(htmlContent);
// Save the PDF document to a file
document.SaveAs("html2Pdf.pdf");
Console.WriteLine("PDF generated and saved successfully!");
}
}Imports IronPdf
Friend Class Program
Shared Sub Main()
' Specify license key
IronPdf.License.LicenseKey = "Your Key"
' Create a new HtmlToPdf object using ChromePdfRenderer
Dim Renderer = New ChromePdfRenderer()
' Define the HTML string to be converted
Dim htmlContent As String = "<html><body><h1>IronPDF: Better than Open source</h1></body></html>"
' Convert the HTML string to a PDF document
Dim document = Renderer.RenderHtmlAsPdf(htmlContent)
' Save the PDF document to a file
document.SaveAs("html2Pdf.pdf")
Console.WriteLine("PDF generated and saved successfully!")
End Sub
End ClassLisans Anahtarı Kurulumu: Program, kütüphanenin tam işlevselliğinin kilidini açmak için gereken IronPDF lisans anahtarını ayarlayarak başlar.
Render Oluşturma: ChromePdfRenderer'nin bir örneği başlatılır. Bu bileşen, ham HTML ve nihai çıktı arasında bir köprü olarak hareket ederek, HTML içeriğini bir PDF belgesine dönüştürmekten sorumludur.
HTML İçeriğini Tanımlama: PDF'ye dönüştürülecek HTML yapısını depolamak için htmlContent adlı bir string değişkeni oluşturulur. Bu örnekte, basit bir başlık içerir.
HTML'i PDF'ye Dönüştürme: HTML string'i giriş olarak vererek, ChromePdfRenderer örneği üzerinde RenderHtmlAsPdf() yöntemi çağrılır. Bu fonksiyon, içeriği işleyip bir PDF belgesine dönüştürür.
PDF'yi Kaydetme: Son olarak, oluşturulan PDF, SaveAs() yöntemi kullanılarak "html2Pdf.pdf" adlı bir dosyaya kaydedilir, gelecekteki erişim için diskte saklanır.
IronPDF'nin tam işlevselliği için geçerli bir lisans anahtarı gereklidir. Resmi web sitesinden bir deneme lisansı elde edebilirsiniz. IronPDF kütüphanesini kullanmadan önce, lisans anahtarını aşağıdaki gibi ayarlayın:
IronPdf.License.LicenseKey = "your key";IronPdf.License.LicenseKey = "your key"Bu, kütüphanenin sınırlama olmadan çalışmasını sağlar.
PuppeteerSharp, özellikle karmaşık web sayfalarıyla ilgilenildiğinde, HTML'den PDF'ye hassas render ihtiyacı olan geliştiriciler için mükemmel bir seçimdir. Ancak, gelişmiş PDF özellikleri, performans optimizasyonu ve kolay entegrasyon gerektiren uygulamalar için IronPDF gibi profesyonel araçlar genellikle daha iyi bir seçenektir.
PDFSharp, basit gereksinimleri olan projeler için hafif, programatik PDF oluşturma ve işleme için harika bir seçimdir. Bununla birlikte, uygulamanız HTML'den PDF'ye dönüştürme veya gelişmiş PDF özellikleri gerektiriyorsa, IronPDF daha verimli ve özellik açısından zengin bir çözüm sunar.
Pdfium.NET SDK güçlü bir PDF manipülasyon aracı olmasına rağmen, IronPDF modern HTML, CSS ve JavaScript'i render etme dahil olmak üzere doğrudan HTML'den PDF'ye dönüştürme için yerel destek sağlar. IronPDF, HtmlToPdf.RenderHtmlAsPdf() gibi yerleşik yöntemlerle iş akışını basitleştirir, bu sayede geliştiriciler için daha hızlı ve daha verimli hale getirir.
İster fatura, rapor üretiyor olun, ister web içeriğini arşivliyor olun, IronPDF, profesyonel sonuçlara hızlı ve verimli bir şekilde ulaşmanız için geliştiricileri güçlendirir.
IronPDF, HTML'den PDF'ye iş akışlarında güvenilirlik, ölçeklenebilirlik ve kullanım kolaylığına değer veren geliştiriciler için pratik bir seçimdir.
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ı.
