HTML'den PDF'ye C#'da .NET Geliştiricileri için (Nihai Kılavuz)

Ogrenecekleriniz

Bu kılavuzda, çeşitli kutuphaneler across HTML'i PDF'ye C# veri donussturme yeteneklerini kesfedeceksiniz. PDF belgelerini işlemeden, HTML formlarindan, ozel kenar bosluklarindan guvenli PDF'lere kadar her seyi ogreniyorsunuz. Bu makalede ele alinacak konular:

1. HTML'den PDF'ye Araçları Neden Karşılaştırmalı?
2. IronPDF: HTML'den PDF'ye Dönüşüm
3. Aspose: HTML'den PDF'ye Dönüşüm
4. iText 9: HTML'den PDF'ye Dönüşüm
5. wkhtmltopdf: HTML'den PDF'ye Dönüşüm
6. PuppeteerSharp: HTML'den PDF'ye Dönüşüm
7. Neden IronPDF'yi Seçmelisiniz?

Sonunda, IronPDF'nin geliştiriciler dostu ve etkili bir HTML'den PDF'ye dönüştürucu olarak neden on planda olduğunu anlayacaksiniz. IronPDF'nin, IronPDF'nin, Aspose.PDF, iText 9, wkhtmltopdf ve PuppeteerSharp ile nasıl karşılaştırıldığını ve projeniz için hangi en uygun olduğunuzu görmek için diğer karşılaştırma kılavuzlarımıza bakmayı unutmayın.

HTML Dizesinden PDF'ye

Bir dizeden PDF'e HTML dönüştürmek, IronPDF ile basittir. Bu yaklaşım, dinamik içerik oluşturma veya küçük HTML kırıntıları için idealdir.

Örnek:

using IronPdf;
class Program
{
    static void Main(string[] args)
    {
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderHtmlAsPdf("<h1>Hello, World!</h1>");
        pdf.SaveAs("output.pdf");
    }
}

using IronPdf;
class Program
{
    static void Main(string[] args)
    {
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderHtmlAsPdf("<h1>Hello, World!</h1>");
        pdf.SaveAs("output.pdf");
    }
}

Imports IronPdf

Class Program
    Shared Sub Main(args As String())
        Dim renderer = New ChromePdfRenderer()
        Dim pdf = renderer.RenderHtmlAsPdf("<h1>Hello, World!</h1>")
        pdf.SaveAs("output.pdf")
    End Sub
End Class

Oluşturulan PDF Belgesi

Açıklama:

1. ChromePdfRenderer: ChromePdfRenderer sınıfı, IronPDF'de HTML'yi PDF'ye dönüştürmek için birincil araçtır. Çoğu kullanım durumunu çok az ayarlamayla ele alacak şekilde önceden yapılandırılmıştı.
2. RenderHtmlAsPdf: Bu metot, giriş olarak bir HTML dizesi alır ve bir PDF belgesi oluşturur.
3. SaveAs: Oluşturulan PDF belirtilen yola (output.pdf) kaydedilir.

Yerel HTML Dosyasını PDF'e Dönüştürmek

CSS veya JavaScript gibi harici kaynakları olan bir yerel HTML dosyasını hareketlendirecek uygulamalar için IronPDF'i kullanmak kolaydır.

Örnek:

using IronPdf;
class Program
{
    static void Main(string[] args)
    {
        var renderer = new ChromePdfRenderer();
        PdfDocument pdf = renderer.RenderHtmlFileAsPdf("template.html");
        pdf.SaveAs("report.pdf");
    }
}

using IronPdf;
class Program
{
    static void Main(string[] args)
    {
        var renderer = new ChromePdfRenderer();
        PdfDocument pdf = renderer.RenderHtmlFileAsPdf("template.html");
        pdf.SaveAs("report.pdf");
    }
}

Imports IronPdf
Friend Class Program
	Shared Sub Main(ByVal args() As String)
		Dim renderer = New ChromePdfRenderer()
		Dim pdf As PdfDocument = renderer.RenderHtmlFileAsPdf("template.html")
		pdf.SaveAs("report.pdf")
	End Sub
End Class

Giriş HTML Dosyası

Çıktı

Açıklama:

• RenderHtmlFileAsPdf: Yerel bir HTML dosyasını alır ve bunu PDF'e dönüştürür.
• Bağlantılı kaynakları, dış CSS ve JavaScript dosyaları gibi, otomatik olarak işler.

URL'den PDF'e

IronPDF, özellikle URL'ler'den ve JavaScript kullanan sayfalardan dinamik web içeriklerini dönüştürmede çok güçlüdür.

Örnek:

