1. IronPDF
  2. Nasıl Yapılır
  3. HTML Dizgisini PDF'e Nasıl İşlerim
HTML Dizgisini C# içinde PDF'e Nasıl İşlerim | IronPDF

How to Convert HTML String to PDF in C

Curtis Chau
Curtis Chau
Güncellendi:
This article was translated from English: Does it need improvement?
Translated
View the article in English

IronPDF, HTML dizelerini C#'ta Chrome işleme motorunu kullanarak PDF belgelerine dönüştürür, tüm HTML5, CSS3 ve JavaScript içeriğini tek bir kod satırı ile temel dönüştürmeler için destekler. Kütüphane, mükemmel render sadakati sağlarken PDF'ler oluşturmak için güçlü özellikler sunar.

IronPDF, geliştiricilerin .NET Core ve .NET Framework icin C#, F# ve VB.NET ile kolayca PDF belgeleri oluşturmasina olanak tanir. IronPDF, herhangi bir HTML dizesini PDF'ye dönüştürmeyi destekler ve işleme süreci Google Chromium motorunun tamamen işlevsel bir sürümünü kullanır. Bu, HTML içeriğinin modern bir web tarayıcısında görüldüğü gibi görünmesini sağlar ve raporlar, faturalar ve dinamik HTML içeriklerinden belgeler oluşturmak için idealdir.

Hızlı Başlat: HTML Dizisini Saniyeler İçinde PDF'ye Dönüştürün

IronPDF kullanarak HTML dizelerini PDF dosyalarına dönüştürün. Bu kılavuz, bir HTML dizisini C# içinde PDF belgesine en az kodla nasıl dönüştüreceğinizi gösterir. Projelerine PDF işleme yeteneklerini entegre etmesi gereken geliştiriciler için mükemmeldir.

  1. NuGet Paket Yöneticisi ile https://www.nuget.org/packages/IronPdf yükleyin

    PM > Install-Package IronPdf

  2. Bu kod parçasını kopyalayıp çalıştırın.

    IronPdf.ChromePdfRenderer.StaticRenderHtmlAsPdf("<p>Hello World</p>").SaveAs("string-to-pdf.pdf");

  3. Canlı ortamınızda test etmek için dağıtın

    Bugün projenizde IronPDF kullanmaya başlayın ücretsiz deneme ile

    arrow pointer

Minimal Is Akisi (5 adimda)

IronPDF HTML to PDF conversion workflow showing 5 steps from download to PDF generation with installation command
  1. NuGet'ten IronPDF C# Kütüphanesini İndirin
  2. PDF İşleyici'yi başlatın ve HTML Dizesini Geçirin
  3. PDF'de Dış Varlıklar İçin BasePath'i Yapılandırın
  4. Çıktı PDF'sini ince ayarlamak için RenderingOptions öğesini yapılandırın
  5. Oluşturulan PDF'yi Kaydedin ve İndirin


Basit Bir HTML Dizisini PDF'ye Nasıl Dönüştürürüm?

IronPDF'un bir HTML dizgesini PDF'ye dönüştürurken kullandigi RenderHtmlAsPdf metoduna bir örnek burada. Parametre, PDF olarak işlenecek bir HTML dizesidir. Bu metod, PDF oluşturma ihtiyaçlariniz icin rendering seçenekleri uzerinde genis kontrol saglayan ChromePdfRenderer sinifinin bir parcasidir.

:path=/static-assets/pdf/content-code-examples/how-to/html-string-to-pdf.cs
using IronPdf;

// Instantiate Renderer
var renderer = new ChromePdfRenderer();

// Create a PDF from a HTML string using C#
var pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1>");

// Export to a file or Stream
pdf.SaveAs("output.pdf");
Imports IronPdf

' Instantiate Renderer
Private renderer = New ChromePdfRenderer()

' Create a PDF from a HTML string using C#
Private pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1>")

' Export to a file or Stream
pdf.SaveAs("output.pdf")
$vbLabelText   $csharpLabel

RenderHtmlAsPdf yöntemi, PDF bilgilerini tutan ve PDF birleştirme, filigran ekleme ve güvenlik seçeneklerini ayarlama dahil olmak üzere PDF ile ilgili yöntemler sağlayan bir PdfDocument nesnesi döndürür.

