IronPDF, C# geliştiricilerinin profesyonel PDF belgeleri olarak HTML'i 5 kolay adımda dönüştürmesine olanak tanır, sadece NuGet paketinin yüklenmesi ve HTML'yi PDF belge olarak işlemek için birkaç satır kod gerektirir.
C# geliştiricileri IronPDF'i kullanarak HTML'den PDF oluşturabilir. Bu makale, .NET Framework kullanılarak C# Windows Forms uygulaması ile bu süreci gösterecek.
Visual Studio 2019'da bir proje oluşturmak için lütfen bu adımları izleyin.
İlk olarak, Visual Studio 2019'u açın.
'Yeni bir proje oluştur'a tıklayın.
Şimdi, 'Windows Forms Uygulaması'nı Şablondan seçin ve 'İleri'ye basın. Aşağıdaki pencere görünür:
Proje Adı olarak 'IronPDF Kullanarak PDF oluştur' girin.
'Oluştur' düğmesine tıklayın. Proje aşağıda gösterildiği gibi oluşturulacaktır.
Windows Forms, C#'da PDF oluşturmayı öğrenen yeni başlayanlar için basit bir görsel ortam sağlar. Geniş HTML veya web geliştirme bilgisi olmadan kullanıcı arayüzleri oluşturmayı kolaylaştıran bir sürükle ve bırak tasarımcısı sunar. Windows Forms'taki olay odaklı programlama modeli, junior geliştiricilerin uygulama akışını düşünme biçimiyle iyi hizalanır ve IronPDF'in temel HTML'den PDF özelliklerini gösterirken idealdir.
Üretim uygulamaları için web tabanlı PDF oluşturma için ASP.NET Core'u veya toplu işleme için konsol uygulamalarını düşünebilirsiniz. Ancak, Windows Forms, geliştirme sırasında hızlı görsel geri bildirim gereken dahili araçlar, masaüstü yardımcı programları ve öğrenme ortamları için mükemmel bir seçim olmaya devam eder.
IronPDF geliştirme için Visual Studio 2019 veya daha yeni bir sürümü en iyi deneyimi sunar. Bu sürümler, geliştirilmiş NuGet paket yönetimi, modern C# özellikleri için daha iyi IntelliSense desteği ve PDF üretim sorunlarıyla uğraşırken yardımcı olan geliştirilmiş hata ayıklama yeteneklerini içerir.
Visual Studio 2022, en son özellikleri ve performans iyileştirmelerini sunarken, Visual Studio 2019 hala geniş ölçüde kullanılır ve tam olarak desteklenir. Her iki sürüm de IronPDF'in NuGet paketleri ile sorunsuz çalışır. Visual Studio Code kullanan geliştiriciler için IronPDF ile yine de çalışabilirsiniz, ancak paket yönetimi için komut satırı arayüzünü kullanmanız gerekecek ve bu öğreticide gösterilen bazı görsel tasarım özelliklerini kaçıracaksınız.
Tamamen mümkün! IronPDF .NET Core, .NET 5, .NET 6 ve .NET 7+'yi tam olarak destekler. Aslında, .NET Core veya daha yeni sürümleri kullanmak, platformlar arası uyumluluk, daha iyi performans ve en son C# dili özelliklerine erişim gibi birçok avantaj sunar.
.NET Core'u kullanmak için, projenizi oluştururken uygun hedef çerçeveyi seçin. Bu öğretideki kod örnekleri, desteklenen tüm çerçeveler arasında aynı şekilde çalışır. Dağıtım esnekliği için, .NET Core uygulamaları, Windows'a ek olarak Linux ve macOS üzerinde çalışabilir, bulut dağıtımları ve konteynerleştirilmiş ortamlar için ideal hale getirir.
Komut satırı altında yeni bir ekran açılacaktır. Bunun içinde, IronPDF paketini yüklemek için komutu yazın.
Komutu yazdıktan sonra Enter tuşuna basın. Bilgisayarınızın/internet bağlantınızın olduğundan emin olun. IronPDF paketi, mevcut projenize otomatik olarak eklenecektir.
Yukarıdaki ekran, paketin projenize başarıyla eklendiğini gösteriyor.
Paket Yöneticisi Konsolu dışında, IronPDF kurma için birkaç seçeneğiniz var:
NuGet Paket Yöneticisi UI: Projeye sağ tıklayın, "NuGet Paketlerini Yönet" seçeneğini seçin, "IronPDF" arayın ve Yükle'ye tıklayın. GUI arayüzlerini tercih eden yeni başlayanlar için harika.
PackageReference, .csproj dosyasında: Modern .NET projeleri için IronPDF'yi doğrudan proje dosyanıza ekleyebilirsiniz:
<PackageReference Include="IronPdf" Version="*" />NuGet, IronPDF'i ve bağımlılıklarını NuGet.org deposundan indirmek için internet bağlantısına ihtiyaç duyar. Paket, HTML'den PDF'ye dönüştürme için gereken Chrome rendering motoru ikili dosyalarını da içeren temel IronPDF kütüphanesini içerir.
Çevrimdışı yüklemeler için şunları yapabilirsiniz:
IronPDF'in rendering motoru ek runtime bileşenleri gerektirir ve bu bileşenler ilk kullanımda indirilebilir, bu nedenle ilk PDF oluşturma internet bağlantısından da faydalanır.
Kurulumdan sonra IronPDF'in doğru çalıştığını şu göstergeler ile doğrulayabilirsiniz:
Referanslar Düğümü: Solution Explorer'da Referanslar düğümünü genişletin. Proje referanslarınız arasında "IronPDF" ifadesini görmelisiniz.
IntelliSense Desteği: Bir C# dosyasının üst kısmına using IronPdf; yazın. IntelliSense, hata olmadan ad alanını tanımalıdır.
Basit Test Kodu: İşlevselliği doğrulamak için şu temel testi ekleyin:
using IronPdf;
// Quick verification test
var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf("<h1>Test</h1>");
// If no exceptions occur, IronPDF is installed correctlyImports IronPdf
' Quick verification test
Dim renderer As New ChromePdfRenderer()
Dim pdf = renderer.RenderHtmlAsPdf("<h1>Test</h1>")
' If no exceptions occur, IronPDF is installed correctlyGet-Package IronPdf çalıştırın.Sorunlarla karşılaşırsanız, hata ayıklama kılavuzuna veya sisteminizin gereksinimleri karşıladığını kontrol edin.
Şimdi bir etiket ekleyin ve metni "IronPDF kullanarak HTML'den PDF oluşturun" olarak ayarlayın.
Sonra, Araç Kutusundan bir Zengin Metin Kutusu ve Düğme ekleyin. Düğme Metnini 'Dönüştür' olarak ayarlayın.
TextBox yerine bir RichTextBox Kullanmalı?Bir RichTextBox, PDF üretim senaryolarında HTML girişi için birkaç avantaj sunar:
Çok satırlı Destek: HTML tipik olarak birçok satıra yayılır ve RichTextBox bunu doğal olarak işlerken, TextBox Çok Satırlı = true ayarlanmasını gerektirir.
Biçim Koruma: Düz HTML girerken, RichTextBox girinti ve satır sonları gibi biçimlendirmeyi korur, bu da geliştirme sırasında HTML'yi daha okunabilir hale getirir.
Daha Büyük Kapasite: RichTextBox, parça yerine tam HTML belgeleriyle çalışırken faydalı olan daha büyük metin miktarını yönetebilir.
Sözdizimi Vurgulama Potansiyeli: Bu temel örnekte uygulanmasa da, RichTextBox HTML için sözdizimi vurgulama sağlayarak geliştirici deneyimini artırılabilir.
Üretim uygulamaları için daha iyi bir kullanıcı deneyimi sağlamak üzere özel bir HTML editör denetimi kullanmayı veya harici düzenleyicilerle entegre olmayı düşünebilirsiniz.
Daha sağlam bir PDF oluşturma uygulaması oluşturmak için şu kontrolleri eklemeyi düşünebilirsiniz:
WebBrowser Kontrol: Kullanıcılara PDF'lerinin nasıl görüneceğini göstermek için dönüştürmeden önceki HTML önizlemesini görüntüleyin. Bu, IronPDF'in Chrome render motorunu taklit eder.
ProgressBar: Büyük belgeler veya toplu işlemler için dönüşüm ilerlemesini gösterin.
ComboBox için Şablonlar: Faturalar veya raporlar gibi yaygın belge türleri için önceden tanımlanmış HTML şablonları sağlayın.
PropertyGrid: Sayfa boyutu, kenar boşlukları ve yönlendirme gibi PDF render ayarlarını değiştirmelerine izin verin.
TabControl: Giriş HTML, önizleme ve PDF ayarlarını düzenli sekmelere ayırın.
Geri bildirim için bir durum şeridi ekleme örneği:
// Add to your form
StatusStrip statusStrip = new StatusStrip();
ToolStripStatusLabel statusLabel = new ToolStripStatusLabel("Ready");
statusStrip.Items.Add(statusLabel);
this.Controls.Add(statusStrip);' Add to your form
Dim statusStrip As New StatusStrip()
Dim statusLabel As New ToolStripStatusLabel("Ready")
statusStrip.Items.Add(statusLabel)
Me.Controls.Add(statusStrip)Tutarlı adlandırma kurallarını takip etmek, kod okunabilirliğini ve bakımını iyileştirir. PDF oluşturma formunuz için önerilen uygulamalar şunlardır:
Açıklayıcı Ön Ekler Kullanın:
txtHtml RichTextBoxbtnConvertlblTitleTutarlı Olun: Projeniz boyunca camelCase veya PascalCase seçin ve bunu uygulayın.
Varsayılan İsimlerden Kaçının: richTextBox1 'yi rtbHtmlInput gibi anlamlı isimlerle değiştirin.
İlgili Kontrolleri Gruplayın: Karmaşık formlar için işlevselliği gruplandıran önekler kullanın:
pdfPageSize, pdfOrientationhtmlTemplate, htmlPreviewErişilebilirliği Düşünün: Ekran okuyucular için Name özelliğini ve daha iyi kullanılabilirlik için AccessibleName ayarlayın.
İyi adlandırma, kodunuzu kendi kendini belgeleyen hale getirir ve form veri çıkarımı gibi özellikler uygularken işe yarar.
'Dönüştür' düğmesine çift tıklayın. Bir dönüştürme düğmesi tıklama olayı içeren bir kod penceresi açılacak.
.cs dosyasının üst kısmına IronPDF kütüphanesini dahil etmek için kod ekleyin.
İlk olarak, IronPDF Kütüphanesi yöntemlerini kullanmak için aşağıdaki kodu ekleyin.
using IronPdf;Imports IronPdfAşağıda, şu anda boş olan btnConvert_Click olayının başlangıç kodu yer almaktadır:
private void btnConvert_Click(object sender, EventArgs e)
{
}Private Sub btnConvert_Click(ByVal sender As Object, ByVal e As EventArgs)
End SubŞimdi düğme tıklama olayında aşağıdaki kodu yazın:
private void btnConvert_Click(object sender, EventArgs e)
{
// Declare an HtmlToPdf object
var HtmlLine = new HtmlToPdf();
// Get HTML text from the user
string strHtml = txtHtml.Text;
// Create SaveFileDialog to choose the save path for the PDF file
SaveFileDialog saveFileDialog = new SaveFileDialog
{
InitialDirectory = @"D:\",
Title = "Save PDF",
CheckPathExists = true,
DefaultExt = "pdf",
Filter = "pdf files (*.pdf)|*.pdf",
FilterIndex = 2,
RestoreDirectory = true
};
// If the user presses Save
if (saveFileDialog.ShowDialog() == DialogResult.OK)
{
// Get the file path from the user
string filePath = saveFileDialog.FileName;
// Convert HTML to PDF and save at the specified path
using var PDF = HtmlLine.RenderHtmlAsPdf(strHtml);
PDF.SaveAs(filePath);
// Clear the TextBox and show a message confirming the successful creation
txtHtml.Text = "";
MessageBox.Show("File created successfully.");
}
}Private Sub btnConvert_Click(sender As Object, e As EventArgs) Handles btnConvert.Click
' Declare an HtmlToPdf object
Dim HtmlLine = New HtmlToPdf()
' Get HTML text from the user
Dim strHtml As String = txtHtml.Text
' Create SaveFileDialog to choose the save path for the PDF file
Dim saveFileDialog As New SaveFileDialog() With {
.InitialDirectory = "D:\",
.Title = "Save PDF",
.CheckPathExists = True,
.DefaultExt = "pdf",
.Filter = "pdf files (*.pdf)|*.pdf",
.FilterIndex = 2,
.RestoreDirectory = True
}
' If the user presses Save
If saveFileDialog.ShowDialog() = DialogResult.OK Then
' Get the file path from the user
Dim filePath As String = saveFileDialog.FileName
' Convert HTML to PDF and save at the specified path
Using PDF = HtmlLine.RenderHtmlAsPdf(strHtml)
PDF.SaveAs(filePath)
End Using
' Clear the TextBox and show a message confirming the successful creation
txtHtml.Text = ""
MessageBox.Show("File created successfully.")
End If
End SubAçıklama:
HtmlToPdf nesnesi oluşturulur.SaveFileDialog kullanılır.RenderHtmlAsPdf kullanılarak ardından PDF'ye dönüştürülür ve seçili yola kaydedilir.Üretim PDF oluşturma uygulamaları için güçlü hata yönetimi çok önemlidir. Kapsamlı hata yönetimi ile geliştirilmiş bir sürüm:
private void btnConvert_Click(object sender, EventArgs e)
{
try
{
// Validate input
if (string.IsNullOrWhiteSpace(txtHtml.Text))
{
MessageBox.Show("Please enter HTML content.", "Validation Error",
MessageBoxButtons.OK, MessageBoxIcon.Warning);
return;
}
var renderer = new ChromePdfRenderer();
string strHtml = txtHtml.Text;
SaveFileDialog saveFileDialog = new SaveFileDialog
{
InitialDirectory = Environment.GetFolderPath(Environment.SpecialFolder.MyDocuments),
Title = "Save PDF",
CheckPathExists = true,
DefaultExt = "pdf",
Filter = "pdf files (*.pdf)|*.pdf",
FilterIndex = 1,
RestoreDirectory = true
};
if (saveFileDialog.ShowDialog() == DialogResult.OK)
{
try
{
// Show progress cursor
Cursor.Current = Cursors.WaitCursor;
using var pdf = renderer.RenderHtmlAsPdf(strHtml);
pdf.SaveAs(saveFileDialog.FileName);
txtHtml.Text = "";
MessageBox.Show("PDF created successfully!", "Success",
MessageBoxButtons.OK, MessageBoxIcon.Information);
}
catch (IronPdf.Exceptions.IronPdfProductException ex)
{
// Handle licensing issues
MessageBox.Show($"Licensing error: {ex.Message}", "License Error",
MessageBoxButtons.OK, MessageBoxIcon.Error);
}
finally
{
Cursor.Current = Cursors.Default;
}
}
}
catch (Exception ex)
{
MessageBox.Show($"An error occurred: {ex.Message}", "Error",
MessageBoxButtons.OK, MessageBoxIcon.Error);
// Log the full exception for debugging
System.Diagnostics.Debug.WriteLine(ex.ToString());
}
}Private Sub btnConvert_Click(sender As Object, e As EventArgs) Handles btnConvert.Click
Try
' Validate input
If String.IsNullOrWhiteSpace(txtHtml.Text) Then
MessageBox.Show("Please enter HTML content.", "Validation Error", MessageBoxButtons.OK, MessageBoxIcon.Warning)
Return
End If
Dim renderer As New ChromePdfRenderer()
Dim strHtml As String = txtHtml.Text
Dim saveFileDialog As New SaveFileDialog With {
.InitialDirectory = Environment.GetFolderPath(Environment.SpecialFolder.MyDocuments),
.Title = "Save PDF",
.CheckPathExists = True,
.DefaultExt = "pdf",
.Filter = "pdf files (*.pdf)|*.pdf",
.FilterIndex = 1,
.RestoreDirectory = True
}
If saveFileDialog.ShowDialog() = DialogResult.OK Then
Try
' Show progress cursor
Cursor.Current = Cursors.WaitCursor
Using pdf = renderer.RenderHtmlAsPdf(strHtml)
pdf.SaveAs(saveFileDialog.FileName)
End Using
txtHtml.Text = ""
MessageBox.Show("PDF created successfully!", "Success", MessageBoxButtons.OK, MessageBoxIcon.Information)
Catch ex As IronPdf.Exceptions.IronPdfProductException
' Handle licensing issues
MessageBox.Show($"Licensing error: {ex.Message}", "License Error", MessageBoxButtons.OK, MessageBoxIcon.Error)
Finally
Cursor.Current = Cursors.Default
End Try
End If
Catch ex As Exception
MessageBox.Show($"An error occurred: {ex.Message}", "Error", MessageBoxButtons.OK, MessageBoxIcon.Error)
' Log the full exception for debugging
System.Diagnostics.Debug.WriteLine(ex.ToString())
End Try
End SubAna hata yönetimi iyileştirmeleri:
IronPDF, ChromePdfRenderOptions sınıfı aracılığıyla geniş özelleştirme imkanı sağlar. Yaygın özelleştirmeleri uygulamanın yolu burada:
private void ConvertWithCustomSettings()
{
var renderer = new ChromePdfRenderer();
// Configure rendering options
renderer.RenderingOptions = new ChromePdfRenderOptions
{
// Page setup
PaperSize = PdfPaperSize.A4,
PaperOrientation = PdfPaperOrientation.Portrait,
MarginTop = 25, // millimeters
MarginBottom = 25,
MarginLeft = 20,
MarginRight = 20,
// Rendering behavior
EnableJavaScript = true,
RenderDelay = 500, // milliseconds
CreatePdfFormsFromHtml = true,
// Headers and footers
TextHeader = new TextHeaderFooter
{
CenterText = "My Document",
FontSize = 12,
DrawDividerLine = true
},
TextFooter = new TextHeaderFooter
{
RightText = "Page {page} of {total-pages}",
FontSize = 10
}
};
// Apply custom CSS for print
renderer.RenderingOptions.CssMediaType = PdfCssMediaType.Print;
// Generate PDF with custom settings
var pdf = renderer.RenderHtmlAsPdf(txtHtml.Text);
pdf.SaveAs("custom-output.pdf");
}Private Sub ConvertWithCustomSettings()
Dim renderer As New ChromePdfRenderer()
' Configure rendering options
renderer.RenderingOptions = New ChromePdfRenderOptions With {
' Page setup
.PaperSize = PdfPaperSize.A4,
.PaperOrientation = PdfPaperOrientation.Portrait,
.MarginTop = 25, ' millimeters
.MarginBottom = 25,
.MarginLeft = 20,
.MarginRight = 20,
' Rendering behavior
.EnableJavaScript = True,
.RenderDelay = 500, ' milliseconds
.CreatePdfFormsFromHtml = True,
' Headers and footers
.TextHeader = New TextHeaderFooter With {
.CenterText = "My Document",
.FontSize = 12,
.DrawDividerLine = True
},
.TextFooter = New TextHeaderFooter With {
.RightText = "Page {page} of {total-pages}",
.FontSize = 10
}
}
' Apply custom CSS for print
renderer.RenderingOptions.CssMediaType = PdfCssMediaType.Print
' Generate PDF with custom settings
Dim pdf = renderer.RenderHtmlAsPdf(txtHtml.Text)
pdf.SaveAs("custom-output.pdf")
End SubDaha ileri düzey özelleştirme seçenekleri için özel kağıt boyutları, özel kenar boşlukları ve görünüm ayarlarını keşfedin.
using beyannamesi, PDF üretiminde uygun kaynak yönetimi için esastır:
Otomatik Bertaraf: PDF belgeleri, özellikle resimler veya büyük içeriklerle önemli miktarda bellek tüketebilir. using beyannamesi, PDF nesnesinin kullanım sonrasında düzgün şekilde elden çıkarıldığını garanti eder.
Dosya Tutucu Serbest Bırakma: Uygun bertaraf yapılmazsa, dosya tutucuları kilitli kalabilir ve PDF dosyasında sonraki işlemleri engelleyebilir.
Bellek Yönetimi: IronPDF'in rendering motoru, uzun süre çalışan uygulamalarda bellek sızıntılarını önlemek için serbest bırakılması gereken yerel kaynaklar kullanır.
İşte model karşılaştırması:
// Recommended approach with using
using (var pdf = renderer.RenderHtmlAsPdf(html))
{
pdf.SaveAs("output.pdf");
} // Resources automatically released here
// Alternative with try-finally (more verbose)
PdfDocument pdf = null;
try
{
pdf = renderer.RenderHtmlAsPdf(html);
pdf.SaveAs("output.pdf");
}
finally
{
pdf?.Dispose();
}' Recommended approach with Using
Using pdf = renderer.RenderHtmlAsPdf(html)
pdf.SaveAs("output.pdf")
End Using ' Resources automatically released here
' Alternative with Try-Finally (more verbose)
Dim pdf As PdfDocument = Nothing
Try
pdf = renderer.RenderHtmlAsPdf(html)
pdf.SaveAs("output.pdf")
Finally
If pdf IsNot Nothing Then
pdf.Dispose()
End If
End TryAsync işlemler için, C# 8.0+ 'da await using kullanın:
await using var pdf = await renderer.RenderHtmlAsPdfAsync(html);Await Using pdf = Await renderer.RenderHtmlAsPdfAsync(html)IronPDF'in Chrome rendering motoru tüm modern HTML5 etiketlerini destekler, ancak bazıları PDF oluşturma için özellikle iyi çalışır:
Doküman Yapısı:
<html>
<head>
<meta charset="UTF-8">
<style>
@media print { /* PDF-specific styles */ }
body { font-family: Arial, sans-serif; }
.page-break { page-break-after: always; }
</style>
</head>
<body>
<h1>Document Title</h1>
<div class="page-break"></div>
<h2>New Page Content</h2>
</body>
</html>PDF'ler için en iyi performans gösteren etiketler:
<h1> ile <h6>: Açık belge hiyerarşisi oluşturur<table>: Yapılandırılmış veriler ve faturalar için mükemmeldir<img>: Gömülü görüntüler ve base64 verilerini destekler<div>: Hassas düzen kontrolü<p> ve <span>: Standart metin formatlama<ul> ve <ol>: Temiz liste formatlamaÖzel hususlar:
Projeyi çalıştırdığınızda aşağıdaki ekranı göreceksiniz:
RichTextBox içine HTML kodunu girin, örneğin:
<h1>A Simple PDF File</h1><br><h6>Heading 6</h6>'Dönüştür' üzerine tıklayın. Bir dosya kaydetme iletişim kutusu alacaksınız.
Kaydet düğmesine tıkladığınızda, dosya belirttiğiniz yolda, tanımlı ad ve konumla kaydedilecektir.
IronPDF'in rendering yeteneklerini anlamak için bu giderek daha karmaşık HTML örnekleriyle başlayın:
Temel Metin Biçimlendirme:
<!DOCTYPE html>
<html>
<head>
<style>
body { font-family: Arial, sans-serif; margin: 40px; }
.highlight { background-color: yellow; }
.important { color: red; font-weight: bold; }
</style>
</head>
<body>
<h1>Test Document</h1>
<p>This is <strong>bold</strong> and <em>italic</em> text.</p>
<p class="highlight">Highlighted text example.</p>
<p class="important">Important notice!</p>
</body>
</html>Stil ile Tablo:
<table style="border-collapse: collapse; width: 100%;">
<tr style="background-color: #f2f2f2;">
<th style="border: 1px solid #ddd; padding: 8px;">Product</th>
<th style="border: 1px solid #ddd; padding: 8px;">Price</th>
</tr>
<tr>
<td style="border: 1px solid #ddd; padding: 8px;">IronPDF</td>
<td style="border: 1px solid #ddd; padding: 8px;">$999</td>
</tr>
</table>İleri Düzey Özellikler:
<!-- Images -->
<img src="___PROTECTED_URL_118___" width="200" alt="Company Logo">
<!-- Page breaks -->
<div style="page-break-after: always;"></div>
<!-- Lists -->
<ul>
<li>First item</li>
<li>Second item</li>
</ul>HTML'den PDF'ye dönüştürme çalışmasının beklendiği gibi olduğundan emin olmak için bu elemanları test edin.
PDF oluşturma başarısız olduğunda, bu sistematik hata ayıklama yaklaşımını izleyin:
IronPdf.Logging.Logger.EnableDebugging = true;
IronPdf.Logging.Logger.LogFilePath = "IronPdfLog.txt";
IronPdf.Logging.Logger.LoggingMode = IronPdf.Logging.Logger.LoggingModes.All;IronPdf.Logging.Logger.EnableDebugging = True
IronPdf.Logging.Logger.LogFilePath = "IronPdfLog.txt"
IronPdf.Logging.Logger.LoggingMode = IronPdf.Logging.Logger.LoggingModes.All// Validate HTML before conversion
private bool IsValidHtml(string html)
{
try
{
var doc = new HtmlAgilityPack.HtmlDocument();
doc.LoadHtml(html);
return doc.ParseErrors.Count() == 0;
}
catch
{
return false;
}
}' Validate HTML before conversion
Private Function IsValidHtml(html As String) As Boolean
Try
Dim doc As New HtmlAgilityPack.HtmlDocument()
doc.LoadHtml(html)
Return doc.ParseErrors.Count() = 0
Catch
Return False
End Try
End FunctionDevTools kullanın:// Start with the simplest possible HTML
var testHtml = "<h1>Test</h1>";
var pdf = new ChromePdfRenderer().RenderHtmlAsPdf(testHtml);
pdf.SaveAs("test.pdf");' Start with the simplest possible HTML
Dim testHtml = "<h1>Test</h1>"
Dim pdf = New ChromePdfRenderer().RenderHtmlAsPdf(testHtml)
pdf.SaveAs("test.pdf")İşte küçük geliştiricilerin en sık karşılaştığı sorunlar ve çözümleri:
"IronPdf.Exceptions.IronPdfDeploymentException"
"Access Denied" Hataları
Environment.SpecialFolder kullanınBüyük Dosya Boyutları
pdf.CompressImages(90); // 90% qualitypdf.CompressImages(90) ' 90% qualityYavaş Performans
Eksik İçerik
Kalıcı sorunlar için, kapsamlı hata ayıklama kılavuzuna bakın.
Çıkış PDF belgesi bu şekilde görünecek:
Bu profesyonel tekniklerle PDF çıktı kalitenizi artırın:
renderer.RenderingOptions.PrintHtmlBackgrounds = true;
renderer.RenderingOptions.ImageQuality = 95; // Higher quality for images
renderer.RenderingOptions.DPI = 300; // Print-quality resolutionrenderer.RenderingOptions.PrintHtmlBackgrounds = True
renderer.RenderingOptions.ImageQuality = 95 ' Higher quality for images
renderer.RenderingOptions.DPI = 300 ' Print-quality resolution<style>
@page {
size: A4;
margin: 2cm;
}
body {
font-family: 'Segoe UI', Tahoma, sans-serif;
line-height: 1.6;
color: #333;
}
h1 {
color: #2c3e50;
border-bottom: 2px solid #3498db;
padding-bottom: 10px;
}
</style>HTML önizlemesi ile PDF çıktısı arasında render farklılıkları yaşanabilecek birkaç faktör vardır:
@media print {
.no-print { display: none; }
body { font-size: 12pt; }
}@font-face {
font-family: 'MyFont';
src: url('data:font/woff2;base64,...') format('woff2');
}renderer.RenderingOptions.RenderDelay = 2000; // Wait 2 secondsrenderer.RenderingOptions.RenderDelay = 2000 ' Wait 2 secondsTarayıcı Farkları: IronPDF Chromium kullanır, bu yüzden doğru önizleme için Chrome'da test edin. Chrome render motoru hakkında bilgi edinin.
Çözünürlük ve Ölçekleme: Monitör DPI, yazdırma DPI'sından farklıdır. Tutarlı render için görünüm ayarlarını kullanın.
Piksel kusursuz render için HTML'den PDF'ye en iyi uygulama kılavuzunu takip edin.
Yukarıdaki öğretici, IronPDF Kütüphanesini kullanarak HTML'den bir PDF oluşturmayı açıklar.
Daha fazla bilgi için IronPDF Resmi Sitesini ziyaret edin. Kütüphane ayrıca, tamamen özelleştirilebilir PDF dosyaları oluşturma, dosyaları programlı olarak birleştirme ve ayırma veya çeşitli özellikleri gösteren örnek kodlar sağlama gibi diğer işlevleri de sunar.
30 günlük deneme anahtarı ile deneyebilirsiniz. Şu anda mükemmel bir teklif mevcut, sadece iki fiyatına beş Iron Software ürününü alabilirsiniz. Lisanslama hakkında daha fazla bilgi için şu IronPDF Lisanslama Bilgilerini ziyaret edin.
Temel HTML'den PDF'e dönüşümü öğrendikten sonra bu gelişmiş yeteneklere göz atın:
// Create interactive form fields
pdf.Form.Fields.Add(new PdfTextField("name", "Enter your name", 100, 100));' Create interactive form fields
pdf.Form.Fields.Add(New PdfTextField("name", "Enter your name", 100, 100))Dijital İmzalar: Belgelere güvenlik ve doğruluk ekleyin
Proje gereksinimlerinize en uygun özelliklerle başlayın.
Denemeden üretime geçiş, birkaç önemli adımı içerir:
Doğru Lisansı Seçin:
Lisans Anahtarınızı Uygulayın:
// In application startup
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";
// Or via configuration
// appsettings.json (for .NET Core)
{
"IronPdf.License.LicenseKey": "YOUR-LICENSE-KEY"
}' In application startup
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY"
' Or via configuration
' appsettings.json (for .NET Core)
' {
' "IronPdf.License.LicenseKey": "YOUR-LICENSE-KEY"
' }Deneme Filigranlarını Kaldırın: Lisanslı sürümler, oluşturulan tüm PDF'lerden deneme filigranlarını otomatik olarak kaldırır.
Performans Dikkatleri:
Uygulama Kontrol Listesi:
Detaylı lisanslama kılavuzu için, lisanslama SSS'ye bakın.
IronPDF bilginizi bu kapsamlı kaynaklarla genişletin:
Topluluk Kaynakları:
Kullanım senaryonuza en yakın örneklerle başlayın ve gerektiğinde daha gelişmiş özellikleri 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ı.