using IronPdf;
class Program
{
    static void Main(string[] args)
    {
        var renderer = new ChromePdfRenderer();
        renderer.RenderingOptions.EnableJavaScript = true;
        renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print;
        renderer.RenderingOptions.WaitFor.RenderDelay(3000); // Wait up to 3 seconds for JS to load

        PdfDocument pdf = renderer.RenderUrlAsPdf("https://apple.com");
        pdf.SaveAs("url-to-pdf.pdf");
    }
}

using IronPdf;
class Program
{
    static void Main(string[] args)
    {
        var renderer = new ChromePdfRenderer();
        renderer.RenderingOptions.EnableJavaScript = true;
        renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print;
        renderer.RenderingOptions.WaitFor.RenderDelay(3000); // Wait up to 3 seconds for JS to load

        PdfDocument pdf = renderer.RenderUrlAsPdf("https://apple.com");
        pdf.SaveAs("url-to-pdf.pdf");
    }
}

Imports IronPdf

Class Program
    Shared Sub Main(args As String())
        Dim renderer = New ChromePdfRenderer()
        renderer.RenderingOptions.EnableJavaScript = True
        renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print
        renderer.RenderingOptions.WaitFor.RenderDelay(3000) ' Wait up to 3 seconds for JS to load

        Dim pdf As PdfDocument = renderer.RenderUrlAsPdf("https://apple.com")
        pdf.SaveAs("url-to-pdf.pdf")
    End Sub
End Class

Çıktı

Açıklama:

• RenderUrlAsPdf: URL içeriğini, JavaScript ile render edilmiş öğeleri dahil olmak üzere, alır ve PDF'e dönüştürür.

Karar / Ne Zaman Kullanılır

IronPDF, kolay API entegrasyonu, minimal kod ve PDF belgelerini manipüle etme, dinamik belgeler oluşturma, HTML formları, özel başlıklar ve yazdırılabilir web içerik versiyonlarını destekleme ihtiyaçı olan geliştiriciler için mükemmeldir. .NET Core veya .NET Framework projeleri için Visual Studio'da idealdir.

HTML Dizesinden PDF'e

Aspose, HTML dizelerini IronPDF'ye kıyasla dönüştürmek için biraz daha fazla kurulum gerektirir.

Örnek:

using Aspose.Html;
using Aspose.Html.Saving;

Document doc = new Document();
Page page = doc.getPages().Add();
HtmlFragment htmlFragment = new HtmlFragment("<h1>HTML String</h1>");
page.getParagraphs().Add(htmlFragment);
doc.Save("HTMLStringUsingDOM.pdf");

using Aspose.Html;
using Aspose.Html.Saving;

Document doc = new Document();
Page page = doc.getPages().Add();
HtmlFragment htmlFragment = new HtmlFragment("<h1>HTML String</h1>");
page.getParagraphs().Add(htmlFragment);
doc.Save("HTMLStringUsingDOM.pdf");

Imports Aspose.Html
Imports Aspose.Html.Saving

Private doc As New Document()
Private page As Page = doc.getPages().Add()
Private htmlFragment As New HtmlFragment("<h1>HTML String</h1>")
page.getParagraphs().Add(htmlFragment)
doc.Save("HTMLStringUsingDOM.pdf")

Çıktı

Açıklama:

• Document doc: Dönüştürülen HTML dizesini kaydetmek için yeni bir belge oluşturur.
• Page page: Bu satır, oluşturduğumuz boş belgeye yeni bir sayfa ekler.
• HtmlFragment htmlFragment: Bu, dönüştürdüğümüz HTML dizisidir.
• page.getParagraphs().Add(htmlFragment): HTML'i belgeye ekler.
• doc.Save: HTML içeriğini PDF belgesi olarak kaydeder.

Yerel HTML Dosyasından PDF'e

Aspose ayrıca yerel HTML dosyalarını PDF'e dönüştürmeyi de ele alır, ancak IronPDF'den daha fazla yapılandırma gerektirir.

Örnek:

using Aspose.Html;
using Aspose.Html.Converters;
using Aspose.Html.Saving;

var document = new HTMLDocument("document.html");
var options = new PdfSaveOptions();
Converter.ConvertHTML(document, options, "output.pdf");

using Aspose.Html;
using Aspose.Html.Converters;
using Aspose.Html.Saving;

var document = new HTMLDocument("document.html");
var options = new PdfSaveOptions();
Converter.ConvertHTML(document, options, "output.pdf");

Imports Aspose.Html
Imports Aspose.Html.Converters
Imports Aspose.Html.Saving

Private document = New HTMLDocument("document.html")
Private options = New PdfSaveOptions()
Converter.ConvertHTML(document, options, "output.pdf")

Giriş HTML:

