pdforge'ten IronPDF'e C# ile Nasıl Geçilir
pdforge'dan IronPDF'ye Neden Geçiş Yapılmalı
pdforge'u Anlamak
pdforge (2026'da 'pdf noodle' olarak yeniden adlandırılmıştır — pdfnoodle.com; api.pdforge.com ana bilgisayar adı, 2026'nın sonuna kadar 301 yönlendirmeleri yoluyla çalışmaya devam eder) bulut tabanlı, şablona dayalı bir PDF üretim API'sidir ve uygulamanızla HTTP çağrıları aracılığıyla entegre olarak PDF dosyaları üretmenin basit bir yolunu sunar. Resmi .NET SDK'sı NuGet üzerinde yok — entegrasyon, belgelenmiş REST uç noktalarına karşı HttpClient ile yapılır. PDF oluşturma görevini harici bir API'ye aktararak, geliştiriciler geliştirme sürecini basitleştirebilir. Ancak, pdforge harici bağımlılıklar, sınırlı özelleştirme seçenekleri ve devam eden abonelik maliyetleri gibi dezavantajlar sunar ki bu, geliştiricilerin farkında olması gereken bir durumdur.
Bulut API Bağımlılığı Problemi
pdforge tüm belgeleri harici bulut sunucularında işler. Bu mimari, üretim uygulamaları için büyük endişeler yaratır:
-
Harici Sunucu İşlemi: Oluşturduğunuz her PDF, HTML/verilerinizi pdforge'un sunucularına göndermeniz gerektiği için belgeleriniz altyapınızı terk eder.
-
Gizlilik ve Uyumluluk Riskleri: Hassas veri, üçüncü taraf sunucularına internet üzerinden gönderilir. pdforge kullanırken, geliştiriciler bir harici API'ye veri gönderilmesiyle ilgili güvenlik endişelerini karşılamak zorundadır. PDF içeriği hassas bilgileri içeriyorsa, bu önemli bir husus olabilir.
-
Devam Eden Abonelik Maliyetleri: Aylık ücretler, varlık mülkiyeti olmadan süresiz bir şekilde birikir. pdforge'un SaaS modeli, zamanla birikebilecek sürekli işletim harcamalarını tanıtır.
-
İnternet Bağımlılığı: Ağ olmadığında PDF oluşturma yok.
-
Hız Sınırları: API kullanım limitleri çoğu uygulamayı sınırlayabilir.
- Ağ Gecikmesi: Gidiş-dönüş süresi her PDF oluşturma işlemine saniyeler ekler.
pdforge vs IronPDF Karşılaştırması
| Özellik | pdforge | IronPDF |
|---|---|---|
| Dağıtım Türü | Bulut tabanlı API | Yerel kütüphane |
| Bağımlılıklar | İnternet ve API kimlik doğrulaması gerektirir | Harici bağımlılık yok |
| Özelleştirme | PDF oluşturma üzerinde sınırlı denetim | Özelleştirme üzerinde tam denetim |
| Maliyet Yapısı | Devam eden abonelik | Tek seferlik satın alma seçeneği |
| Güvenlik | Web üzerinden gönderilen veri ile ilgili olası endişeler | Veri işleme tamamen yerel ortamda kalır |
| Kurulum Karmaşıklığı | Dış işlem nedeniyle daha kolay başlangıç kurulumu | Daha fazla başlangıç konfigürasyonu ve yapılandırma gerektirir |
IronPDF, geliştiricilere PDF oluşturma süreci üzerinde tam kontrol sağlayan tamamen yerel bir kütüphane sunarak kendisini ayırır. Bu, dosyaların dahili olarak ele alınmasının tercih edildiği veya harici API çağrılarının güvenlik endişeleri getirdiği uygulamalar için özellikle avantajlıdır.IronPDF her şeyi yerel olarak işler, bu tür riskleri en aza indirir.
Güncel .NET sürümleri üzerinde .NET 10 ve C# 14 benimsenmesini planlayan ekipler için,IronPDF bulut bağımlılığını ortadan kaldırırken kapsamlı PDF manipülasyon yetenekleri ekleyen yerel bir işlem temeli sağlar.
Başlamadan Önce
Ön Koşullar
- .NET Ortamı: .NET Framework 4.6.2+ veya .NET Core 3.1+ / .NET 5/6/7/8/9+
- NuGet Erişimi: NuGet paketlerini yükleyebilme
- IronPDF Lisansı: Lisans anahtarınızı ironpdf.com adresinden edinin
NuGet Paket Değişiklikleri
# pdforge has no official .NET SDK on NuGet — integration is HttpClient + JSON.
# If your project depends only on built-in System.Net.Http, there is no
# competitor package to remove. Just install IronPDF:
dotnet add package IronPdf
# pdforge has no official .NET SDK on NuGet — integration is HttpClient + JSON.
# If your project depends only on built-in System.Net.Http, there is no
# competitor package to remove. Just install IronPDF:
dotnet add package IronPdf
Lisans Yapılandırması
// Add at application startup (Program.cs or Startup.cs)
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";
// Add at application startup (Program.cs or Startup.cs)
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";
' Add at application startup (Program.vb or Startup.vb)
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY"
pdforge Kullanımını Belirleyin
# Find pdforge / pdf noodle endpoint usage
grep -r "api\.pdforge\.com\|api\.pdfnoodle\.com" --include="*.cs" .
# Find API key / Bearer token references
grep -r "pdfnoodle_api_\|pdforge_api_" --include="*.cs" --include="*.json" --include="*.config" .
# Find Chromium header/footer templates that need migrating
grep -r "totalPages\|pageNumber\|footerTemplate\|headerTemplate" --include="*.cs" .
# Find pdforge / pdf noodle endpoint usage
grep -r "api\.pdforge\.com\|api\.pdfnoodle\.com" --include="*.cs" .
# Find API key / Bearer token references
grep -r "pdfnoodle_api_\|pdforge_api_" --include="*.cs" --include="*.json" --include="*.config" .
# Find Chromium header/footer templates that need migrating
grep -r "totalPages\|pageNumber\|footerTemplate\|headerTemplate" --include="*.cs" .
Tam API Referansı
Ad Alanı Değişiklikleri
// Before: pdforge — raw HttpClient against api.pdfnoodle.com
using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;
using System.Text.Json;
// After: IronPDF
using IronPdf;
using IronPdf.Rendering;
// Before: pdforge — raw HttpClient against api.pdfnoodle.com
using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;
using System.Text.Json;
// After: IronPDF
using IronPdf;
using IronPdf.Rendering;
Imports System.Net.Http
Imports System.Net.Http.Headers
Imports System.Text
Imports System.Text.Json
Imports IronPdf
Imports IronPdf.Rendering
Temel Kavram Eşleştirmeleri
| pdforge (REST) | IronPDF |
|---|---|
HttpClient + Authorization: Bearer pdfnoodle_api_... |
new ChromePdfRenderer() |
POST https://api.pdfnoodle.com/v1/html-to-pdf/sync |
renderer.RenderHtmlAsPdf(html) |
JSON gövdesi { html, pdfParams } |
ChromePdfRenderer + RenderingOptions |
Yanıt: signedUrl ile JSON zarfı |
PdfDocument |
Dönüş: byte[] (signedUrl alındıktan sonra) |
pdf.BinaryData |
Operasyon Eşleştirmeleri
| pdforge | IronPDF |
|---|---|
POST /v1/html-to-pdf/sync ile { html } |
renderer.RenderHtmlAsPdf(html) |
| URL'i çekin, ardından HTML'ini POST edin (özel URL uç noktası yok) | renderer.RenderUrlAsPdf(url) |
signedUrl indir, ardından File.WriteAllBytes(path, bytes) |
pdf.SaveAs(path) |
await http.GetByteArrayAsync(signedUrl) |
pdf.BinaryData |
Yapılandırma Haritaları
pdforge pdfParams |
IronPDF (RenderingOptions) |
|---|---|
format: "A4" |
renderer.RenderingOptions.PaperSize = PdfPaperSize.A4 |
landscape: true |
renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Landscape |
margin: { top: "20px" } |
renderer.RenderingOptions.MarginTop = 20 |
footerTemplate ile <span class="pageNumber"> / <span class="totalPages"> |
TextFooter = new TextHeaderFooter { CenterText = "Page {page} of {total-pages}" } |
pdforge'da Bulunmayan Yeni Özellikler
| IronPDF Özelliği | Açıklama |
|---|---|
PdfDocument.Merge() |
Birden fazla PDF'yi birleştir |
pdf.ExtractAllText() |
PDF'lerden metin çıkartma |
pdf.ApplyWatermark() |
Filigran ekleme |
pdf.SecuritySettings |
Parola koruması |
pdf.Form |
Form doldurma |
pdf.SignWithDigitalSignature() |
Dijital imzalar |
Kod Göç Örnekleri
Örnek 1: HTML Metin Dizesi'ni PDF'e Dönüşüm
Öncesi (pdforge):
// REST API — no .NET SDK on NuGet. Integration is HttpClient + JSON POST.
using System.IO;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;
using System.Text.Json;
using System.Threading.Tasks;
class Program
{
static async Task Main()
{
using var http = new HttpClient();
http.DefaultRequestHeaders.Authorization =
new AuthenticationHeaderValue("Bearer", "pdfnoodle_api_YOUR_KEY");
var body = new { html = "<html><body><h1>Hello World</h1></body></html>" };
var json = new StringContent(JsonSerializer.Serialize(body), Encoding.UTF8, "application/json");
var resp = await http.PostAsync("https://api.pdfnoodle.com/v1/html-to-pdf/sync", json);
resp.EnsureSuccessStatusCode();
using var doc = JsonDocument.Parse(await resp.Content.ReadAsStringAsync());
var pdfBytes = await http.GetByteArrayAsync(doc.RootElement.GetProperty("signedUrl").GetString());
File.WriteAllBytes("output.pdf", pdfBytes);
}
}
// REST API — no .NET SDK on NuGet. Integration is HttpClient + JSON POST.
using System.IO;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;
using System.Text.Json;
using System.Threading.Tasks;
class Program
{
static async Task Main()
{
using var http = new HttpClient();
http.DefaultRequestHeaders.Authorization =
new AuthenticationHeaderValue("Bearer", "pdfnoodle_api_YOUR_KEY");
var body = new { html = "<html><body><h1>Hello World</h1></body></html>" };
var json = new StringContent(JsonSerializer.Serialize(body), Encoding.UTF8, "application/json");
var resp = await http.PostAsync("https://api.pdfnoodle.com/v1/html-to-pdf/sync", json);
resp.EnsureSuccessStatusCode();
using var doc = JsonDocument.Parse(await resp.Content.ReadAsStringAsync());
var pdfBytes = await http.GetByteArrayAsync(doc.RootElement.GetProperty("signedUrl").GetString());
File.WriteAllBytes("output.pdf", pdfBytes);
}
}
Imports System.IO
Imports System.Net.Http
Imports System.Net.Http.Headers
Imports System.Text
Imports System.Text.Json
Imports System.Threading.Tasks
Module Program
Async Function Main() As Task
Using http As New HttpClient()
http.DefaultRequestHeaders.Authorization = New AuthenticationHeaderValue("Bearer", "pdfnoodle_api_YOUR_KEY")
Dim body = New With {.html = "<html><body><h1>Hello World</h1></body></html>"}
Dim json As New StringContent(JsonSerializer.Serialize(body), Encoding.UTF8, "application/json")
Dim resp = Await http.PostAsync("https://api.pdfnoodle.com/v1/html-to-pdf/sync", json)
resp.EnsureSuccessStatusCode()
Using doc = JsonDocument.Parse(Await resp.Content.ReadAsStringAsync())
Dim pdfBytes = Await http.GetByteArrayAsync(doc.RootElement.GetProperty("signedUrl").GetString())
File.WriteAllBytes("output.pdf", pdfBytes)
End Using
End Using
End Function
End Module
Sonrası (IronPDF):
// NuGet: Install-Package IronPdf
using IronPdf;
class Program
{
static void Main()
{
var renderer = new ChromePdfRenderer();
var html = "<html><body><h1>Hello World</h1></body></html>";
var pdf = renderer.RenderHtmlAsPdf(html);
pdf.SaveAs("output.pdf");
}
}
// NuGet: Install-Package IronPdf
using IronPdf;
class Program
{
static void Main()
{
var renderer = new ChromePdfRenderer();
var html = "<html><body><h1>Hello World</h1></body></html>";
var pdf = renderer.RenderHtmlAsPdf(html);
pdf.SaveAs("output.pdf");
}
}
Imports IronPdf
Class Program
Shared Sub Main()
Dim renderer = New ChromePdfRenderer()
Dim html = "<html><body><h1>Hello World</h1></body></html>"
Dim pdf = renderer.RenderHtmlAsPdf(html)
pdf.SaveAs("output.pdf")
End Sub
End Class
Buradaki temel fark işleme modeli ve dönüş türüdür. pdforge, imzalanmış bir S3 URL'si içeren bir JSON zarfı döndüren https://api.pdfnoodle.com/v1/html-to-pdf/sync için kimlik doğrulamalı bir HttpClient POST'u gerektirir — ardından bu URL'den PDF baytlarını alır ve File.WriteAllBytes() ile kaydedersiniz.
IronPDF, PdfDocument nesnesi döndüren ChromePdfRenderer ile RenderHtmlAsPdf() kullanır. Bu nesne doğrudan SaveAs() ile kaydedilebilir veya ham baytları erişmeniz gerekiyorsa pdf.BinaryData erişebilirsiniz. PdfDocument kaydetmeden önce (filigran ekleme, diğer PDF'lerle birleştirme, güvenlik ekleme) manipülasyona da izin verir. Kapsamlı örnekler için HTML'den PDF'e dönüşüm belgelerine bakın.
Örnek 2: URL'den PDF'ye Dönüştürme
Öncesi (pdforge):
// REST API — no .NET SDK on NuGet. pdforge has no dedicated URL endpoint;
// fetch the page yourself and POST its HTML to /v1/html-to-pdf/sync.
using System.IO;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;
using System.Text.Json;
using System.Threading.Tasks;
class Program
{
static async Task Main()
{
using var http = new HttpClient();
http.DefaultRequestHeaders.Authorization =
new AuthenticationHeaderValue("Bearer", "pdfnoodle_api_YOUR_KEY");
var sourceHtml = await http.GetStringAsync("https://example.com");
var body = new { html = sourceHtml };
var json = new StringContent(JsonSerializer.Serialize(body), Encoding.UTF8, "application/json");
var resp = await http.PostAsync("https://api.pdfnoodle.com/v1/html-to-pdf/sync", json);
resp.EnsureSuccessStatusCode();
using var doc = JsonDocument.Parse(await resp.Content.ReadAsStringAsync());
var pdfBytes = await http.GetByteArrayAsync(doc.RootElement.GetProperty("signedUrl").GetString());
File.WriteAllBytes("webpage.pdf", pdfBytes);
}
}
// REST API — no .NET SDK on NuGet. pdforge has no dedicated URL endpoint;
// fetch the page yourself and POST its HTML to /v1/html-to-pdf/sync.
using System.IO;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;
using System.Text.Json;
using System.Threading.Tasks;
class Program
{
static async Task Main()
{
using var http = new HttpClient();
http.DefaultRequestHeaders.Authorization =
new AuthenticationHeaderValue("Bearer", "pdfnoodle_api_YOUR_KEY");
var sourceHtml = await http.GetStringAsync("https://example.com");
var body = new { html = sourceHtml };
var json = new StringContent(JsonSerializer.Serialize(body), Encoding.UTF8, "application/json");
var resp = await http.PostAsync("https://api.pdfnoodle.com/v1/html-to-pdf/sync", json);
resp.EnsureSuccessStatusCode();
using var doc = JsonDocument.Parse(await resp.Content.ReadAsStringAsync());
var pdfBytes = await http.GetByteArrayAsync(doc.RootElement.GetProperty("signedUrl").GetString());
File.WriteAllBytes("webpage.pdf", pdfBytes);
}
}
Imports System.IO
Imports System.Net.Http
Imports System.Net.Http.Headers
Imports System.Text
Imports System.Text.Json
Imports System.Threading.Tasks
Module Program
Async Function Main() As Task
Using http As New HttpClient()
http.DefaultRequestHeaders.Authorization = New AuthenticationHeaderValue("Bearer", "pdfnoodle_api_YOUR_KEY")
Dim sourceHtml As String = Await http.GetStringAsync("https://example.com")
Dim body = New With {Key .html = sourceHtml}
Dim json As New StringContent(JsonSerializer.Serialize(body), Encoding.UTF8, "application/json")
Dim resp As HttpResponseMessage = Await http.PostAsync("https://api.pdfnoodle.com/v1/html-to-pdf/sync", json)
resp.EnsureSuccessStatusCode()
Using doc As JsonDocument = JsonDocument.Parse(Await resp.Content.ReadAsStringAsync())
Dim pdfBytes As Byte() = Await http.GetByteArrayAsync(doc.RootElement.GetProperty("signedUrl").GetString())
File.WriteAllBytes("webpage.pdf", pdfBytes)
End Using
End Using
End Function
End Module
Sonrası (IronPDF):
// NuGet: Install-Package IronPdf
using IronPdf;
class Program
{
static void Main()
{
var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderUrlAsPdf("https://example.com");
pdf.SaveAs("webpage.pdf");
}
}
// NuGet: Install-Package IronPdf
using IronPdf;
class Program
{
static void Main()
{
var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderUrlAsPdf("https://example.com");
pdf.SaveAs("webpage.pdf");
}
}
Imports IronPdf
Class Program
Shared Sub Main()
Dim renderer = New ChromePdfRenderer()
Dim pdf = renderer.RenderUrlAsPdf("https://example.com")
pdf.SaveAs("webpage.pdf")
End Sub
End Class
pdforge, URL'den PDF'ye özel uç noktaya sahip değildir — sayfayı kendiniz alıp, ardından HTML'ini eşlemeli uç noktaya göndererek ve döndürülen imzalı URL'den sonucu indirirsiniz. IronPDF, @ChromePdfRenderer üzerinde RenderUrlAsPdf() kullanır ve yerleşik SaveAs() metoduyla @PdfDocument döndürür.
IronPDF ile ana avantaj, URL'nin yerel olarak Chromium motoru kullanılarak alınması ve render edilmesi, veri dış sunuculara gönderilmemesidir. Yerel bir kütüphane olan IronPDF, web isteklerinde gidiş-dönüş süresi olmadığı için daha iyi performans sunabilir. URL'den PDF'ye dönüşüm hakkında daha fazla bilgi edinin.
Örnek 3: Özel Ayarlarla HTML Dosyası'nı PDF'e Dönüşüm
Öncesi (pdforge):
// REST API — no .NET SDK on NuGet. Page size / orientation flow through the
// optional `pdfParams` object using Chromium/Puppeteer-style names.
using System.IO;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;
using System.Text.Json;
using System.Threading.Tasks;
class Program
{
static async Task Main()
{
using var http = new HttpClient();
http.DefaultRequestHeaders.Authorization =
new AuthenticationHeaderValue("Bearer", "pdfnoodle_api_YOUR_KEY");
var htmlContent = File.ReadAllText("input.html");
var body = new { html = htmlContent, pdfParams = new { format = "A4", landscape = true } };
var json = new StringContent(JsonSerializer.Serialize(body), Encoding.UTF8, "application/json");
var resp = await http.PostAsync("https://api.pdfnoodle.com/v1/html-to-pdf/sync", json);
resp.EnsureSuccessStatusCode();
using var doc = JsonDocument.Parse(await resp.Content.ReadAsStringAsync());
var pdfBytes = await http.GetByteArrayAsync(doc.RootElement.GetProperty("signedUrl").GetString());
File.WriteAllBytes("output.pdf", pdfBytes);
}
}
// REST API — no .NET SDK on NuGet. Page size / orientation flow through the
// optional `pdfParams` object using Chromium/Puppeteer-style names.
using System.IO;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;
using System.Text.Json;
using System.Threading.Tasks;
class Program
{
static async Task Main()
{
using var http = new HttpClient();
http.DefaultRequestHeaders.Authorization =
new AuthenticationHeaderValue("Bearer", "pdfnoodle_api_YOUR_KEY");
var htmlContent = File.ReadAllText("input.html");
var body = new { html = htmlContent, pdfParams = new { format = "A4", landscape = true } };
var json = new StringContent(JsonSerializer.Serialize(body), Encoding.UTF8, "application/json");
var resp = await http.PostAsync("https://api.pdfnoodle.com/v1/html-to-pdf/sync", json);
resp.EnsureSuccessStatusCode();
using var doc = JsonDocument.Parse(await resp.Content.ReadAsStringAsync());
var pdfBytes = await http.GetByteArrayAsync(doc.RootElement.GetProperty("signedUrl").GetString());
File.WriteAllBytes("output.pdf", pdfBytes);
}
}
Imports System.IO
Imports System.Net.Http
Imports System.Net.Http.Headers
Imports System.Text
Imports System.Text.Json
Imports System.Threading.Tasks
Module Program
Async Function Main() As Task
Using http As New HttpClient()
http.DefaultRequestHeaders.Authorization = New AuthenticationHeaderValue("Bearer", "pdfnoodle_api_YOUR_KEY")
Dim htmlContent As String = File.ReadAllText("input.html")
Dim body = New With {
.html = htmlContent,
.pdfParams = New With {
.format = "A4",
.landscape = True
}
}
Dim json As New StringContent(JsonSerializer.Serialize(body), Encoding.UTF8, "application/json")
Dim resp As HttpResponseMessage = Await http.PostAsync("https://api.pdfnoodle.com/v1/html-to-pdf/sync", json)
resp.EnsureSuccessStatusCode()
Using doc As JsonDocument = JsonDocument.Parse(Await resp.Content.ReadAsStringAsync())
Dim pdfBytes As Byte() = Await http.GetByteArrayAsync(doc.RootElement.GetProperty("signedUrl").GetString())
File.WriteAllBytes("output.pdf", pdfBytes)
End Using
End Using
End Function
End Module
Sonrası (IronPDF):
// NuGet: Install-Package IronPdf
using IronPdf;
using IronPdf.Rendering;
class Program
{
static void Main()
{
var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.PaperSize = PdfPaperSize.A4;
renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Landscape;
var htmlContent = System.IO.File.ReadAllText("input.html");
var pdf = renderer.RenderHtmlAsPdf(htmlContent);
pdf.SaveAs("output.pdf");
}
}
// NuGet: Install-Package IronPdf
using IronPdf;
using IronPdf.Rendering;
class Program
{
static void Main()
{
var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.PaperSize = PdfPaperSize.A4;
renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Landscape;
var htmlContent = System.IO.File.ReadAllText("input.html");
var pdf = renderer.RenderHtmlAsPdf(htmlContent);
pdf.SaveAs("output.pdf");
}
}
Imports IronPdf
Imports IronPdf.Rendering
Class Program
Shared Sub Main()
Dim renderer = New ChromePdfRenderer()
renderer.RenderingOptions.PaperSize = PdfPaperSize.A4
renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Landscape
Dim htmlContent = System.IO.File.ReadAllText("input.html")
Dim pdf = renderer.RenderHtmlAsPdf(htmlContent)
pdf.SaveAs("output.pdf")
End Sub
End Class
Bu örnek, yapılandırma deseni farkını gösterir. pdforge, Chromium/Puppeteer adlandırma kurallarına uyarak POST gövdesi içindeki bir pdfParams nesnesi içindeki JSON alanları olarak seçenekler geçer (format = "A4", landscape = true).
IronPDF, RenderingOptions özelliği ile güçlü türde enums kullanır: renderer.RenderingOptions.PaperSize = PdfPaperSize.A4 ve renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Landscape. Bu, IntelliSense desteği ve derleme zamanı tür güvenliği sağlar. IronPDF'in kâğıt boyutu ve yön enums'ları için IronPdf.Rendering isim alanını dahil etmeyi gerektirdiğini unutmayın. Daha fazla yapılandırma örneği için tutorials sayfasına bakın.
Kritik Taşıma Notları
Dönüş Türü Değişikliği
pdforge, imzalanmış bir URL içeren JSON bir zarf döndürür;IronPDFPdfDocument döndürür:
// pdforge: Two-step — parse signedUrl from JSON, then fetch bytes from it
var resp = await http.PostAsync("https://api.pdfnoodle.com/v1/html-to-pdf/sync", json);
using var doc = JsonDocument.Parse(await resp.Content.ReadAsStringAsync());
var pdfBytes = await http.GetByteArrayAsync(doc.RootElement.GetProperty("signedUrl").GetString());
File.WriteAllBytes("output.pdf", pdfBytes);
// IronPDF: Returns PdfDocument
var pdf = renderer.RenderHtmlAsPdf(html);
pdf.SaveAs("output.pdf"); // Direct save
byte[] bytes = pdf.BinaryData; // Get bytes if needed
// pdforge: Two-step — parse signedUrl from JSON, then fetch bytes from it
var resp = await http.PostAsync("https://api.pdfnoodle.com/v1/html-to-pdf/sync", json);
using var doc = JsonDocument.Parse(await resp.Content.ReadAsStringAsync());
var pdfBytes = await http.GetByteArrayAsync(doc.RootElement.GetProperty("signedUrl").GetString());
File.WriteAllBytes("output.pdf", pdfBytes);
// IronPDF: Returns PdfDocument
var pdf = renderer.RenderHtmlAsPdf(html);
pdf.SaveAs("output.pdf"); // Direct save
byte[] bytes = pdf.BinaryData; // Get bytes if needed
Imports System.IO
Imports System.Net.Http
Imports System.Text.Json
Imports IronPdf
' pdforge: Two-step — parse signedUrl from JSON, then fetch bytes from it
Dim resp = Await http.PostAsync("https://api.pdfnoodle.com/v1/html-to-pdf/sync", json)
Using doc As JsonDocument = JsonDocument.Parse(Await resp.Content.ReadAsStringAsync())
Dim pdfBytes = Await http.GetByteArrayAsync(doc.RootElement.GetProperty("signedUrl").GetString())
File.WriteAllBytes("output.pdf", pdfBytes)
End Using
' IronPDF: Returns PdfDocument
Dim pdf = renderer.RenderHtmlAsPdf(html)
pdf.SaveAs("output.pdf") ' Direct save
Dim bytes As Byte() = pdf.BinaryData ' Get bytes if needed
Üretici Değişikliği
// pdforge: HttpClient against the REST endpoint
using var http = new HttpClient();
http.DefaultRequestHeaders.Authorization =
new AuthenticationHeaderValue("Bearer", "pdfnoodle_api_YOUR_KEY");
// IronPDF: ChromePdfRenderer
var renderer = new ChromePdfRenderer();
// pdforge: HttpClient against the REST endpoint
using var http = new HttpClient();
http.DefaultRequestHeaders.Authorization =
new AuthenticationHeaderValue("Bearer", "pdfnoodle_api_YOUR_KEY");
// IronPDF: ChromePdfRenderer
var renderer = new ChromePdfRenderer();
' pdforge: HttpClient against the REST endpoint
Using http As New HttpClient()
http.DefaultRequestHeaders.Authorization = New AuthenticationHeaderValue("Bearer", "pdfnoodle_api_YOUR_KEY")
' IronPDF: ChromePdfRenderer
Dim renderer As New ChromePdfRenderer()
End Using
Operasyon Değişiklikleri
// pdforge operations
await http.PostAsync("https://api.pdfnoodle.com/v1/html-to-pdf/sync", json); // HTML to PDF
// URL to PDF: fetch the page first, then POST its HTML to the same endpoint
//IronPDF methods
renderer.RenderHtmlAsPdf(html)
renderer.RenderUrlAsPdf(url)
// pdforge operations
await http.PostAsync("https://api.pdfnoodle.com/v1/html-to-pdf/sync", json); // HTML to PDF
// URL to PDF: fetch the page first, then POST its HTML to the same endpoint
//IronPDF methods
renderer.RenderHtmlAsPdf(html)
renderer.RenderUrlAsPdf(url)
' pdforge operations
Await http.PostAsync("https://api.pdfnoodle.com/v1/html-to-pdf/sync", json) ' HTML to PDF
' URL to PDF: fetch the page first, then POST its HTML to the same endpoint
' IronPDF methods
renderer.RenderHtmlAsPdf(html)
renderer.RenderUrlAsPdf(url)
Kaydetme Yöntemi Değişikliği
// pdforge: Two-step — fetch bytes from signed URL, then write to disk
var pdfBytes = await http.GetByteArrayAsync(signedUrl);
File.WriteAllBytes("output.pdf", pdfBytes);
// IronPDF: Built-in save method
pdf.SaveAs("output.pdf");
// pdforge: Two-step — fetch bytes from signed URL, then write to disk
var pdfBytes = await http.GetByteArrayAsync(signedUrl);
File.WriteAllBytes("output.pdf", pdfBytes);
// IronPDF: Built-in save method
pdf.SaveAs("output.pdf");
' pdforge: Two-step — fetch bytes from signed URL, then write to disk
Dim pdfBytes = Await http.GetByteArrayAsync(signedUrl)
File.WriteAllBytes("output.pdf", pdfBytes)
' IronPDF: Built-in save method
pdf.SaveAs("output.pdf")
Yapılandırma Yer Değişikliği
pdforge, pdfParams üzerindeki JSON alanları olarak seçenekler geçer;IronPDF RenderingOptions kullanır:
// pdforge: JSON pdfParams object on the POST body
var body = new { html, pdfParams = new { format = "A4", landscape = true } };
// IronPDF: Properties on RenderingOptions
renderer.RenderingOptions.PaperSize = PdfPaperSize.A4;
renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Landscape;
// pdforge: JSON pdfParams object on the POST body
var body = new { html, pdfParams = new { format = "A4", landscape = true } };
// IronPDF: Properties on RenderingOptions
renderer.RenderingOptions.PaperSize = PdfPaperSize.A4;
renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Landscape;
' pdforge: JSON pdfParams object on the POST body
Dim body = New With {Key .html = html, Key .pdfParams = New With {Key .format = "A4", Key .landscape = True}}
' IronPDF: Properties on RenderingOptions
renderer.RenderingOptions.PaperSize = PdfPaperSize.A4
renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Landscape
Başlık/Altbilgi Yer Tutucu Söz Dizimi
pdforge, Chromium'un başlık/altbilgi şablon formatını miras alır — motorun render zamanında yerine koyduğu <span class="..."></span> elemanları içeren HTML parçalarını miras alır. IronPDF, TextHeaderFooter / HtmlHeaderFooter içinde parantez içine alınmış yer tutucuları kullanır:
// pdforge: Chromium template HTML inside pdfParams.footerTemplate
// "<div>Page <span class=\"pageNumber\"></span> of <span class=\"totalPages\"></span></div>"
//IronPDF placeholders
"Page {page} of {total-pages}" // Note: hyphen in total-pages
// pdforge: Chromium template HTML inside pdfParams.footerTemplate
// "<div>Page <span class=\"pageNumber\"></span> of <span class=\"totalPages\"></span></div>"
//IronPDF placeholders
"Page {page} of {total-pages}" // Note: hyphen in total-pages
' pdforge: Chromium template HTML inside pdfParams.footerTemplate
' "<div>Page <span class=""pageNumber""></span> of <span class=""totalPages""></span></div>"
' IronPDF placeholders
"Page {page} of {total-pages}" ' Note: hyphen in total-pages
Geçiş Sonrası Yeni Özellikler
IronPDF'ye geçtikten sonra pdforge'un sağlayamayacağı yetenekler kazanırsınız:
PDF Birleştirme
var pdf1 = PdfDocument.FromFile("document1.pdf");
var pdf2 = PdfDocument.FromFile("document2.pdf");
var merged = PdfDocument.Merge(pdf1, pdf2);
merged.SaveAs("merged.pdf");
var pdf1 = PdfDocument.FromFile("document1.pdf");
var pdf2 = PdfDocument.FromFile("document2.pdf");
var merged = PdfDocument.Merge(pdf1, pdf2);
merged.SaveAs("merged.pdf");
Dim pdf1 = PdfDocument.FromFile("document1.pdf")
Dim pdf2 = PdfDocument.FromFile("document2.pdf")
Dim merged = PdfDocument.Merge(pdf1, pdf2)
merged.SaveAs("merged.pdf")
Metin Çıkarma
var pdf = PdfDocument.FromFile("document.pdf");
string allText = pdf.ExtractAllText();
var pdf = PdfDocument.FromFile("document.pdf");
string allText = pdf.ExtractAllText();
Dim pdf = PdfDocument.FromFile("document.pdf")
Dim allText As String = pdf.ExtractAllText()
Filigranlar
pdf.ApplyWatermark("<h2 style='color:red;'>CONFIDENTIAL</h2>");
pdf.ApplyWatermark("<h2 style='color:red;'>CONFIDENTIAL</h2>");
pdf.ApplyWatermark("<h2 style='color:red;'>CONFIDENTIAL</h2>")
Şifre Koruma
pdf.SecuritySettings.UserPassword = "userpassword";
pdf.SecuritySettings.OwnerPassword = "ownerpassword";
pdf.SecuritySettings.UserPassword = "userpassword";
pdf.SecuritySettings.OwnerPassword = "ownerpassword";
pdf.SecuritySettings.UserPassword = "userpassword"
pdf.SecuritySettings.OwnerPassword = "ownerpassword"
Özellik Karşılaştırması Özeti
| Özellik | pdforge | IronPDF |
|---|---|---|
| HTML'den PDF'ye | ✓ | ✓ |
| URL'yi PDF'ye çevir | ✓ | ✓ |
| Sayfa Ayarları | ✓ | ✓ |
| Çevrimdışı Yeteneği | ✗ | ✓ |
| Yerel İşleme | ✗ | ✓ |
| PDF'leri birleştir | ✗ | ✓ |
| PDF Ayırma | ✗ | ✓ |
| Metin Çıkarma | ✗ | ✓ |
| Filigranlar | ✗ | ✓ |
| Form Doldurma | ✗ | ✓ |
| Dijital İmzalar | ✗ | ✓ |
| Şifre Koruması | ✗ | ✓ |
| Hız Sınırı Yok | ✗ | ✓ |
| Tek Seferlik Lisans | ✗ | ✓ |
Geçiş Kontrol Listesi
Öncesi-Geçiş
- Kod tabanında tüm pdforge / pdf noodle uç nokta çağrıları envanteri (
api.pdforge.com,api.pdfnoodle.com) - Kullanılan mevcut
pdfParamsJSON yapılandırmasını belgeleyin (sayfa boyutu, yön, kenar boşlukları) -IronPDF yer tutucularına ({page},{total-pages}) dönüştürülecek Chromium tarzı başlık/altbilgi şablonlarını tanımlayın (<span class="pageNumber">,<span class="totalPages">) -IronPDF lisans anahtarı saklama planı yapın (ortam değişkenleri önerilir) - İlk önce IronPDF deneme lisansı ile test edin
Paket Değişiklikleri
- pdforge için NuGet üzerinde .NET SDK'sı yoktur — kaldırılacak rakip paket yoktur
IronPdfNuGet paketini yükleyin:dotnet add package IronPdf
Kod Değişiklikleri
- pdforge çağrıları için kullanılan
System.Net.Http/System.Text.Jsonithalatlarını kaldırın - Kağıt boyutu ve yön enums'ları için
using IronPdf;veusing IronPdf.Rendering;ekleyin - Kimlik doğrulamalı
HttpClient'iChromePdfRendererile değiştirin POST /v1/html-to-pdf/sync'iRenderHtmlAsPdf()ile değiştirin- URL'yi al-POST et kalıbını
RenderUrlAsPdf()ile değiştirin - İki adımlı
GetByteArrayAsync(signedUrl)+File.WriteAllBytes()'ıpdf.SaveAs()ile değiştirin pdfParams.format'iRenderingOptions.PaperSize'a taşıyınpdfParams.landscape'iRenderingOptions.PaperOrientation'a taşıyınPdfPaperSize.A4/PdfPaperOrientation.Landscapeenums'larını kullanınTextHeaderFooter/HtmlHeaderFooteriçinde Chromium şablonlarınıIronPDF yer tutucularına dönüştürün- @
Bearerbelirtecini, başlangıçta tek seferlikIronPdf.License.LicenseKeyile değiştirin
Geçiş Sonrası
- PDF çıktısının kalitesinin beklentilere uyduğunu test edin
- Çevrimdışı operasyonların çalıştığını doğrulayın
- Konfigürasyondan API kimlik bilgilerini kaldırın
- Yeni yetenekler ekleyin (birleştirme, filigranlar, güvenlik) gerektiğinde

