ASP.NET MVC Görünümünü Nasıl PDF'ye Dönüştürürüz
PDFsharp'tan IronPDF'e geçmek, PDF oluşturma iş akışınızı manuel koordinat tabanlı çizimden modern HTML/CSS şablonlamasına dönüştürür. Bu rehber, GDI+ stil konumlandırmayı web teknolojileri ile değiştiren adım adım bir geçiş yolu sunar, geliştirme süresini azaltır ve PDF oluşturma işlemini standart HTML/CSS becerileriyle sürdürülebilir hale getirir.
PDFsharp'tan IronPDF'e Neden Geçmeli?
PDFsharp'ı Anlamak
PDFsharp, geliştiricilere programlı olarak PDF belgeleri oluşturma imkanı veren düşük seviyeli bir PDF oluşturma kütüphanesidir. MIT lisansı altında piyasaya sürülen ve PDFsharp-Team (orijinal olarak empira Software GmbH) tarafından sürdürülenPDFsharp6.x, .NET 8/9/10 ve .NET Standard 2.0'ı hedefler ve Core yapısı üzerinden Windows, Linux ve macOS'ta çapraz platformda çalışır. PDFsharp, esas olarak çizim ve sıfırdan PDF derleme için araç olarak işlev görür ve bu, projenin doğasına bağlı olarak hem yararlı hem de kısıtlayıcı olabilir.
PDFsharp bazen yanlışlıkla bir HTML-to-PDF dönüştürücüsü olarak kabul edilir ki bu doğru değildir. Amacı yalnızca programlı PDF doküman oluşturma üzerinedir. ArthurHub tarafından sağlanan HtmlRenderer.PdfSharp adlı bir topluluk eklentisi, HTML işleme yetenekleri sağlamak için tasarlanmıştır ancak yalnızca HTML 4.01 / CSS seviye 2'yi kapsar — modern CSS özellikleri, flexbox, grid veya JavaScript gibi özellikler yoktur.
Koordinat Hesaplama Sorunu
PDFsharp'ın GDI+ yaklaşımı, şunları yapmanız gerektiği anlamına gelir:
- Doğru X,Y konumlarını hesaplamanızı gerektirir
- Sayfa taşmaları için içerik yüksekliğini manuel olarak takip etmenizi gerektirir
- Satır kaydırma ve metin ölçümlemeyi kendiniz yapmalısınız
- Hücre hücre kenarlı hesaplamalarla tablolar çizmelisiniz
- Manuel sayfa kırılmaları ile çok sayfalı belgeler yönetmelisiniz
PDFsharp'ın mimarisi, genellikle karmaşık yerleşimler oluşturma konusunda zorluklar yaratan koordinatlar kullanarak konumlandırmanın derinlemesine anlaşılmasını gerektirir.
###PDFsharpvs IronPDF Karşılaştırması
| Özellik | PDFsharp | IronPDF |
|---|---|---|
| Lisans | MIT (Ücretsiz) | Ticari |
| HTML'den PDF'ye Destek | Hayır | Evet (HTML5/CSS3 Desteği) |
| Modern CSS Desteği | Hayır (HTML 4.01 / CSS 2, HtmlRenderer eklentisi ile) | Evet (Tam CSS3) |
| Belge Oluşturma | Koordinat tabanlı çizim | HTML/CSS şablonları |
| Düzen Sistemi | Manuel X,Y konumlandırma | CSS Akışı/Flexbox/Grid |
| Sayfa Kırılmaları | Manuel hesaplama | Otomatik + CSS kontrolü |
| Tablolar | Kağıt hücrelerini ayrı ayrı çizin | HTML <table> |
| Stil | Koda dayalı fontlar/renkler | CSS stil dosyaları |
| Belge API'si | Düşük Seviye (Koordinatlar Gerektirir) | Yüksek Seviye (Basitleştirilmiş API) |
| Güncellemeler | Aktif (6.x hattı) | düzenli |
IronPDF, HTML belgelerinin tam aslına uygun olarak PDF'lere dönüştürülmesi gereken senaryolarda öne çıkar. Bu .NET kütüphanesi, modern web standartlarına uyum sağlamak için HTML5 ve CSS3'ü destekler. Yerel HTML'den PDF'ye dönüştürme yetenekleri, geliştiricilerin mevcut web içeriğinden veya çağdaş web araçları ile tasarlanan şablonlardan yararlanmasını sağlar.
Modern .NET kullanan ekipler için, IronPDF, koordinat hesaplamalarını ortadan kaldıranıft-adjacent yapılar için görselleştirme, işleme, ve baskı kapsamlarını ele alarak, görmek, işlemek ve PDF oluşturmanın ötesine geçen kullanım durumlarını kapsayan bir yaklaşımlar sunar.
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
# RemovePDFsharp(official PDFsharp-Team package IDs; case-sensitive on case-sensitive feeds)
dotnet remove package PDFsharp
# dotnet remove package PDFsharp-WPF # if you used the WPF build
# dotnet remove package PDFsharp-GDI # if you used the GDI build
# dotnet remove package PDFsharp-MigraDoc # if you used MigraDoc on top
# dotnet remove package PdfSharpCore # community .NET Standard port
# Add 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.vb or Startup.vb)
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY"###PDFsharpKullanımını Belirleme
# Find allPDFsharpusages in your codebase
grep -r "PdfSharp\|XGraphics\|XFont\|XBrush\|XPen" --include="*.cs" .
Tam API Referansı
Ad Alanı Değişiklikleri
// Before: PDFsharp
using PdfSharp.Pdf;
using PdfSharp.Drawing;
using PdfSharp.Pdf.IO;
// After: IronPDF
using IronPdf;
using IronPdf.Editing;Imports IronPdf
Imports IronPdf.EditingTemel API Eşlemeleri
| PDFsharp API | IronPDF API |
|---|---|
new PdfDocument() | ChromePdfRenderer.RenderHtmlAsPdf() |
document.AddPage() | Otomatik |
XGraphics.FromPdfPage() | Gerekli değil |
XGraphics.DrawString() | HTML <p>, <h1>, vb. |
XGraphics.DrawImage() | HTML <img> etiketi |
XFont | CSS font-family, font-size |
XBrush, XPen | CSS renkler/kenarlıklar |
document.Save() | pdf.SaveAs() |
PdfReader.Open() | PdfDocument.FromFile() |
Kod Göç Örnekleri
Örnek 1: HTML'den PDF'ye Dönüştürme
Before (PDFsharp):
// NuGet: Install-PackagePDFsharp (official PDFsharp-Team package, MIT)
//PDFsharpdoes NOT support HTML-to-PDF natively. The community add-on
// HtmlRenderer.PdfSharp covers HTML 4.01 / CSS level 2 only (no flexbox, grid, JS).
using PdfSharp.Pdf;
using PdfSharp.Drawing;
using System;
class Program
{
static void Main()
{
//PDFsharpdoes not have built-in HTML'den PDF'ye conversion
// You need to manually parse HTML and render content
PdfDocument document = new PdfDocument();
PdfPage page = document.AddPage();
XGraphics gfx = XGraphics.FromPdfPage(page);
XFont font = new XFont("Arial", 12);
//Yönergetext rendering (no HTML support)
gfx.DrawString("Hello from PDFsharp", font, XBrushes.Black,
new XRect(0, 0, page.Width, page.Height),
XStringFormats.TopLeft);
document.Save("output.pdf");
}
}
Sonrası (IronPDF):
// NuGet: Install-Package IronPdf
using IronPdf;
using System;
class Program
{
static void Main()
{
//IronPDF has native HTML'den PDF'ye rendering
var renderer = new ChromePdfRenderer();
string html = "<h1>Hello from IronPDF</h1><p>Easy HTML'den PDF'ye conversion</p>";
var pdf = renderer.RenderHtmlAsPdf(html);
pdf.SaveAs("output.pdf");
}
}
Bu örnek, iki kütüphane arasındaki en büyük farkı vurgular. PDFsharp, yerleşik HTML'den PDF'ye dönüşüm sağlamaz—PdfDocument manuel oluşturmanız, bir PdfPage eklemeniz, bir XGraphics nesnesi almanız, bir XFont oluşturmanız ve DrawString() ile XRect koordinatlarını kullanmanız gerekir.
IronPDF, ChromePdfRenderer aracılığıyla yerel HTML'den PDF'ye dönüştürme sağlar. RenderHtmlAsPdf() metodu, HTML dizgilerini kabul eder ve dahili olarak bir Chromium motoru kullanarak dönüştürür. IronPDF, HTML5 ve CSS3'te tanımlı tüm stilleri koruyarak, HTML dosyalarını kolayca PDF'ye dönüştürür ve koordinat hesaplamalarına gerek kalmaz. Kapsamlı örnekler için HTML'den PDF'e dönüşüm belgelerine bakın.
Örnek 2: Mevcut PDF'ye Metin/Filigran Ekleme
Before (PDFsharp):
// NuGet: Install-PackagePDFsharp (official PDFsharp-Team package, MIT)
using PdfSharp.Pdf;
using PdfSharp.Pdf.IO;
using PdfSharp.Drawing;
using System;
class Program
{
static void Main()
{
// Open existing PDF
PdfDocument document = PdfReader.Open("existing.pdf", PdfDocumentOpenMode.Modify);
PdfPage page = document.Pages[0];
// Get graphics object
XGraphics gfx = XGraphics.FromPdfPage(page);
// Note: inPDFsharp6.x, XFontStyle was renamed to XFontStyleEx
XFont font = new XFont("Arial", 20, XFontStyleEx.Bold);
// Draw text at specific position
gfx.DrawString("Watermark Text", font, XBrushes.Red,
new XPoint(200, 400));
document.Save("modified.pdf");
}
}
Sonrası (IronPDF):
// NuGet: Install-Package IronPdf
using IronPdf;
using IronPdf.Editing;
using System;
class Program
{
static void Main()
{
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";
// Open existing PDF
var pdf = PdfDocument.FromFile("existing.pdf");
// Add text stamp/watermark
var textStamper = new TextStamper()
{
Text = "Watermark Text",
FontSize = 20,
FontFamily = "Arial",
IsBold = true,
FontColor = IronSoftware.Drawing.Color.Red,
VerticalAlignment = VerticalAlignment.Middle,
HorizontalAlignment = HorizontalAlignment.Center
};
pdf.ApplyStamp(textStamper);
pdf.SaveAs("modified.pdf");
}
}
PDFsharp, PdfReader.Open() ile belirterek PDF'yi açmayı, bir sayfaya erişimi, bir XGraphics nesnesi oluşturmayı, bir XFont ile stil yaratmayı ve kesin X,Y koordinatlarını (200, 400) belirten bir XPoint ile DrawString() kullanmayı gerektirir.
IronPDF, PdfDocument.FromFile(), TextStamper nesnesi ile beyanî özellikler (Text, FontSize, FontFamily, IsBold, FontColor, VerticalAlignment, HorizontalAlignment) ve ApplyStamp() ile bunu basitleştirir. Koordinat hesaplamalarına gerek yok—sadece hizalamayı belirtin ve IronPDF, konumlandırmayı halleder. Dikkat edin ki, damgalama işlevselliği için IronPdf.Editing ad alanı gereklidir.
Örnek 3: Resimlerle PDF Oluşturma
Before (PDFsharp):
// NuGet: Install-PackagePDFsharp (official PDFsharp-Team package, MIT)
using PdfSharp.Pdf;
using PdfSharp.Drawing;
using System;
class Program
{
static void Main()
{
// Create new PDF document
PdfDocument document = new PdfDocument();
PdfPage page = document.AddPage();
XGraphics gfx = XGraphics.FromPdfPage(page);
// Load and draw image
XImage image = XImage.FromFile("image.jpg");
// Calculate size to fit page
double width = 200;
double height = 200;
gfx.DrawImage(image, 50, 50, width, height);
// Add text
XFont font = new XFont("Arial", 16);
gfx.DrawString("Image in PDF", font, XBrushes.Black,
new XPoint(50, 270));
document.Save("output.pdf");
}
}
Sonrası (IronPDF):
// NuGet: Install-Package IronPdf
using IronPdf;
using System;
class Program
{
static void Main()
{
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";
// Create PDF from HTML with image
var renderer = new ChromePdfRenderer();
string html = @"
<h1>Image in PDF</h1>
<img src='image.jpg' style='width:200px; height:200px;' />
<p>Easy image embedding with HTML</p>";
var pdf = renderer.RenderHtmlAsPdf(html);
pdf.SaveAs("output.pdf");
// Alternative: Add image to existing PDF
var existingPdf = new ChromePdfRenderer().RenderHtmlAsPdf("<h1>Document</h1>");
var imageStamper = new IronPdf.Editing.ImageStamper(new Uri("image.jpg"))
{
VerticalAlignment = IronPdf.Editing.VerticalAlignment.Top
};
existingPdf.ApplyStamp(imageStamper);
}
}
PDFsharp, yeni bir PdfDocument oluşturarak, bir PdfPage ekleyerek, XGraphics alarak, bir XImage dosyasından yükleyerek, genişliği ve yüksekliği hesaplayarak, kesin koordinat (50, 50, 200, 200) ile DrawImage() kullanmayı ve ardından metni DrawString() ile ayrı olarak eklemeyi gerektirir.
IronPDF, standart HTML ve bir <img> etiketiyle CSS stilini (style='width:200px; height:200px;') kullanır. Koordinat hesaplamalarına gerek yok—CSS düzeni halleder.IronPDF ayrıca, beyanî hizalama özellikleri ile mevcut PDF'lere görüntü eklemek için ImageStamper sağlar. Daha fazla bilgiyi kılavuzlarımızda öğrenin.
Kritik Taşıma Notları
Paradigma Değişimi: Koordinatlardan HTML/CSS'ye
En önemli değişiklik, koordinat tabanlı çizimden HTML/CSS'ye geçmektir:
// PDFsharp: manual positioning
gfx.DrawString("Invoice", titleFont, XBrushes.Black, new XPoint(50, 50));
gfx.DrawString("Customer: John", bodyFont, XBrushes.Black, new XPoint(50, 80));
// IronPDF: let CSS handle layout
var html = @"
<div style='padding: 50px;'>
<h1>Invoice</h1>
<p>Customer: John</p>
</div>";
var pdf = renderer.RenderHtmlAsPdf(html);Imports PdfSharp.Drawing
Imports IronPdf
' PDFsharp: manual positioning
gfx.DrawString("Invoice", titleFont, XBrushes.Black, New XPoint(50, 50))
gfx.DrawString("Customer: John", bodyFont, XBrushes.Black, New XPoint(50, 80))
' IronPDF: let CSS handle layout
Dim html As String = "
<div style='padding: 50px;'>
<h1>Invoice</h1>
<p>Customer: John</p>
</div>"
Dim pdf = renderer.RenderHtmlAsPdf(html)Yazı Tipi Geçişi
// PDFsharp: XFont objects (PDFsharp 6.x renamed XFontStyle to XFontStyleEx)
var titleFont = new XFont("Arial", 24, XFontStyleEx.Bold);
var bodyFont = new XFont("Times New Roman", 12);
// IronPDF: CSS font properties
var html = @"
<style>
h1 { font-family: Arial, sans-serif; font-size: 24px; font-weight: bold; }
p { font-family: 'Times New Roman', serif; font-size: 12px; }
</style>";' PDFsharp: XFont objects (PDFsharp 6.x renamed XFontStyle to XFontStyleEx)
Dim titleFont As New XFont("Arial", 24, XFontStyleEx.Bold)
Dim bodyFont As New XFont("Times New Roman", 12)
' IronPDF: CSS font properties
Dim html As String = "
<style>
h1 { font-family: Arial, sans-serif; font-size: 24px; font-weight: bold; }
p { font-family: 'Times New Roman', serif; font-size: 12px; }
</style>"Doküman Yükleme Değişikliği
// PDFsharp: PdfReader.Open()
PdfDocument document = PdfReader.Open("existing.pdf", PdfDocumentOpenMode.Modify);
// IronPDF: PdfDocument.FromFile()
var pdf = PdfDocument.FromFile("existing.pdf");Imports PdfSharp.Pdf
Imports PdfSharp.Pdf.IO
Imports IronPdf
' PDFsharp: PdfReader.Open()
Dim document As PdfDocument = PdfReader.Open("existing.pdf", PdfDocumentOpenMode.Modify)
' IronPDF: PdfDocument.FromFile()
Dim pdf As PdfDocument = PdfDocument.FromFile("existing.pdf")Kaydetme Yöntemi Değişikliği
// PDFsharp: document.Save()
document.Save("output.pdf");
// IronPDF: pdf.SaveAs()
pdf.SaveAs("output.pdf");' PDFsharp: document.Save()
document.Save("output.pdf")
' IronPDF: pdf.SaveAs()
pdf.SaveAs("output.pdf")Sayfa Erişimi Değişikliği
// PDFsharp: document.Pages[0]
PdfPage page = document.Pages[0];
// IronPDF:Otomatikpage handling or pdf.Pages[0]
// Pages are created automatically from HTML content
Geçiş Sonrası Yeni Özellikler
IronPDF'e geçiş yaptıktan sonra, PDFsharp'ın sağlayamadığı yetenekler kazanırsınız:
Yerli HTML'den PDF'ye
var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf("<h1>Modern Web Content</h1>");Dim renderer As New ChromePdfRenderer()
Dim pdf = renderer.RenderHtmlAsPdf("<h1>Modern Web Content</h1>")URL'den PDF'e
var pdf = renderer.RenderUrlAsPdf("https://example.com");Dim pdf = renderer.RenderUrlAsPdf("https://example.com")PDF Birleştirme
var pdf1 = PdfDocument.FromFile("document1.pdf");
var pdf2 = PdfDocument.FromFile("document2.pdf");
var merged = PdfDocument.Merge(pdf1, pdf2);Dim pdf1 = PdfDocument.FromFile("document1.pdf")
Dim pdf2 = PdfDocument.FromFile("document2.pdf")
Dim merged = PdfDocument.Merge(pdf1, pdf2)HTML ile Filigranlar
pdf.ApplyWatermark("<h2 style='color:red;'>CONFIDENTIAL</h2>");pdf.ApplyWatermark("<h2 style='color:red;'>CONFIDENTIAL</h2>")Özellik Karşılaştırması Özeti
| Özellik | PDFsharp | IronPDF |
|---|---|---|
| Koordinat tabanlı Çizim | ✓ | ✗ (HTML kullanın) |
| HTML'den PDF'ye | ✗ | ✓ |
| CSS3 Desteği | ✗ | ✓ |
| Flexbox/Izgara Düzeni | ✗ | ✓ |
| Metin Damgalama | Manuel XGrafikler | TextStamper |
| Resim Damgalama | Manuel XImage | ImageStamper |
| PDF'leri birleştir | Yönerge | ✓ |
| URL'yi PDF'ye çevir | ✗ | ✓ |
| Modern Web İşleme | ✗ | Chromium Motoru |
| Otomatik Sayfa Sonları | ✗ | ✓ |
Geçiş Kontrol Listesi
Öncesi-Geçiş
- Kod tabanınızda tümPDFsharpkullanımını tespit edin
- Oluşturulan belge türlerini belirle (raporlar, faturalar, sertifikalar)
- Herhangi bir özel grafik veya çizim işlemini not al -IronPDF lisans anahtarı saklama planı yapın (ortam değişkenleri önerilir)
- İlk önce IronPDF deneme lisansı ile test edin
Paket Değişiklikleri
PDFsharpNuGet paketini kaldırın (resmi PDFsharp-Team paketi)PDFsharp-WPF,PDFsharp-GDIveyaPDFsharp-MigraDockullandıysanız kaldırın- Topluluk .NET Standard taşımasını kullanıyorsanız
PdfSharpCorekaldırın IronPdfNuGet paketini kurun:dotnet add package IronPdf
Kod Değişiklikleri
- Ad alanı içe aktarımlarını güncelleyin (
using PdfSharp.Pdf;→using IronPdf;) - Damgalama işlevselliği için
using IronPdf.Editing;ekleyin - Koordinat tabanlı düzenleri HTML/CSS'ye dönüştür
XFontyerine CSS font özelliklerini kullanınXPenyerine CSS renkleri/kenarlıkları kullanınXGraphics.DrawString()yerine HTML metin öğelerini kullanınXGraphics.DrawImage()yerine HTML<img>etiketlerini kullanınPdfReader.Open()ilePdfDocument.FromFile()değiştirindocument.Save()ilepdf.SaveAs()değiştirin- Tablo çizim kodunu HTML tablolara dönüştür
Geçiş Sonrası
- Oluşturulan PDF'lerin görsel karşılaştırması
- Çok sayfalı belgeleri test et
- Yazı tipi işleme doğrula
- Yeni özellikler ekle (HTML'den PDF'ye, birleştirme, filigranlar) gerektiğinde

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.