Çıktı:

Açıklama:

• var document = new HTMLDocument("document.html"): HTML dosyasını yükler.
• var options: Yeni bir PdfSaveOptions nesnesi oluşturur.
• Converter.ConvertHTML(): HTML'yi PDF'e dönüştürür.

URL'den PDF'e

Aspose URL'ler için de benzer işlevsellik sağlar ancak ekstra kurulum gerektirir.

Örnek:

using System.IO;
using System;
using System.Net.Http;
using Aspose.Pdf;

HttpClient client = new HttpClient();
HttpResponseMessage response = await client.GetAsync("https://www.apple.com");
response.EnsureSuccessStatusCode();
string responseFromServer = await response.Content.ReadAsStringAsync();
MemoryStream stream = new MemoryStream(System.Text.Encoding.UTF8.GetBytes(responseFromServer));
HtmlLoadOptions options = new HtmlLoadOptions("https://www.apple.com");
Document pdfDocument = new Document(stream, options);
pdfDocument.Save("WebPageToPDF_out.pdf");

using System.IO;
using System;
using System.Net.Http;
using Aspose.Pdf;

HttpClient client = new HttpClient();
HttpResponseMessage response = await client.GetAsync("https://www.apple.com");
response.EnsureSuccessStatusCode();
string responseFromServer = await response.Content.ReadAsStringAsync();
MemoryStream stream = new MemoryStream(System.Text.Encoding.UTF8.GetBytes(responseFromServer));
HtmlLoadOptions options = new HtmlLoadOptions("https://www.apple.com");
Document pdfDocument = new Document(stream, options);
pdfDocument.Save("WebPageToPDF_out.pdf");

Imports System.IO
Imports System
Imports System.Net.Http
Imports Aspose.Pdf

Dim client As New HttpClient()
Dim response As HttpResponseMessage = Await client.GetAsync("https://www.apple.com")
response.EnsureSuccessStatusCode()
Dim responseFromServer As String = Await response.Content.ReadAsStringAsync()
Dim stream As New MemoryStream(System.Text.Encoding.UTF8.GetBytes(responseFromServer))
Dim options As New HtmlLoadOptions("https://www.apple.com")
Dim pdfDocument As New Document(stream, options)
pdfDocument.Save("WebPageToPDF_out.pdf")

Çıktı

Açıklama:

• dataDir değişkeni, oluşturulan PDF'nin kaydedileceği dizini tutar.
• Bir WebRequest, Wikipedia ana sayfa URL'sine erişmek üzere oluşturulur ve istek için varsayılan kimlik bilgileri kullanılır.
• GetResponse() metodu, isteği gönderir ve yanıtı bir HttpWebResponse olarak alır.
• Yanıttan bir akış elde edilir ve bir StreamReader, sayfanın tüm HTML içeriğini responseFromServer dizesine okur.
• responseFromServer HTML içeriği bir bayt dizisine dönüştürülür ve ardından bir MemoryStream içine yüklenir.
• HtmlLoadOptions, göreceli bağlantılar için temel URL'yi ve diğer ayarları belirtmek için kullanılır.
• Bellek akışından HTML içeren bir Aspose.Pdf.Document oluşturulur ve belge belirtilen dizine PDF olarak kaydedilir.

Karar / Ne Zaman Kullanılır

Aspose.PDF, gelişmiş PDF manipülasyonu ve dönüştürme gerektiren kurumsal projeler için en iyisidir. Güçlüdür ancak hızlı HTML'den PDF'e görevleri için daha az akıcıdır.

HTML Dizesinden PDF'e

iText 9 kullanarak bir HTML dizesini PDF belgesine dönüştürmenin temel bir örneği.

Örnek:

using iText.Html2pdf;
using System.IO;

class Program
{
    static void Main()
    {
        string html = "<h1>Hello World</h1><p>This is a simple PDF generated from HTML.</p>";
        string outputFile = "SimpleHtmlToPdf.pdf";

        using (var pdfStream = new FileStream(outputFile, FileMode.Create))
        {
            HtmlConverter.ConvertToPdf(html, pdfStream);
        }

        System.Console.WriteLine("PDF generated: " + outputFile);
    }
}

using iText.Html2pdf;
using System.IO;

class Program
{
    static void Main()
    {
        string html = "<h1>Hello World</h1><p>This is a simple PDF generated from HTML.</p>";
        string outputFile = "SimpleHtmlToPdf.pdf";

        using (var pdfStream = new FileStream(outputFile, FileMode.Create))
        {
            HtmlConverter.ConvertToPdf(html, pdfStream);
        }

        System.Console.WriteLine("PDF generated: " + outputFile);
    }
}

