ActivePDF, .NET geliştiricileri için güvenilir bir PDF aracıdır. PDFTron'un Haziran 2020'de satın alması ve Şubat 2023'te Apryse olarak yeniden markalanmasıyla birlikte,ActivePDFşimdi daha geniş Apryse portföyünde birkaç markadan biri olarak yer alıyor. Bu rehber, ActivePDF'den IronPDF'ye geçiş için detaylı, adım adım bir yol sunar—.NET Framework 4.6.2'den .NET 9'a kadar destekleyen modern, aktif bir .NET PDF kütüphanesi.
ActivePDF hâlâ gönderilip kullanılmakta ve ActivePDF.Toolkit NuGet paketi Apryse altında güncellemeler almaktadır, ancak tasarım ve paketlemesinin çeşitli yönleri, ekipleri alternatifleri değerlendirmeye sevk edebilir.
ActivePDF artık Apryse içinde tek bir markadır, Apryse SDK da dahil. ActivePDF'yi özel olarak sunucu tarafı otomasyon odaklı seçen takımlar,ActivePDFSKU'larında kalmayı veya zaman içinde daha geniş Apryse SDK'ya geçmeyi değerlendirmek isteyebilir.
ActivePDF'nin geleneksel sunucu başına/çekirdek başına lisanslaması, uygulamalar bulut ve kapsayıcılı ortamlar üzerinde altyapı çapında dinamik olarak ölçeklenirken sürtüşme yaratabilir.
ActivePDF'nin API yüzeyi, COM/yerel kökenlerini yansıtır. CloseOutputFile iş akışı ve tam sayı dönüş kodları (başarı için 0), modern C# idiomlarıyla, using, istisnalar ve async gibi her zaman uyuşmayan belirgin yaşam döngüsü yönetimi gerektirir.
HTML/URL'den PDF'ye oluşturma ayrı ActivePDF.WebGrabber ürününde yer alırken, PDF manipülasyonu ActivePDF.Toolkit içindedir. Toolkit 10 ile başlayarak, yerel kitaplıklar artık sistem klasörüne otomatik kopyalanmadığından, kurucu genellikle açık bir CoreLibPath argümanına ihtiyaç duyar—Docker, CI ve kurulum gerektirmeyen dağıtımları zorlaştıran bir modeldir.
##ActivePDFve IronPDF: Ana Farklılıklar
Geçiş sürecine başlamadan önce,ActivePDFve IronPDF arasındaki temel farkları anlamak, gereken kod değişiklikleri için beklentileri ayarlamaya yardımcı olur.
| Aspekt | ActivePDF | IronPDF |
|---|---|---|
| Satıcı | Apryse (eski adıyla PDFTron,ActivePDFHaziran 2020'de satın aldı) | Iron Software, bağımsız |
| Ürün Yerleşimi | Multiple SKUs (Toolkit, WebGrabber, DocConverter, Server, Meridian) | Single IronPdf NuGet package |
| Kurulum | NuGet paketi + yerel çalışma zamanı yolu (CoreLibPath v10'dan itibaren) | Tek bir NuGet paketi; natives bundled |
| API Modeli | Durum bilgili (CloseOutputFile), COM türevli | Akıcı, fonksiyonel API |
| Lisans Modeli | Sunucu başına / çekirdek başına | Kod tabanlı anahtar |
| .NET Desteği | .NET Framework 4.5+ / .NET Standard 1.0+ / .NET Core | Framework 4.6.2'den .NET 9'a kadar |
| Hata Yönetimi | Tam sayı dönüş kodları (0 = başarı) | Standart .NET istisnaları |
| Asenkron Destek | Yerel değil | Tam async/await desteği |
Geçişe başlamadan önce, çözümünüzdeki tümActivePDFkullanımını belirleyin. Gerçek isim alanları APToolkitNET (Toolkit) ve APWebGrabber (WebGrabber); bazı eski projeler ayrıca COM uyumlu montaj aracılığıyla ActivePDF.Toolkit'a referans verir. Çözüm dizininizde bu komutları çalıştırın:
grep -r "using APToolkitNET" --include="*.cs" .
grep -r "using APWebGrabber" --include="*.cs" .
grep -r "ActivePDF" --include="*.csproj" .Temel API farklarını anlamak, geçiş stratejinizi planlamanızı sağlar:
| Kategori | ActivePDF Davranışı | IronPDF Davranışı | Geçiş Eylemi |
|---|---|---|---|
| Ürün Ayrımı | Toolkit (manipülasyon) + WebGrabber (HTML dönüştürme) ayrı satılır | Tek IronPdf paketi | Her ikisini tek kütüphanede toplamak |
| Nesne Modeli | PDF'ler için APToolkitNET.Toolkit, HTML için APWebGrabber.WebGrabber | ChromePdfRenderer + PdfDocument | Endişeleri ayırmak |
| Dosya İşlemleri | CloseOutputFile() | Doğrudan SaveAs() | Açma/kapama çağrılarını kaldır |
| Yerel Çalışma Zamanı | v10'dan beri CoreLibPath argümanı | NuGet yerel öğeleri gönderir | Yol yapılandırmasını kaldır |
| Sayfa Oluşturma | NewPage() yöntemi | HTML'den otomatik | Sayfa oluşturma çağrılarını kaldır |
| Geri Dönüş Değerleri | Tamsayı hata kodları | Istisnalar | try/catch uygulayın |
| Sayfa Boyutu Birimleri | Noktalar (612x792 = Mektup) | Enum veya milimetre | Ölçümleri Güncelle |
Ortamınızın bu gereksinimleri karşıladığından emin olun:
nuget.org üzerinde paket ActivePDF.Toolkit (şu anki sürüm 11.4.4, Aralık 2025 yayınlandı). HTML renderleme, ActivePDF.WebGrabber olarak ayrı gönderilir.ActivePDFSKU'larını kaldırın ve IronPDF'i yükleyin:
# RemoveActivePDFpackages
dotnet remove package ActivePDF.Toolkit
dotnet remove package ActivePDF.WebGrabber
# Install IronPDF
dotnet add package IronPdfAlternatif olarak, Visual Studio Paket Yöneticisi Konsolu aracılığıyla:
Uninstall-Package ActivePDF.Toolkit
Uninstall-Package ActivePDF.WebGrabber
Install-Package IronPdfManuel DLL referansları olan projeler için, .csproj dosyanızdaki referansı kaldırın:
<!-- Remove this block -->
<Reference Include="APToolkitNET">
<HintPath>path\to\APToolkitNET.dll</HintPath>
</Reference>Uygulama başlangıcında IronPDF lisans anahtarını ekleyin, herhangi bir PDF işlemi öncesinde:
// Add at application startup (Program.cs or Startup.cs)
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";
// Verify license status
bool isLicensed = IronPdf.License.IsLicensed;' Add at application startup (Program.vb or Startup.vb)
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY"
' Verify license status
Dim isLicensed As Boolean = IronPdf.License.IsLicensedÇözümünüz genelinde küresel bir bul ve değiştir yapın:
| Bul | Bununla Değiştir |
|---|---|
using APToolkitNET; | using IronPdf; |
using APWebGrabber; | using IronPdf; |
APToolkitNET.Toolkit | ChromePdfRenderer (oluşturma) / PdfDocument (manipülasyon) |
APWebGrabber.WebGrabber | ChromePdfRenderer |
| ActivePDFMetodu | IronPDF Eşdeğeri | Notlar |
|---|---|---|
new APToolkitNET.Toolkit() | new ChromePdfRenderer() / new PdfDocument(...) | IronPDF render'i manipülasyonundan ayırır |
new Toolkit(CoreLibPath: path) | new ChromePdfRenderer() | NuGet yerel dosyaları gönderir—CoreLibPath yok |
toolkit.OpenOutputFile(path) | Eşdeğeri gerekmez | Sadece sonunda SaveAs çağırın |
toolkit.CloseOutputFile() | Eşdeğeri gerekmez | using temizliği yönetir |
webGrabber.URL = html; webGrabber.ConvertToPDF() | renderer.RenderHtmlAsPdf(html) | WebGrabber, Toolkit değil |
webGrabber.URL = url; webGrabber.ConvertToPDF() | renderer.RenderUrlAsPdf(url) | WebGrabber, Toolkit değil |
| ActivePDFMetodu | IronPDF Eşdeğeri | Notlar |
|---|---|---|
toolkit.OpenInputFile(path) | PdfDocument.FromFile(path) | Mevcut PDF'yi yükle |
toolkit.MergeFile(path, startPage, endPage) | PdfDocument.Merge(pdfs) | ActivePDF açılan çıktı dosyasına yerinde birleştirilir;IronPDF yeni bir birleştirilmiş belge döndürür |
toolkit.NumPages (özellik) | pdf.PageCount | Sayfa sayısı |
toolkit.GetPageText(page, 0) | pdf.Pages[i].Text / pdf.ExtractAllText() | Metin çıkarma |
| ActivePDFMetodu | IronPDF Eşdeğeri |
|---|---|
toolkit.SetPageSize(612, 792) | RenderingOptions.PaperSize = PdfPaperSize.Letter |
toolkit.SetOrientation("Landscape") | RenderingOptions.PaperOrientation = PdfPaperOrientation.Landscape |
toolkit.SetMargins(t, b, l, r) | RenderingOptions.MarginTop/Bottom/Left/Right |
| ActivePDFMetodu | IronPDF Eşdeğeri |
|---|---|
toolkit.SetEncryption(user, owner, 128, 0) | pdf.SecuritySettings.OwnerPassword / UserPassword |
toolkit.SetPermissions(flags) | pdf.SecuritySettings.AllowUserXxx |
toolkit.PrintText(x, y, text) (sayfa başına filigran) | pdf.ApplyWatermark(html) |
HTML dizelerini PDF belgelerine dönüştürmek, en yaygın PDF üretme senaryolarından birini temsil eder. ActivePDF'de, HTML render ayrı lisanslı WebGrabber ürününde yer alır, Toolkit'te değil, ve WebGrabber bir URL'yi veya dosya yolunu işlemeden önce bellekte bir dizeyle işlenir.
ActivePDF Uygulaması (WebGrabber):
// NuGet: Install-Package ActivePDF.WebGrabber
using APWebGrabber;
using System;
using System.IO;
class Program
{
static void Main()
{
WebGrabber wg = new WebGrabber();
string htmlContent = "<html><body><h1>Hello World</h1></body></html>";
string tempHtml = Path.Combine(Path.GetTempPath(), "input.html");
File.WriteAllText(tempHtml, htmlContent);
wg.URL = tempHtml;
wg.OutputDirectory = Directory.GetCurrentDirectory();
wg.OutputFilename = "output.pdf";
if (wg.ConvertToPDF() == 0)
{
Console.WriteLine("PDF created successfully");
}
}
}Imports APWebGrabber
Imports System
Imports System.IO
Module Program
Sub Main()
Dim wg As New WebGrabber()
Dim htmlContent As String = "<html><body><h1>Hello World</h1></body></html>"
Dim tempHtml As String = Path.Combine(Path.GetTempPath(), "input.html")
File.WriteAllText(tempHtml, htmlContent)
wg.URL = tempHtml
wg.OutputDirectory = Directory.GetCurrentDirectory()
wg.OutputFilename = "output.pdf"
If wg.ConvertToPDF() = 0 Then
Console.WriteLine("PDF created successfully")
End If
End Sub
End ModuleIronPDF Uygulaması:
// NuGet: Install-Package IronPdf
using IronPdf;
using System;
class Program
{
static void Main()
{
var renderer = new ChromePdfRenderer();
string htmlContent = "<html><body><h1>Hello World</h1></body></html>";
var pdf = renderer.RenderHtmlAsPdf(htmlContent);
pdf.SaveAs("output.pdf");
Console.WriteLine("PDF created successfully");
}
}' NuGet: Install-Package IronPdf
Imports IronPdf
Imports System
Module Program
Sub Main()
Dim renderer As New ChromePdfRenderer()
Dim htmlContent As String = "<html><body><h1>Hello World</h1></body></html>"
Dim pdf = renderer.RenderHtmlAsPdf(htmlContent)
pdf.SaveAs("output.pdf")
Console.WriteLine("PDF created successfully")
End Sub
End ModuleIronPDF yaklaşımı, açık dosya tanıtıcı yönetimini ortadan kaldırır ve daha temiz, daha okunabilir kod sunar. Gelişmiş HTML'den PDF'ye senaryoları için, IronPDF'in ChromePdfRenderer'i piksel hassasiyetinde CSS ve JavaScript desteği için Çromium tabanlı bir oluşturma motoru kullanır.
Web sayfalarını PDF belgeleri olarak yakalama, Toolkit'te değil, WebGrabber'da barındırılır.
ActivePDF Uygulaması (WebGrabber):
// NuGet: Install-Package ActivePDF.WebGrabber
using APWebGrabber;
using System;
using System.IO;
class Program
{
static void Main()
{
WebGrabber wg = new WebGrabber();
wg.URL = "https://www.example.com";
wg.OutputDirectory = Directory.GetCurrentDirectory();
wg.OutputFilename = "webpage.pdf";
if (wg.ConvertToPDF() == 0)
{
Console.WriteLine("PDF from URL created successfully");
}
}
}Imports APWebGrabber
Imports System
Imports System.IO
Module Program
Sub Main()
Dim wg As New WebGrabber()
wg.URL = "https://www.example.com"
wg.OutputDirectory = Directory.GetCurrentDirectory()
wg.OutputFilename = "webpage.pdf"
If wg.ConvertToPDF() = 0 Then
Console.WriteLine("PDF from URL created successfully")
End If
End Sub
End ModuleIronPDF Uygulaması:
using IronPdf;
using System;
class Program
{
static void Main()
{
var renderer = new ChromePdfRenderer();
string url = "https://www.example.com";
var pdf = renderer.RenderUrlAsPdf(url);
pdf.SaveAs("webpage.pdf");
Console.WriteLine("PDF from URL created successfully");
}
}Imports IronPdf
Imports System
Module Program
Sub Main()
Dim renderer = New ChromePdfRenderer()
Dim url As String = "https://www.example.com"
Dim pdf = renderer.RenderUrlAsPdf(url)
pdf.SaveAs("webpage.pdf")
Console.WriteLine("PDF from URL created successfully")
End Sub
End ModuleBirden fazla PDF belgesini tek bir dosyada birleştirmek, IronPDF'in belge manipülasyonu için işlevsel yaklaşımını gösterir.
ActivePDF Uygulaması (Toolkit):
// NuGet: Install-Package ActivePDF.Toolkit
using APToolkitNET;
using System;
class Program
{
static void Main()
{
using (Toolkit toolkit = new Toolkit())
{
if (toolkit.OpenOutputFile("merged.pdf") == 0)
{
// MergeFile(FileName, StartPage, EndPage); -1 = end of file
toolkit.MergeFile("document1.pdf", 1, -1);
toolkit.MergeFile("document2.pdf", 1, -1);
toolkit.CloseOutputFile();
Console.WriteLine("PDFs merged successfully");
}
}
}
}Imports APToolkitNET
Imports System
Module Program
Sub Main()
Using toolkit As New Toolkit()
If toolkit.OpenOutputFile("merged.pdf") = 0 Then
' MergeFile(FileName, StartPage, EndPage); -1 = end of file
toolkit.MergeFile("document1.pdf", 1, -1)
toolkit.MergeFile("document2.pdf", 1, -1)
toolkit.CloseOutputFile()
Console.WriteLine("PDFs merged successfully")
End If
End Using
End Sub
End ModuleIronPDF Uygulaması:
using IronPdf;
using System;
using System.Collections.Generic;
class Program
{
static void Main()
{
var pdf1 = PdfDocument.FromFile("document1.pdf");
var pdf2 = PdfDocument.FromFile("document2.pdf");
var merged = PdfDocument.Merge(pdf1, pdf2);
merged.SaveAs("merged.pdf");
Console.WriteLine("PDFs merged successfully");
}
}Imports IronPdf
Imports System
Imports System.Collections.Generic
Module Program
Sub Main()
Dim pdf1 = PdfDocument.FromFile("document1.pdf")
Dim pdf2 = PdfDocument.FromFile("document2.pdf")
Dim merged = PdfDocument.Merge(pdf1, pdf2)
merged.SaveAs("merged.pdf")
Console.WriteLine("PDFs merged successfully")
End Sub
End ModuleSeçici sayfa çıkarma da dahil olmak üzere daha gelişmiş birleştirme senaryoları için, PDF birleştirme belgelerini inceleyin.
ActivePDF Uygulaması (WebGrabber):
using APWebGrabber;
using System.IO;
public void CreatePdfWithHeaderFooter(string html, string outputPath)
{
var wg = new WebGrabber();
string tempHtml = Path.Combine(Path.GetTempPath(), "input.html");
File.WriteAllText(tempHtml, html);
wg.URL = tempHtml;
wg.HeaderText = "My Document";
wg.FooterText = "Page [page] of [pages]";
wg.OutputDirectory = Path.GetDirectoryName(outputPath);
wg.OutputFilename = Path.GetFileName(outputPath);
wg.ConvertToPDF();
}Imports APWebGrabber
Imports System.IO
Public Sub CreatePdfWithHeaderFooter(html As String, outputPath As String)
Dim wg As New WebGrabber()
Dim tempHtml As String = Path.Combine(Path.GetTempPath(), "input.html")
File.WriteAllText(tempHtml, html)
wg.URL = tempHtml
wg.HeaderText = "My Document"
wg.FooterText = "Page [page] of [pages]"
wg.OutputDirectory = Path.GetDirectoryName(outputPath)
wg.OutputFilename = Path.GetFileName(outputPath)
wg.ConvertToPDF()
End SubIronPDF Uygulaması:
using IronPdf;
public void CreatePdfWithHeaderFooter(string html, string outputPath)
{
var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.TextHeader = new TextHeaderFooter
{
CenterText = "My Document",
FontSize = 12,
FontFamily = "Arial"
};
renderer.RenderingOptions.TextFooter = new TextHeaderFooter
{
CenterText = "Page {page} of {total-pages}",
FontSize = 10,
FontFamily = "Arial"
};
using var pdf = renderer.RenderHtmlAsPdf(html);
pdf.SaveAs(outputPath);
}Imports IronPdf
Public Sub CreatePdfWithHeaderFooter(html As String, outputPath As String)
Dim renderer = New ChromePdfRenderer()
renderer.RenderingOptions.TextHeader = New TextHeaderFooter With {
.CenterText = "My Document",
.FontSize = 12,
.FontFamily = "Arial"
}
renderer.RenderingOptions.TextFooter = New TextHeaderFooter With {
.CenterText = "Page {page} of {total-pages}",
.FontSize = 10,
.FontFamily = "Arial"
}
Using pdf = renderer.RenderHtmlAsPdf(html)
pdf.SaveAs(outputPath)
End Using
End SubIronPDF, hem metin tabanlı hem de HTML başlıkları ve altbilgileri destekler, tam tasarım esnekliği sunar.
ActivePDF Uygulaması (Toolkit):
using APToolkitNET;
public void ProtectPdf(string inputPath, string outputPath, string password)
{
using (Toolkit toolkit = new Toolkit())
{
if (toolkit.OpenOutputFile(outputPath) == 0
&& toolkit.OpenInputFile(inputPath) == 0)
{
toolkit.SetEncryption(password, password, 128, 0);
toolkit.CopyForm(0, 0);
toolkit.CloseInputFile();
toolkit.CloseOutputFile();
}
}
}Imports APToolkitNET
Public Sub ProtectPdf(inputPath As String, outputPath As String, password As String)
Using toolkit As New Toolkit()
If toolkit.OpenOutputFile(outputPath) = 0 AndAlso toolkit.OpenInputFile(inputPath) = 0 Then
toolkit.SetEncryption(password, password, 128, 0)
toolkit.CopyForm(0, 0)
toolkit.CloseInputFile()
toolkit.CloseOutputFile()
End If
End Using
End SubIronPDF Uygulaması:
using IronPdf;
public void ProtectPdf(string inputPath, string outputPath, string password)
{
using var pdf = PdfDocument.FromFile(inputPath);
pdf.SecuritySettings.OwnerPassword = password;
pdf.SecuritySettings.UserPassword = password;
pdf.SecuritySettings.AllowUserPrinting = PdfPrintSecurity.FullPrintRights;
pdf.SecuritySettings.AllowUserCopyPasteContent = false;
pdf.SecuritySettings.AllowUserEdits = PdfEditSecurity.NoEdit;
pdf.SaveAs(outputPath);
}Imports IronPdf
Public Sub ProtectPdf(inputPath As String, outputPath As String, password As String)
Using pdf = PdfDocument.FromFile(inputPath)
pdf.SecuritySettings.OwnerPassword = password
pdf.SecuritySettings.UserPassword = password
pdf.SecuritySettings.AllowUserPrinting = PdfPrintSecurity.FullPrintRights
pdf.SecuritySettings.AllowUserCopyPasteContent = False
pdf.SecuritySettings.AllowUserEdits = PdfEditSecurity.NoEdit
pdf.SaveAs(outputPath)
End Using
End SubIronPDF'in güvenlik ayarları API'si, belge izinleri üzerinde güçlü türlendirilmiş numaralandırmalar yerine tamsayı bayraklar sağlar.
ActivePDF Uygulaması (Toolkit):
using APToolkitNET;
using System.Text;
public string ExtractText(string pdfPath)
{
var sb = new StringBuilder();
using (Toolkit toolkit = new Toolkit())
{
if (toolkit.OpenInputFile(pdfPath) == 0)
{
int pageCount = toolkit.NumPages;
for (int i = 1; i <= pageCount; i++)
{
sb.AppendLine(toolkit.GetPageText(i, 0));
}
toolkit.CloseInputFile();
}
}
return sb.ToString();
}Imports APToolkitNET
Imports System.Text
Public Function ExtractText(pdfPath As String) As String
Dim sb As New StringBuilder()
Using toolkit As New Toolkit()
If toolkit.OpenInputFile(pdfPath) = 0 Then
Dim pageCount As Integer = toolkit.NumPages
For i As Integer = 1 To pageCount
sb.AppendLine(toolkit.GetPageText(i, 0))
Next
toolkit.CloseInputFile()
End If
End Using
Return sb.ToString()
End FunctionIronPDF Uygulaması:
using IronPdf;
public string ExtractText(string pdfPath)
{
using var pdf = PdfDocument.FromFile(pdfPath);
return pdf.ExtractAllText();
}Imports IronPdf
Public Function ExtractText(pdfPath As String) As String
Using pdf = PdfDocument.FromFile(pdfPath)
Return pdf.ExtractAllText()
End Using
End FunctionIronPDF uygulaması, çoklu satırdan tek bir yöntem çağrısına metin çıkarma işlemini azaltır.
ActivePDF Uygulaması (Toolkit — sayfa başına sayfa metni olarak çizilir):
using APToolkitNET;
public void AddWatermark(string inputPath, string outputPath, string watermarkText)
{
using (Toolkit toolkit = new Toolkit())
{
if (toolkit.OpenOutputFile(outputPath) == 0
&& toolkit.OpenInputFile(inputPath) == 0)
{
int pageCount = toolkit.NumPages;
for (int i = 1; i <= pageCount; i++)
{
toolkit.CopyForm(i, 0);
toolkit.SetFont("Helvetica", 72);
toolkit.SetTextColor(200, 200, 200);
toolkit.PrintText(150, 400, watermarkText);
}
toolkit.CloseInputFile();
toolkit.CloseOutputFile();
}
}
}Imports APToolkitNET
Public Sub AddWatermark(inputPath As String, outputPath As String, watermarkText As String)
Using toolkit As New Toolkit()
If toolkit.OpenOutputFile(outputPath) = 0 AndAlso toolkit.OpenInputFile(inputPath) = 0 Then
Dim pageCount As Integer = toolkit.NumPages
For i As Integer = 1 To pageCount
toolkit.CopyForm(i, 0)
toolkit.SetFont("Helvetica", 72)
toolkit.SetTextColor(200, 200, 200)
toolkit.PrintText(150, 400, watermarkText)
Next
toolkit.CloseInputFile()
toolkit.CloseOutputFile()
End If
End Using
End SubIronPDF Uygulaması:
using IronPdf;
public void AddWatermark(string inputPath, string outputPath, string watermarkText)
{
using var pdf = PdfDocument.FromFile(inputPath);
pdf.ApplyWatermark(
$"<h1 style='color:lightgray;font-size:72px;'>{watermarkText}</h1>",
rotation: 45,
opacity: 50);
pdf.SaveAs(outputPath);
}Imports IronPdf
Public Sub AddWatermark(inputPath As String, outputPath As String, watermarkText As String)
Using pdf = PdfDocument.FromFile(inputPath)
pdf.ApplyWatermark(
$"<h1 style='color:lightgray;font-size:72px;'>{watermarkText}</h1>",
rotation:=45,
opacity:=50)
pdf.SaveAs(outputPath)
End Using
End SubIronPDF'in HTML tabanlı filigranlama CSS stilleme sağlar ve sayfa başına yineleme gerekmeksizin tam tasarım kontrolü sunar.
Modern web uygulamaları, IronPDF'in daha temiz entegrasyon kalıplarından önemli ölçüde faydalanır.
ActivePDF Pattern (WebGrabber):
[HttpPost]
public IActionResult GeneratePdf([FromBody] ReportRequest request)
{
var wg = new APWebGrabber.WebGrabber();
string tempHtml = Path.Combine(Path.GetTempPath(), Guid.NewGuid() + ".html");
System.IO.File.WriteAllText(tempHtml, request.Html);
wg.URL = tempHtml;
wg.OutputDirectory = Path.GetTempPath();
wg.OutputFilename = "temp.pdf";
if (wg.ConvertToPDF() == 0)
{
byte[] bytes = System.IO.File.ReadAllBytes(Path.Combine(Path.GetTempPath(), "temp.pdf"));
return File(bytes, "application/pdf", "report.pdf");
}
return BadRequest("PDF generation failed");
}Imports System
Imports System.IO
Imports Microsoft.AspNetCore.Mvc
<HttpPost>
Public Function GeneratePdf(<FromBody> request As ReportRequest) As IActionResult
Dim wg As New APWebGrabber.WebGrabber()
Dim tempHtml As String = Path.Combine(Path.GetTempPath(), Guid.NewGuid().ToString() & ".html")
System.IO.File.WriteAllText(tempHtml, request.Html)
wg.URL = tempHtml
wg.OutputDirectory = Path.GetTempPath()
wg.OutputFilename = "temp.pdf"
If wg.ConvertToPDF() = 0 Then
Dim bytes As Byte() = System.IO.File.ReadAllBytes(Path.Combine(Path.GetTempPath(), "temp.pdf"))
Return File(bytes, "application/pdf", "report.pdf")
End If
Return BadRequest("PDF generation failed")
End FunctionIronPDF Deseni:
[HttpPost]
public IActionResult GeneratePdf([FromBody] ReportRequest request)
{
var renderer = new ChromePdfRenderer();
using var pdf = renderer.RenderHtmlAsPdf(request.Html);
return File(pdf.BinaryData, "application/pdf", "report.pdf");
}<HttpPost>
Public Function GeneratePdf(<FromBody> request As ReportRequest) As IActionResult
Dim renderer As New ChromePdfRenderer()
Using pdf = renderer.RenderHtmlAsPdf(request.Html)
Return File(pdf.BinaryData, "application/pdf", "report.pdf")
End Using
End FunctionIronPDF, geçici dosyalara olan ihtiyacı ortadan kaldırır, PDF ikili verilerini doğrudan bellekten döndürür.
ActivePDF yerel async desteğine sahip değildir. IronPDF, ölçeklenebilir web uygulamaları için gerekli olan tam async/await yetenekleri sağlar:
using IronPdf;
public async Task<byte[]> GeneratePdfAsync(string html)
{
var renderer = new ChromePdfRenderer();
using var pdf = await renderer.RenderHtmlAsPdfAsync(html);
return pdf.BinaryData;
}Imports IronPdf
Public Async Function GeneratePdfAsync(html As String) As Task(Of Byte())
Dim renderer As New ChromePdfRenderer()
Using pdf = Await renderer.RenderHtmlAsPdfAsync(html)
Return pdf.BinaryData
End Using
End Function.NET 6+ uygulamaları için, DI konteynerinizde IronPDF servislerini kaydedin:
// Program.cs (.NET 6+)
builder.Services.AddSingleton<ChromePdfRenderer>();
// Service wrapper
public interface IPdfService
{
Task<byte[]> GeneratePdfAsync(string html);
Task<byte[]> GeneratePdfFromUrlAsync(string url);
}
public class IronPdfService : IPdfService
{
private readonly ChromePdfRenderer _renderer;
public IronPdfService()
{
_renderer = new ChromePdfRenderer();
_renderer.RenderingOptions.PaperSize = PdfPaperSize.A4;
}
public async Task<byte[]> GeneratePdfAsync(string html)
{
using var pdf = await _renderer.RenderHtmlAsPdfAsync(html);
return pdf.BinaryData;
}
public async Task<byte[]> GeneratePdfFromUrlAsync(string url)
{
using var pdf = await _renderer.RenderUrlAsPdfAsync(url);
return pdf.BinaryData;
}
}Imports Microsoft.Extensions.DependencyInjection
Imports System.Threading.Tasks
' Program.vb (.NET 6+)
builder.Services.AddSingleton(Of ChromePdfRenderer)()
' Service wrapper
Public Interface IPdfService
Function GeneratePdfAsync(html As String) As Task(Of Byte())
Function GeneratePdfFromUrlAsync(url As String) As Task(Of Byte())
End Interface
Public Class IronPdfService
Implements IPdfService
Private ReadOnly _renderer As ChromePdfRenderer
Public Sub New()
_renderer = New ChromePdfRenderer()
_renderer.RenderingOptions.PaperSize = PdfPaperSize.A4
End Sub
Public Async Function GeneratePdfAsync(html As String) As Task(Of Byte()) Implements IPdfService.GeneratePdfAsync
Using pdf = Await _renderer.RenderHtmlAsPdfAsync(html)
Return pdf.BinaryData
End Using
End Function
Public Async Function GeneratePdfFromUrlAsync(url As String) As Task(Of Byte()) Implements IPdfService.GeneratePdfFromUrlAsync
Using pdf = Await _renderer.RenderUrlAsPdfAsync(url)
Return pdf.BinaryData
End Using
End Function
End ClassActivePDF, bakış tablosuna ihtiyaç duyan tam sayı dönüş kodlarını kullanır. IronPDF, modern istisna yönetimini kullanır:
ActivePDF Hata Yönetimi:
using APToolkitNET;
using (var toolkit = new Toolkit())
{
int result = toolkit.OpenOutputFile(path);
if (result != 0)
{
// Error - look up the code in "Toolkit Return Results and Error Codes"
Console.WriteLine($"Error code: {result}");
}
}Imports APToolkitNET
Using toolkit As New Toolkit()
Dim result As Integer = toolkit.OpenOutputFile(path)
If result <> 0 Then
' Error - look up the code in "Toolkit Return Results and Error Codes"
Console.WriteLine($"Error code: {result}")
End If
End UsingIronPDF Hata Yönetimi:
try
{
var renderer = new ChromePdfRenderer();
using var pdf = renderer.RenderHtmlAsPdf(html);
pdf.SaveAs(path);
}
catch (IronPdf.Exceptions.IronPdfProductException ex)
{
Console.WriteLine($"IronPDF Error: {ex.Message}");
}
catch (Exception ex)
{
Console.WriteLine($"General Error: {ex.Message}");
}Imports IronPdf.Exceptions
Try
Dim renderer = New ChromePdfRenderer()
Using pdf = renderer.RenderHtmlAsPdf(html)
pdf.SaveAs(path)
End Using
Catch ex As IronPdfProductException
Console.WriteLine($"IronPDF Error: {ex.Message}")
Catch ex As Exception
Console.WriteLine($"General Error: {ex.Message}")
End TryYeni bir ChromePdfRenderer oluşturmak başlangıç yükü getirir. Toplu işlemler için, tek bir örneği yeniden kullanın:
var renderer = new ChromePdfRenderer();
foreach (var html in htmlList)
{
using var pdf = renderer.RenderHtmlAsPdf(html);
pdf.SaveAs($"output_{i}.pdf");
}Imports IronPdf
Dim renderer As New ChromePdfRenderer()
For Each html In htmlList
Using pdf = renderer.RenderHtmlAsPdf(html)
pdf.SaveAs($"output_{i}.pdf")
End Using
NextASP.NET Core uygulamaları için, async PDF üretimi throughput'u artırır:
public async Task<IActionResult> GenerateReport()
{
var renderer = new ChromePdfRenderer();
using var pdf = await renderer.RenderHtmlAsPdfAsync(html);
return File(pdf.BinaryData, "application/pdf");
}Imports System.Threading.Tasks
Imports Microsoft.AspNetCore.Mvc
Public Class ReportController
Inherits Controller
Public Async Function GenerateReport() As Task(Of IActionResult)
Dim renderer As New ChromePdfRenderer()
Using pdf = Await renderer.RenderHtmlAsPdfAsync(html)
Return File(pdf.BinaryData, "application/pdf")
End Using
End Function
End ClassHer zaman uygun temizlik sağlamak için using ifadelerini kullanın:
using var pdf = renderer.RenderHtmlAsPdf(html);
return pdf.BinaryData;netResim sıkıştırması ile çıktı dosya boyutlarını küçültün:
using var pdf = renderer.RenderHtmlAsPdf(html);
pdf.CompressImages(85); // 85% quality
pdf.SaveAs("compressed.pdf");netActivePDF WebGrabber noktalar (612x792 = Mektup) kullanırken,IronPDF enum veya milimetre kullanır:
//ActivePDFWebGrabber: Points
wg.PageWidth = 612;
wg.PageHeight = 792;
// IronPDF: Use enum
renderer.RenderingOptions.PaperSize = PdfPaperSize.Letter;
// Or custom in mm:
renderer.RenderingOptions.SetCustomPaperSizeInMillimeters(215.9, 279.4);IronPDF, açık dosya tutucu yönetimi olmadan modern bir paradigma kullanır:
//ActivePDFToolkit
toolkit.OpenOutputFile(path);
// ... operations ...
toolkit.CloseOutputFile(); // Required!
//IronPDF- no open/close needed
using var pdf = renderer.RenderHtmlAsPdf(html);
pdf.SaveAs(path); // 'using' handles cleanupJavaScript'e bağlı içerikler boş yükleniyorsa, render gecikmelerini yapılandırın:
var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.WaitFor.RenderDelay(2000);
// Or wait for element:
renderer.RenderingOptions.WaitFor.HtmlElementById("content-loaded");Dim renderer = New ChromePdfRenderer()
renderer.RenderingOptions.WaitFor.RenderDelay(2000)
' Or wait for element:
renderer.RenderingOptions.WaitFor.HtmlElementById("content-loaded")Göreli yol çözümü için temel URL'yi yapılandırın:
renderer.RenderingOptions.BaseUrl = new Uri("https://yourdomain.com/assets/");renderer.RenderingOptions.BaseUrl = New Uri("https://yourdomain.com/assets/")Kod taşımasını tamamladıktan sonra, aşağıdakileri doğrulayın:
IronPdf.License.IsLicensed)ActivePDF'den IronPDF'ye geçiş, PDF oluşturma altyapınızı daha temiz API'ler, daha iyi .NET entegrasyonu ve aktif uzun vadeli destek ile modernize eder. Geçişe yapılan yatırım, artırılmış kod sürdürülebilirliği, async yetenekleri ve PDF kütüphanenizin devam eden geliştirilmesi konusunda güvence sağlar.
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ı.