{t:(ASP.NET Core, Blazor veya arka plan hizmetlerinde, iş parçacıklarının engellenmesini önlemek için asenkron varyant RenderHtmlAsPdfAsync öğesini tercih edin. Donusen PdfDocument, IDisposable'i uygular, bu nedenle yuksek verimliligin oldugu senaryolar icin bir using bloguyla sarmaniz gerekmektedir. ChromePdfRenderer, iş parçacığı güvenlidir ve performansı artırmak için bir kez oluşturulup istekler arasında yeniden kullanılabilir.)}

Bir HTML dizgesi dis bir kaynaktan elde edildiginde ve yerel disk erişimini veya farkli kaynaklar arasi istekleri devre disi birakmaniz gerektiginde, rendere başlamadan once IronPdf.Installation.EnableWebSecurity'i true olarak ayarlayin. Bu, statik bir global ayardır, işleyicide bir örnek özelliği değildir.

// Enable web security before rendering untrusted HTML
IronPdf.Installation.EnableWebSecurity = true;
// Enable web security before rendering untrusted HTML
IronPdf.Installation.EnableWebSecurity = true;
' Enable web security before rendering untrusted HTML
IronPdf.Installation.EnableWebSecurity = True
$vbLabelText   $csharpLabel

CSS tarz içerikler içeren karmaşık HTML içeriği için, HTML dizilerinizi satır içi stillerle geliştirin veya Temel URL'ler ve Varlık Kodlaması özelliğini kullanarak dış stilleri referans alın:

// Example with inline CSS
var styledHtml = @"
<html>
<head>
    <style>
        body { font-family: Arial, sans-serif; margin: 40px; }
        h1 { color: #333; border-bottom: 2px solid #0066cc; }
        p { line-height: 1.6; }
    </style>
</head>
<body>
    <h1>Professional Report</h1>
    <p>This PDF was generated from HTML with custom styling.</p>
</body>
</html>";

using var styledPdf = renderer.RenderHtmlAsPdf(styledHtml);
styledPdf.SaveAs("styled-output.pdf");
// Example with inline CSS
var styledHtml = @"
<html>
<head>
    <style>
        body { font-family: Arial, sans-serif; margin: 40px; }
        h1 { color: #333; border-bottom: 2px solid #0066cc; }
        p { line-height: 1.6; }
    </style>
</head>
<body>
    <h1>Professional Report</h1>
    <p>This PDF was generated from HTML with custom styling.</p>
</body>
</html>";

using var styledPdf = renderer.RenderHtmlAsPdf(styledHtml);
styledPdf.SaveAs("styled-output.pdf");
Dim styledHtml As String = "
<html>
<head>
    <style>
        body { font-family: Arial, sans-serif; margin: 40px; }
        h1 { color: #333; border-bottom: 2px solid #0066cc; }
        p { line-height: 1.6; }
    </style>
</head>
<body>
    <h1>Professional Report</h1>
    <p>This PDF was generated from HTML with custom styling.</p>
</body>
</html>"

Using styledPdf = renderer.RenderHtmlAsPdf(styledHtml)
    styledPdf.SaveAs("styled-output.pdf")
End Using
$vbLabelText   $csharpLabel

Oluşturulan PDF Nasıl Görünür?

Bu, kodun ürettiği dosyadır:

Oluşturulan PDF, HTML'nizin tam formatını ve stilini korur, bu onu PDF raporları oluşturmak veya yazdırmaya hazır belgeler için web içeriğini dönüştürmek için mükemmel hale getirir.

HTML'yi PDF'ye Dönüştürürken Harici Varlıkları Nasıl Eklerim?

Bu örnek, isteğe bağlı bir BasePath'den harici bir görüntü varlığı yükleyen IronPDF'yi gösterir. BaseUrlOrPath özelliğini ayarlamak, köprüler, resimler, CSS ve JavaScript dosyalarının bağlamı için relatif dosya yolu veya URL'yi sağlar. Bu, PDF'lerdeki resimlerle ya da dış kaynaklara başvurduğunuzda esastır.

:path=/static-assets/pdf/content-code-examples/how-to/html-string-to-pdf-2.cs
using IronPdf;

// Instantiate Renderer
var renderer = new ChromePdfRenderer();

// Advanced Example with HTML Assets
// Load external html assets: Images, CSS and JavaScript.
// An optional BasePath 'C:\site\assets\' is set as the file location to load assets from
var myAdvancedPdf = renderer.RenderHtmlAsPdf("<img src='icons/iron.png'>", @"C:\site\assets\");
myAdvancedPdf.SaveAs("html-with-assets.pdf");
Imports IronPdf

' Instantiate Renderer
Private renderer = New ChromePdfRenderer()

' Advanced Example with HTML Assets
' Load external html assets: Images, CSS and JavaScript.
' An optional BasePath 'C:\site\assets\' is set as the file location to load assets from
Private myAdvancedPdf = renderer.RenderHtmlAsPdf("<img src='icons/iron.png'>", "C:\site\assets\")
myAdvancedPdf.SaveAs("html-with-assets.pdf")
$vbLabelText   $csharpLabel

Karmaşık düzenler veya dinamik içerikler içeren gelişmiş senaryolar için, IronPDF'nin JavaScript işleme desteğini kullanın:

// Example with JavaScript-generated content
var jsHtml = @"
<html>
<head>
    <script>
        window.onload = function() {
            document.getElementById('dynamic').innerHTML = 
                'Generated on: ' + new Date().toLocaleString();
        };
    </script>
</head>
<body>
    <h1>Dynamic Content Example</h1>
    <div id='dynamic'></div>
</body>
</html>";

// Configure rendering to wait for JavaScript execution
renderer.RenderingOptions.WaitFor.RenderDelay(500); // milliseconds
using var dynamicPdf = renderer.RenderHtmlAsPdf(jsHtml, @"C:\site\");
dynamicPdf.SaveAs("dynamic-content.pdf");
// Example with JavaScript-generated content
var jsHtml = @"
<html>
<head>
    <script>
        window.onload = function() {
            document.getElementById('dynamic').innerHTML = 
                'Generated on: ' + new Date().toLocaleString();
        };
    </script>
</head>
<body>
    <h1>Dynamic Content Example</h1>
    <div id='dynamic'></div>
</body>
</html>";

// Configure rendering to wait for JavaScript execution
renderer.RenderingOptions.WaitFor.RenderDelay(500); // milliseconds
using var dynamicPdf = renderer.RenderHtmlAsPdf(jsHtml, @"C:\site\");
dynamicPdf.SaveAs("dynamic-content.pdf");
Imports System

' Example with JavaScript-generated content
Dim jsHtml As String = "
<html>
<head>
    <script>
        window.onload = function() {
            document.getElementById('dynamic').innerHTML = 
                'Generated on: ' + new Date().toLocaleString();
        };
    </script>
</head>
<body>
    <h1>Dynamic Content Example</h1>
    <div id='dynamic'></div>
</body>
</html>"

' Configure rendering to wait for JavaScript execution
renderer.RenderingOptions.WaitFor.RenderDelay(500) ' milliseconds
Using dynamicPdf = renderer.RenderHtmlAsPdf(jsHtml, "C:\site\")
    dynamicPdf.SaveAs("dynamic-content.pdf")
End Using
$vbLabelText   $csharpLabel

Harici varlıklarla çalışırken, kimlik doğrulama veya özel başlıkları ele almanız gerekebilir. IronPDF, kaynakları alırken yetkilendirme belirteçlerini veya özel başlıkları dahil etmenize olanak tanıyan HTTP İstek Başlığı işlevselliği yoluyla bunu destekler.

Dış Kaynaklar İçin BasePath Belirlemek Neden Önemlidir?

Bu, kodun ürettiği dosyadır:

BasePath'in doğru ayarlanması, HTML'nizdeki tüm relatif referansların doğru şekilde çözüldüğünü garanti eder. Bunlar olmadan, IronPDF dış kaynaklar gibi resimler, stil tabloları ya da script'leri bulamaz. Bu özellikle şu durumlarda önemlidir:

  1. Yerel dosya sistemi kaynaklarına başvuran HTML'leri dönüştürürken
  2. Göreli URL'ler kullanan içerik yönetim sistemleriyle çalışırken
  3. Mevcut web içeriğini PDF formatına dönüştürürken
  4. Paylaşılan varlıkları kullanan şablonlar oluştururken

Web tabanlı kaynaklar için temel yol olarak tam bir URL kullanın:

// Using a web URL as base path
var webBasedPdf = renderer.RenderHtmlAsPdf(
    "<link rel='stylesheet' href='/styles/main.css'><h1>Web Content</h1>", 
    "https://mywebsite.com"
);
// Using a web URL as base path
var webBasedPdf = renderer.RenderHtmlAsPdf(
    "<link rel='stylesheet' href='/styles/main.css'><h1>Web Content</h1>", 
    "https://mywebsite.com"
);
' Using a web URL as base path
Dim webBasedPdf = renderer.RenderHtmlAsPdf(
    "<link rel='stylesheet' href='/styles/main.css'><h1>Web Content</h1>", 
    "https://mywebsite.com"
)
$vbLabelText   $csharpLabel

PDF oluşturma süreci üzerinde ek kontroller sağlamak için, IronPDF'nin özel kenar boşlukları, sayfa yönlendirmesi ve PDF sıkıştırma hakkında geniş belgelerini keşfedin ve çeşitli kullanım durumları için çıktı dosyalarınızı optimize edin.

Sıkça Sorulan Sorular

Basit bir HTML dizgisini C# içinde PDF'e nasıl dönüştürürüm?

IronPDF'ün ChromePdfRenderer sınıfını ve RenderHtmlAsPdf metodunu kullanarak bir HTML dizgisini PDF'e dönüştürebilirsiniz. Yalnızca dönüştürücüyü oluşturun, HTML dizginizi metoda geçirin ve ortaya çıkan PdfDocument nesnesini kaydedin. IronPDF, mükemmel doğruluğu sağlamak için bir Chrome rapor motoru kullanır.

HTML'den PDF'e dönüştürme hangi rapor motorunu kullanır?

IronPDF, HTML'yi PDF'e işlemek için tam işlevsel bir Google Chromium motoru kullanır. Bu, HTML içeriğinizin, HTML5, CSS3 ve JavaScript dahil olmak üzere, modern bir web tarayıcısındaki gibi görünmesini sağlar.

CSS ile stil verilmiş HTML'yi PDF'e dönüştürebilir miyim?

Evet, IronPDF, CSS ile stil verilmiş HTML'yi PDF'e dönüştürmeyi destekler. HTML dizginizde doğrudan stil içinde stil uygulayabilir veya stil verilmiş içeriğin doğru şekilde işlenmesini sağlamak için Dış URL'ler ve Varlık Kodlaması özelliğini kullanarak dış stil dosyalarına referans verebilirsiniz.

HTML'yi PDF'e dönüştürmenin en hızlı yolu nedir?

En hızlı yol, IronPDF'ün statik metodu olan: IronPdf.ChromePdfRenderer.StaticRenderHtmlAsPdf("Your HTML").SaveAs("output.pdf"). Bu tek satırda kod, HTML dizginizi dönüştürür ve PDF dosyası olarak kaydeder.

HTML dizgilerini dönüştürürken dış varlıkları nasıl yönetirim?

IronPDF, PDF'nizdeki dış varlıklar için BasePath'i yapılandırmanıza olanak tanır. Bu, HTML'nizde referans verilen görüntülerin, stil dosyalarının ve diğer kaynakların dönüşüm süreci sırasında düzgün bir şekilde yüklenmesini sağlar.

HTML'den PDF'e dönüştürürken PDF çıktısını özelleştirebilir miyim?

Evet, IronPDF geniş kapsamlı RenderingOptions sağlar, böylece PDF çıktınızı hassas bir şekilde ayarlayabilirsiniz. Sayfa boyutunu, kenar boşluklarını, başlıkları, alt bilgileri ve oluşturulan PDF'nin birçok diğer yönünü ChromePdfRenderer sınıfı aracılığıyla kontrol edebilirsiniz.

Dönüştürme sonrası oluşturulan PDF ile ne yapabilirim?

IronPDF'ün PdfDocument nesnesi, PDF düzenlemeleri için birçok yöntem sunar, bunlar arasında PDF'leri birleştirme, filigran ekleme, güvenlik seçenekleri belirleme ve daha fazlası bulunur. Dönüştürülen PDF, diske kaydedilebilir, akışa alınabilir veya gerektiği şekilde daha fazla işlenebilir.

Dış kaynaklardan HTML'yi dönüştürürken güvenliği nasıl sağlarım?

Dış kaynaklardan HTML'yi dönüştürürken, IronPDF ile ChromePdfRenderer üzerinde EnableWebSecurity özelliğini true olarak ayarlayabilirsiniz. Bu, yerel disk erişimini ve çapraz kaynak isteklerini devre dışı bırakarak güvenlik artırılır.

Curtis Chau
Curtis Chau
  Mühendislik takımıyla şimdi sohbet edin
Teknik Yazar

Curtis Chau, Bilgisayar Bilimleri alanında lisans derecesine sahiptir (Carleton Üniversitesi) ve Node.js, TypeScript, JavaScript ve React konularında uzmanlaşmış ön uç geliştirme üzerine uzmanlaşmıştır. Kullanıcı dostu ve estetik açıdan hoş arayüzler tasarlamaya tutkuyla bağlı olan Curtis, modern çerç...

Daha Fazlasını Oku
Başlamaya Hazır mısınız?
Nuget Indirmeler 18,332,619 | Sürüm: 2026.4 yeni yayınlandı
Still Scrolling Icon

Hala Kaydiriyor musunuz?

Hızlı bir kanit mi istiyorsunuz? PM > Install-Package IronPdf
bir örnek çalıştır HTML'nizin PDF olduğunu izleyin.