Imports iText.Html2pdf
Imports System.IO

Class Program
    Shared Sub Main()
        Dim html As String = "<h1>Hello World</h1><p>This is a simple PDF generated from HTML.</p>"
        Dim outputFile As String = "SimpleHtmlToPdf.pdf"

        Using pdfStream As New FileStream(outputFile, FileMode.Create)
            HtmlConverter.ConvertToPdf(html, pdfStream)
        End Using

        System.Console.WriteLine("PDF generated: " & outputFile)
    End Sub
End Class

Çıktı

Yerel HTML Dosyasından PDF'e

iText 9, HtmlConverter.ConvertToPdf sınıfını kullanarak HTML dosya türlerini PDF'e dönüştürebilir.

Örnek:

using iText.Html2pdf;
using System.IO;

class Program
{
    static void Main()
    {
        string htmlFile = "document.html";
        string outputPdf = "html-file-to-pdf.pdf";

        // Read HTML content from file
        string htmlContent = File.ReadAllText(htmlFile);

        // Convert HTML string to PDF
        HtmlConverter.ConvertToPdf(htmlContent, new FileStream(outputPdf, FileMode.Create));

        System.Console.WriteLine("PDF generated: " + outputPdf);
    }
}

using iText.Html2pdf;
using System.IO;

class Program
{
    static void Main()
    {
        string htmlFile = "document.html";
        string outputPdf = "html-file-to-pdf.pdf";

        // Read HTML content from file
        string htmlContent = File.ReadAllText(htmlFile);

        // Convert HTML string to PDF
        HtmlConverter.ConvertToPdf(htmlContent, new FileStream(outputPdf, FileMode.Create));

        System.Console.WriteLine("PDF generated: " + outputPdf);
    }
}

Imports iText.Html2pdf
Imports System.IO

Module Program
    Sub Main()
        Dim htmlFile As String = "document.html"
        Dim outputPdf As String = "html-file-to-pdf.pdf"

        ' Read HTML content from file
        Dim htmlContent As String = File.ReadAllText(htmlFile)

        ' Convert HTML string to PDF
        HtmlConverter.ConvertToPdf(htmlContent, New FileStream(outputPdf, FileMode.Create))

        System.Console.WriteLine("PDF generated: " & outputPdf)
    End Sub
End Module

Çıktı

Açıklama:

• HtmlConverter: Bir HTML dosyasını doğrudan PDF'e dönüştürür.

URL'den PDF'e

iText7 ayrıca URL'lerden gelen içeriklerin dönüştürülmesini de destekler.

Örnek:

using iText.Html2pdf;
using System;
using System.IO;
using System.Net.Http;
using System.Threading.Tasks;

class Program
{
    static async Task Main()
    {
        string url = "https://apple.com";
        string outputPdf = "url-to-pdf.pdf";

        using var httpClient = new HttpClient();
        // Fetch the HTML content from the URL
        string htmlContent = await httpClient.GetStringAsync(url);

        // Convert HTML content to PDF
        HtmlConverter.ConvertToPdf(htmlContent, new FileStream(outputPdf, FileMode.Create));

        Console.WriteLine("PDF generated: " + outputPdf);
    }
}

using iText.Html2pdf;
using System;
using System.IO;
using System.Net.Http;
using System.Threading.Tasks;

class Program
{
    static async Task Main()
    {
        string url = "https://apple.com";
        string outputPdf = "url-to-pdf.pdf";

        using var httpClient = new HttpClient();
        // Fetch the HTML content from the URL
        string htmlContent = await httpClient.GetStringAsync(url);

        // Convert HTML content to PDF
        HtmlConverter.ConvertToPdf(htmlContent, new FileStream(outputPdf, FileMode.Create));

        Console.WriteLine("PDF generated: " + outputPdf);
    }
}

Imports iText.Html2pdf
Imports System
Imports System.IO
Imports System.Net.Http
Imports System.Threading.Tasks

Module Program
    Async Function Main() As Task
        Dim url As String = "https://apple.com"
        Dim outputPdf As String = "url-to-pdf.pdf"

        Using httpClient As New HttpClient()
            ' Fetch the HTML content from the URL
            Dim htmlContent As String = Await httpClient.GetStringAsync(url)

            ' Convert HTML content to PDF
            HtmlConverter.ConvertToPdf(htmlContent, New FileStream(outputPdf, FileMode.Create))

            Console.WriteLine("PDF generated: " & outputPdf)
        End Using
    End Function
End Module

Çıktı

Açıklama:

• HttpClient.GetStringAsync(url): URL'den gerçek HTML içeriğini indirir.
• HtmlConverter.ConvertToPdf(htmlContent, …): Alınan HTML dizesini render edilmiş bir PDF'e dönüştürür.

Karar / Ne Zaman Kullanılır

iText 9, PDF oluşturma, manipülasyon ve HTML'den PDF'e dönüştürme için sağlam, kurumsal seviyede bir çözüm ihtiyaçı olan geliştiriciler için uygundur. Oluşturulan PDF üzerinde hassas kontrol, mevcut iText iş akışları ile entegrasyon veya dijital imzalar ve formlar gibi gelişmiş PDF özellikleri gerektiğinde iyi çalışır. Ancak, basit HTML'den PDF'e görevleri için, iText 9, IronPDF gibi daha akıcı kütüphanelerden daha ağır ve daha karmaşıktır.

Arşiv ve Bakım Durumu

wkhtmltopdf artık aktif bir şekilde bakım yapılmamaktadır belirtmek önemlidir. GitHub deposu, Ocak 2023'te resmi olarak arşivlenmiş ve sadece okunur durumuna getirilmiştir, yani gelecekte güncellemeler, hata düzeltmeleri veya güvenlik yamaları uygulanmamaktadır.

Geliştiriciler için Sonuç: wkhtmltopdf çok temel kullanım senaryoları için hala etkili olabilse de, bakım yapılmayan statüsü ve eski render motoru onu özellikle dinamik veya dış HTML içeriklerini işleyen üretim ortamları veya uygulamalar için riskli bir seçim haline getirir.

wkhtmltopdf, Webkit render kullanarak HTML dosyalarını PDF'e dönüştüren bir komut satırı aracıdır. Farklı senaryolar için nasıl çalıştığı:

HTML Dizesinden PDF'e

wkhtmltopdf, HTML dizelerini önce bir dosyaya yazarak dönüştürme gerektiriyor.

Örnek:

using System;
using System.IO;
using System.Diagnostics;
class Program
{
    static void Main(string[] args)
    {
        // HTML string to be converted to PDF
        string html = "<html><body><h1>Hello, World!</h1></body></html>";
        // Write HTML string to temporary file
        string tempHtmlFile = Path.Combine(Path.GetTempPath(), "temp.html");
        File.WriteAllText(tempHtmlFile, html);
        // Set output PDF path
        string outputPdfFile = Path.Combine(Path.GetTempPath(), "html-string-to-pdf.pdf");
        // Execute wkhtmltopdf command
        Process process = new Process();
        process.StartInfo.FileName = "wkhtmltopdf";
        process.StartInfo.Arguments = $"\"{tempHtmlFile}\" \"{outputPdfFile}\"";
        process.StartInfo.WindowStyle = ProcessWindowStyle.Hidden;
        process.Start();
        process.WaitForExit();
        // Clean up the temporary HTML file
        File.Delete(tempHtmlFile);
        Console.WriteLine($"PDF saved to: {outputPdfFile}");
    }
}

using System;
using System.IO;
using System.Diagnostics;
class Program
{
    static void Main(string[] args)
    {
        // HTML string to be converted to PDF
        string html = "<html><body><h1>Hello, World!</h1></body></html>";
        // Write HTML string to temporary file
        string tempHtmlFile = Path.Combine(Path.GetTempPath(), "temp.html");
        File.WriteAllText(tempHtmlFile, html);
        // Set output PDF path
        string outputPdfFile = Path.Combine(Path.GetTempPath(), "html-string-to-pdf.pdf");
        // Execute wkhtmltopdf command
        Process process = new Process();
        process.StartInfo.FileName = "wkhtmltopdf";
        process.StartInfo.Arguments = $"\"{tempHtmlFile}\" \"{outputPdfFile}\"";
        process.StartInfo.WindowStyle = ProcessWindowStyle.Hidden;
        process.Start();
        process.WaitForExit();
        // Clean up the temporary HTML file
        File.Delete(tempHtmlFile);
        Console.WriteLine($"PDF saved to: {outputPdfFile}");
    }
}

Imports System
Imports System.IO
Imports System.Diagnostics
Friend Class Program
	Shared Sub Main(ByVal args() As String)
		' HTML string to be converted to PDF
		Dim html As String = "<html><body><h1>Hello, World!</h1></body></html>"
		' Write HTML string to temporary file
		Dim tempHtmlFile As String = Path.Combine(Path.GetTempPath(), "temp.html")
		File.WriteAllText(tempHtmlFile, html)
		' Set output PDF path
		Dim outputPdfFile As String = Path.Combine(Path.GetTempPath(), "html-string-to-pdf.pdf")
		' Execute wkhtmltopdf command
		Dim process As New Process()
		process.StartInfo.FileName = "wkhtmltopdf"
		process.StartInfo.Arguments = $"""{tempHtmlFile}"" ""{outputPdfFile}"""
		process.StartInfo.WindowStyle = ProcessWindowStyle.Hidden
		process.Start()
		process.WaitForExit()
		' Clean up the temporary HTML file
		File.Delete(tempHtmlFile)
		Console.WriteLine($"PDF saved to: {outputPdfFile}")
	End Sub
End Class

Çıktı

Açıklama:

• wkhtmltopdf bir giriş dosyası gerektirir, bu yüzden HTML dizesini öncelikle geçici bir dosyaya (temp.html) yazarız.
• Ardından, Process sınıfını kullanarak geçici HTML dosyasının dosya yolunu ve istenen çıktı PDF yolunu argüman olarak geçirerek wkhtmltopdf komutunu çalıştırırız.
• Dönüştürmeden sonra, geçici HTML dosyasını temizlemek için sileriz.

Yerel HTML Dosyasından PDF'e

wkhtmltopdf kullanarak bir yerel HTML dosyasını PDF'e dönüştürmek için, HTML dosyasının dosya yolunu doğrudan gösterebilirsiniz.

Örnek:

using System;
using System.Diagnostics;

class Program
{
    static void Main(string[] args)
    {
        // Path to the local HTML file
        string htmlFilePath = @"C:\path\to\your\document.html";
        // Path for the output PDF file
        string outputPdfFile = @"C:\path\to\output\html-file-to-pdf.pdf";
        // Execute wkhtmltopdf command
        Process process = new Process();
        process.StartInfo.FileName = "wkhtmltopdf";
        process.StartInfo.Arguments = $"\"{htmlFilePath}\" \"{outputPdfFile}\"";
        process.StartInfo.WindowStyle = ProcessWindowStyle.Hidden;
        process.Start();
        process.WaitForExit();
        Console.WriteLine($"PDF saved to: {outputPdfFile}");
    }
}

using System;
using System.Diagnostics;

class Program
{
    static void Main(string[] args)
    {
        // Path to the local HTML file
        string htmlFilePath = @"C:\path\to\your\document.html";
        // Path for the output PDF file
        string outputPdfFile = @"C:\path\to\output\html-file-to-pdf.pdf";
        // Execute wkhtmltopdf command
        Process process = new Process();
        process.StartInfo.FileName = "wkhtmltopdf";
        process.StartInfo.Arguments = $"\"{htmlFilePath}\" \"{outputPdfFile}\"";
        process.StartInfo.WindowStyle = ProcessWindowStyle.Hidden;
        process.Start();
        process.WaitForExit();
        Console.WriteLine($"PDF saved to: {outputPdfFile}");
    }
}

Imports System
Imports System.Diagnostics

Module Program
    Sub Main(args As String())
        ' Path to the local HTML file
        Dim htmlFilePath As String = "C:\path\to\your\document.html"
        ' Path for the output PDF file
        Dim outputPdfFile As String = "C:\path\to\output\html-file-to-pdf.pdf"
        ' Execute wkhtmltopdf command
        Dim process As New Process()
        process.StartInfo.FileName = "wkhtmltopdf"
        process.StartInfo.Arguments = $"""{htmlFilePath}"" ""{outputPdfFile}"""
        process.StartInfo.WindowStyle = ProcessWindowStyle.Hidden
        process.Start()
        process.WaitForExit()
        Console.WriteLine($"PDF saved to: {outputPdfFile}")
    End Sub
End Module

Çıktı

Açıklama:

• Bu örnek, yerel HTML dosyasının (template.html) yolunu ve PDF için çıkış yolunu sağlar.
• wkhtmltopdf direkt olarak yerel dosyaları işler, bu da komutu basit hale getirir.

URL'den PDF'e

wkhtmltopdf ile bir URL'yi PDF'e dönüştürmek kolaydır. Yalnızca URL'yi doğrudan komuta geçirin.

Örnek:

using System;
using System.Diagnostics;

class Program
{
    static void Main(string[] args)
    {
        // URL to be converted to PDF
        string url = "https://apple.com";
        // Path for the output PDF file
        string outputPdfFile = @"C:\path\to\output\url-to-pdf.pdf";
        // Execute wkhtmltopdf command
        Process process = new Process();
        process.StartInfo.FileName = "wkhtmltopdf";
        process.StartInfo.Arguments = $"\"{url}\" \"{outputPdfFile}\"";
        process.StartInfo.WindowStyle = ProcessWindowStyle.Hidden;
        process.Start();
        process.WaitForExit();
        Console.WriteLine($"PDF saved to: {outputPdfFile}");
    }
}

using System;
using System.Diagnostics;

class Program
{
    static void Main(string[] args)
    {
        // URL to be converted to PDF
        string url = "https://apple.com";
        // Path for the output PDF file
        string outputPdfFile = @"C:\path\to\output\url-to-pdf.pdf";
        // Execute wkhtmltopdf command
        Process process = new Process();
        process.StartInfo.FileName = "wkhtmltopdf";
        process.StartInfo.Arguments = $"\"{url}\" \"{outputPdfFile}\"";
        process.StartInfo.WindowStyle = ProcessWindowStyle.Hidden;
        process.Start();
        process.WaitForExit();
        Console.WriteLine($"PDF saved to: {outputPdfFile}");
    }
}

Imports System
Imports System.Diagnostics

Module Program
    Sub Main(args As String())
        ' URL to be converted to PDF
        Dim url As String = "https://apple.com"
        ' Path for the output PDF file
        Dim outputPdfFile As String = "C:\path\to\output\url-to-pdf.pdf"
        ' Execute wkhtmltopdf command
        Dim process As New Process()
        process.StartInfo.FileName = "wkhtmltopdf"
        process.StartInfo.Arguments = $"""{url}"" ""{outputPdfFile}"""
        process.StartInfo.WindowStyle = ProcessWindowStyle.Hidden
        process.Start()
        process.WaitForExit()
        Console.WriteLine($"PDF saved to: {outputPdfFile}")
    End Sub
End Module

Çıktı

Açıklama:

• Bu örnekte, wkhtmltopdf doğrudan giriş olarak URL'leri kabul eder.
• URL, wkhtmltopdf'a bir argüman olarak gönderilir ve çıktı belirtilen yola PDF olarak kaydedilir.

HTML Dizesinden PDF'e

Puppeteer tam sayfa render etmek için tasarlanmıştır, bu nedenle bir HTML dizesini dönüştürmek, onu bir dosyaya yazmayı veya doğrudan bir tarayıcıda render etmeyi gerektirir.

Örnek:

using PuppeteerSharp;
using System;
using System.Threading.Tasks;

class Program
{
    static async Task Main(string[] args)
    {
       // Download the browser if necessary
        await new BrowserFetcher().DownloadAsync();
        var browser = await Puppeteer.LaunchAsync(new LaunchOptions { Headless = true });
        var page = await browser.NewPageAsync();
        string htmlContent = "<h1>Hello, World!</h1><p>This is a PDF generated from HTML string.</p>";
        await page.SetContentAsync(htmlContent);
        // Save the page as a PDF
        await page.PdfAsync("html-string-to-pdf.pdf");
        await browser.CloseAsync();
    }
}

using PuppeteerSharp;
using System;
using System.Threading.Tasks;

class Program
{
    static async Task Main(string[] args)
    {
       // Download the browser if necessary
        await new BrowserFetcher().DownloadAsync();
        var browser = await Puppeteer.LaunchAsync(new LaunchOptions { Headless = true });
        var page = await browser.NewPageAsync();
        string htmlContent = "<h1>Hello, World!</h1><p>This is a PDF generated from HTML string.</p>";
        await page.SetContentAsync(htmlContent);
        // Save the page as a PDF
        await page.PdfAsync("html-string-to-pdf.pdf");
        await browser.CloseAsync();
    }
}

Imports PuppeteerSharp
Imports System
Imports System.Threading.Tasks

Module Program
    Async Function Main(args As String()) As Task
        ' Download the browser if necessary
        Await (New BrowserFetcher()).DownloadAsync()
        Dim browser = Await Puppeteer.LaunchAsync(New LaunchOptions With {.Headless = True})
        Dim page = Await browser.NewPageAsync()
        Dim htmlContent As String = "<h1>Hello, World!</h1><p>This is a PDF generated from HTML string.</p>"
        Await page.SetContentAsync(htmlContent)
        ' Save the page as a PDF
        Await page.PdfAsync("html-string-to-pdf.pdf")
        Await browser.CloseAsync()
    End Function
End Module

Çıktı

Açıklama:

• Puppeteer.LaunchAsync: Başsız modda yeni bir Chromium örneği başlatır.
• page.SetContentAsync: HTML dizesini tarayıcı sayfasına yükler.
• page.PdfAsync: Yüklenen HTML'yi PDF'e dönüştürür ve bir dosyaya kaydeder.

Yerel HTML Dosyasından PDF'e

PuppeteerSharp kullanarak bir yerel HTML dosyasını PDF'e dönüştürmek için, dosyayı başsız bir tarayıcıda yükleyip PDF oluşturabilirsiniz.

Örnek:

using PuppeteerSharp;
using System;
using System.Threading.Tasks;

class Program
{
    static async Task Main(string[] args)
    {
        // Download the browser if necessary
        await new BrowserFetcher().DownloadAsync(BrowserFetcher.DefaultRevision);
        var browser = await Puppeteer.LaunchAsync(new LaunchOptions { Headless = true });
        var page = await browser.NewPageAsync();

        // Load the local HTML file
        await page.GoToAsync("file:///path/to/your/template.html");

        // Save the page as a PDF
        await page.PdfAsync("html-file-to-pdf.pdf");
        await browser.CloseAsync();
    }
}

using PuppeteerSharp;
using System;
using System.Threading.Tasks;

class Program
{
    static async Task Main(string[] args)
    {
        // Download the browser if necessary
        await new BrowserFetcher().DownloadAsync(BrowserFetcher.DefaultRevision);
        var browser = await Puppeteer.LaunchAsync(new LaunchOptions { Headless = true });
        var page = await browser.NewPageAsync();

        // Load the local HTML file
        await page.GoToAsync("file:///path/to/your/template.html");

        // Save the page as a PDF
        await page.PdfAsync("html-file-to-pdf.pdf");
        await browser.CloseAsync();
    }
}

Imports PuppeteerSharp
Imports System
Imports System.Threading.Tasks

Friend Class Program
	Shared Async Function Main(ByVal args() As String) As Task
		' Download the browser if necessary
		Await (New BrowserFetcher()).DownloadAsync(BrowserFetcher.DefaultRevision)
		Dim browser = Await Puppeteer.LaunchAsync(New LaunchOptions With {.Headless = True})
		Dim page = Await browser.NewPageAsync()

		' Load the local HTML file
		Await page.GoToAsync("file:///path/to/your/template.html")

		' Save the page as a PDF
		Await page.PdfAsync("html-file-to-pdf.pdf")
		Await browser.CloseAsync()
	End Function
End Class

Çıktı

Açıklama:

• page.GoToAsync: Yerel HTML dosyasını yükler (doğru [file://]() yolunu kullandığınızdan emin olun).
• page.PdfAsync: Yerel HTML dosyasının içeriğini PDF'e dönüştürür.

URL'den PDF'e

Bir URL'yi PDF'e dönüştürmek, PuppeteerSharp'ın başlıca özelliklerinden biridir, çünkü JavaScript ile karmaşık sayfaları işleyebilir.

Örnek:

using PuppeteerSharp;
using System;
using System.Threading.Tasks;

class Program
{
    static async Task Main(string[] args)
    {
        // Download the browser if necessary
        await new BrowserFetcher().DownloadAsync(BrowserFetcher.DefaultRevision);
        var browser = await Puppeteer.LaunchAsync(new LaunchOptions { Headless = true });
        var page = await browser.NewPageAsync();

        // Navigate to the URL
        await page.GoToAsync("https://example.com");

        // Save the page as a PDF
        await page.PdfAsync("url-to-pdf.pdf");
        await browser.CloseAsync();
    }
}

using PuppeteerSharp;
using System;
using System.Threading.Tasks;

class Program
{
    static async Task Main(string[] args)
    {
        // Download the browser if necessary
        await new BrowserFetcher().DownloadAsync(BrowserFetcher.DefaultRevision);
        var browser = await Puppeteer.LaunchAsync(new LaunchOptions { Headless = true });
        var page = await browser.NewPageAsync();

        // Navigate to the URL
        await page.GoToAsync("https://example.com");

        // Save the page as a PDF
        await page.PdfAsync("url-to-pdf.pdf");
        await browser.CloseAsync();
    }
}

Imports PuppeteerSharp
Imports System
Imports System.Threading.Tasks

Friend Class Program
	Shared Async Function Main(ByVal args() As String) As Task
		' Download the browser if necessary
		Await (New BrowserFetcher()).DownloadAsync(BrowserFetcher.DefaultRevision)
		Dim browser = Await Puppeteer.LaunchAsync(New LaunchOptions With {.Headless = True})
		Dim page = Await browser.NewPageAsync()

		' Navigate to the URL
		Await page.GoToAsync("https://example.com")

		' Save the page as a PDF
		Await page.PdfAsync("url-to-pdf.pdf")
		Await browser.CloseAsync()
	End Function
End Class

Çıktı

Açıklama:

• page.GoToAsync: Belirtilen URL'ye gider.
• page.PdfAsync: URL'deki web sayfasını PDF'e dönüştürür ve kaydeder.

Karar / Ne Zaman Kullanılır

PuppeteerSharp, modern, JavaScript ağırlıklı web uygulamalarının piksel mükemmellikte render edilmesi gerektiğinde idealdir. IronPDF'den daha karmaşıktır ancak dinamik web içeriklerini işleme konusunda üstündür.