IronPDF Hızlı Başlangıç Kılavuzu
IronPDF'yi yükleyin ve ilk PDF'nizi sadece beş dakika içinde oluşturun. Basit API'si ile HTML, DOCX, resimler ve daha fazlasını piksel mükemmelliğinde PDF'lere dönüştürebilirsiniz.
1. Ön Koşullar
- .NET Framework 4.6.2+ VEYA .NET Core 3.1+ VEYA .NET 5+
- Visual C++ Redistributable (Windows için).
2. IronPDF'yi Kurun
Standart IronPDF kurulumu yerel olarak çalışır. Docker/microservices üzerinde dağıtım yapmak istiyorsanız Remote Engine Mode Guide'a göz atın.
-
IronPDF aşağıdaki NuGet Paket Yöneticisi ile yükleyin
PM > Install-Package IronPdf -
Bu kod parçacığını kopyalayın ve çalıştırın.
IronPdf.ChromePdfRenderer .StaticRenderHtmlAsPdf("<p>Hello World</p>") .SaveAs("pixelperfect.pdf"); -
Canlı ortamınızda test için dağıtım yapın
Ücretsiz deneme ile bugün projenizde IronPDF kullanmaya başlayın
IronPDF NuGet kütüphanesine gidin:
- Çözüm Gezgini'nde Referanslar'a sağ tıklayın
- 'NuGet Paketlerini Yönet' > 'Gözat' > IronPDF'yi ara seçeneğini seçin
Install-Package IronPdf
- İndir IronPDF DLL paketi
- İşletim sisteminiz için ZIP dosyasını Çözüm dizininizdeki bir konuma açın
- Visual Studio Çözüm Gezgini'nde 'Bağımlılıklar'a sağ tıklayın
- 'Proje Referansı Ekle' > ZIP'ten çıkarılan tüm DLL'leri dahil etmek için 'Gözat'ı seçin.
Platformlara Özel Kılavuzlar
3. Lisans Anahtarını Uygulayın
IronPDF lisanslarını satın aldığınızda veya 30 Gunluk Deneme sürümüyle başlamayı seçtiğinizde, e-postanıza bir lisans anahtarı gönderilecektir. Anahtarı kopyalayın ve uygulamanızın başına ekleyin.
IronPdf.License.LicenseKey = "YOUR-IRONPDF-LICENSE-KEY";
IronPdf.License.LicenseKey = "YOUR-IRONPDF-LICENSE-KEY";
IronPdf.License.LicenseKey = "YOUR-IRONPDF-LICENSE-KEY"
4. İlk PDF'inizi Oluşturun
Bunu .cs dosyanızın en üstüne ekleyin.
using IronPdf;
using IronPdf;
Imports IronPdf
Bir PDF nesnesi oluşturmanın en basit yolu sadece genişlik ve yüksekliği kullanmaktır. Bu PdfDocument oluşturucu, özelleştirmeye hazır boş bir PDF oluşturur.
using IronPdf;
PdfDocument pdf = new PdfDocument(270, 270);
pdf.SaveAs("blankPage.pdf");
using IronPdf;
PdfDocument pdf = new PdfDocument(270, 270);
pdf.SaveAs("blankPage.pdf");
Imports IronPdf
Dim pdf As New PdfDocument(270, 270)
pdf.SaveAs("blankPage.pdf")
ChromePdfRenderer.RenderHtmlAsPdf yöntemini kullanarak, gömülü Chromium motorunu kullanarak herhangi bir HTML'yi (HTML5 dahil) PDF'ye dönüştürebilirsiniz.
using IronPdf;
IronPdf.ChromePdfRender
.StaticRenderHtmlAsPdf("<p>Hello Word</p>")
.SaveAs("string-to-pdf.pdf");
using IronPdf;
IronPdf.ChromePdfRender
.StaticRenderHtmlAsPdf("<p>Hello Word</p>")
.SaveAs("string-to-pdf.pdf");
Imports IronPdf
IronPdf.ChromePdfRender.StaticRenderHtmlAsPdf("<p>Hello Word</p>").SaveAs("string-to-pdf.pdf")
DocxToPdfRenderer sınıfı ile WORD belgelerini PDF'ye dönüştürün; DOCX dosyalarını doğrudan özelleştirilebilir PDF'lere dönüştürerek .NET uygulamalarına sorunsuz bir şekilde entegre edebilirsiniz.
using IronPdf;
DocxToPdfRenderer renderer = new DocxToPdfRenderer();
PdfDocument pdf = renderer.RenderDocxAsPdf("Modern-chronological-resume.docx");
pdf.SaveAs("pdfFromDocx.pdf");
using IronPdf;
DocxToPdfRenderer renderer = new DocxToPdfRenderer();
PdfDocument pdf = renderer.RenderDocxAsPdf("Modern-chronological-resume.docx");
pdf.SaveAs("pdfFromDocx.pdf");
Imports IronPdf
Private renderer As New DocxToPdfRenderer()
Private pdf As PdfDocument = renderer.RenderDocxAsPdf("Modern-chronological-resume.docx")
pdf.SaveAs("pdfFromDocx.pdf")
5. Daha Gelişmiş Örnekler
IronPDF, basit PDF oluşturma ve dönüştürmenin yanı sıra daha güçlü PDF özelleştirme seçenekleri de sunuyor.
TextHeaderFooter öğesini örneklendirip metninizi ekleyerek ve bunu PDF'ye ekleyerek metin üstbilgileri veya altbilgileri oluşturun.
using IronPdf;
ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Hello World!</h1>");
// Create text header
TextHeaderFooter textHeader = new TextHeaderFooter
{
CenterText = "This is the header!",
};
// Create text footer
TextHeaderFooter textFooter = new TextHeaderFooter
{
CenterText = "This is the footer!",
};
// Add text header and footer to the PDF
pdf.AddTextHeaders(textHeader);
pdf.AddTextFooters(textFooter);
pdf.SaveAs("addTextHeaderFooter.pdf");
using IronPdf;
ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Hello World!</h1>");
// Create text header
TextHeaderFooter textHeader = new TextHeaderFooter
{
CenterText = "This is the header!",
};
// Create text footer
TextHeaderFooter textFooter = new TextHeaderFooter
{
CenterText = "This is the footer!",
};
// Add text header and footer to the PDF
pdf.AddTextHeaders(textHeader);
pdf.AddTextFooters(textFooter);
pdf.SaveAs("addTextHeaderFooter.pdf");
Imports IronPdf
Dim renderer As New ChromePdfRenderer()
Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Hello World!</h1>")
' Create text header
Dim textHeader As New TextHeaderFooter With {
.CenterText = "This is the header!"
}
' Create text footer
Dim textFooter As New TextHeaderFooter With {
.CenterText = "This is the footer!"
}
' Add text header and footer to the PDF
pdf.AddTextHeaders(textHeader)
pdf.AddTextFooters(textFooter)
pdf.SaveAs("addTextHeaderFooter.pdf")
RedactTextOnAllPages kullanarak metni kolayca düzenleyin ve belge genelinde bir cümleyi kaldırın.
using IronPdf;
PdfDocument pdf = PdfDocument.FromFile("novel.pdf");
// Redact 'Alaric' phrase from all pages
pdf.RedactTextOnAllPages("Alaric");
pdf.SaveAs("redacted.pdf");
using IronPdf;
PdfDocument pdf = PdfDocument.FromFile("novel.pdf");
// Redact 'Alaric' phrase from all pages
pdf.RedactTextOnAllPages("Alaric");
pdf.SaveAs("redacted.pdf");
Imports IronPdf
Private pdf As PdfDocument = PdfDocument.FromFile("novel.pdf")
' Redact 'Alaric' phrase from all pages
pdf.RedactTextOnAllPages("Alaric")
pdf.SaveAs("redacted.pdf")
C#'da Merge yöntemini kullanarak iki PDF dosyasını birleştirin. Eski metni yenisiyle değiştirmek için, yeni veya içe aktarılmış tüm PdfDocument öğelerinde ReplaceTextOnAllPages kullanın.
using IronPdf;
ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>.NET6</h1>");
string oldText = ".NET6";
string newText = ".NET7";
// Replace text on all pages
pdf.ReplaceTextOnAllPages(oldText, newText);
pdf.SaveAs("replaceText.pdf");
using IronPdf;
ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>.NET6</h1>");
string oldText = ".NET6";
string newText = ".NET7";
// Replace text on all pages
pdf.ReplaceTextOnAllPages(oldText, newText);
pdf.SaveAs("replaceText.pdf");
Imports IronPdf
Private renderer As New ChromePdfRenderer()
Private pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>.NET6</h1>")
Private oldText As String = ".NET6"
Private newText As String = ".NET7"
' Replace text on all pages
pdf.ReplaceTextOnAllPages(oldText, newText)
pdf.SaveAs("replaceText.pdf")
Hızlı Sorun Giderme
| Sorun | Çözüm |
|---|---|
| Eksik Visual C++ Çalışma Zamanı | Visual C++ Redistributable yükleyin - Chrome motoru için hem x86 hem de x64 sürümleri gereklidir |
| Lisans tanınmıyor | IronPdf.License.IsLicensed özelliği ile doğrulayın. Herhangi bir IronPDF işleminden önce lisansın uygulandığından emin olun |
| Yavaş ilk render | Oluşturma motorlarını önceden başlatmak için başlangıçta IronPdf.Installation.Initialize() öğesini çağırın |
| Linux/Docker bağımlılıkları | Otomatik bağımlılık yüklemesi için Installation.LinuxAndDockerDependenciesAutoConfig = true ayarını yapın |
Sonraki Adımlar
Sıkça Sorulan Sorular
Uzaktan PDF oluşturma için IronPdfEngine'i nasıl kurarım?
Uzaktan PDF oluşturma için IronPdfEngine'i kurmak için, NuGet'ten IronPdf.Slim paketini yükleyin ve IronPdfConnectionConfiguration sınıfını kullanarak bağlantı ayarlarını yapılandırın. Bu kurulum, uygulamanızı uzaktan IronPdfEngine örneğine bağlamanıza izin verir.
Uygulamamla birlikte IronPdfEngine'i kullanmanın ana faydaları nelerdir?
Uygulamanızla IronPdfEngine kullanmak, PDF görevlerini uzaktan yürütmeyi sağlar, özellikle eski sistemler ve mobil platformlarda platforma özgü uyumluluk sorunlarını önler. Ayrıca, yürütme sırasında .NET çalışma zamanı gereksinimini ortadan kaldırır.
Neden yerel PDF kütüphanesi yerine IronPdfEngine kullanmayı tercih edebilirim?
Farklı işletim sistemleriyle uyumluluk sorunlarını azaltmak ve HTML’den PDF’ye dönüşüm için Chrome ile aynı render kapasitesini kullanarak performansı artırmak için IronPdfEngine'i tercih edebilirsiniz.
IronPdfEngine'te yatay ölçeklendirme destekleniyor mu?
Hayır, IronPdfEngine şu anda yatay ölçeklendirmeyi desteklemiyor, bu nedenle sunucu belleğinde PDF dosya ikili dosyalarının işlenme şekli nedeniyle birden fazla örnek arasında yük dengelemesi yapılamaz.
IronPdfEngine farklı işletim sistemlerinde çalışabilir mi?
IronPdfEngine, Docker konteynerlarını kullanarak Linux sistemlerinde çalışacak şekilde tasarlanmıştır. Ancak, ikili dosyalar platforma özgüdür, bu nedenle işletim sisteminiz için doğru versiyonu kullandığınızdan emin olmalısınız.
IronPdfEngine kullandığımda PDF çıktılarım farklı ise ne yapmalıyım?
PDF çıktıları, farklı işletim sistemi davranışlarına bağlı olarak hafifçe değişebilir. Farklılıkları en aza indirmek için doğru Docker görüntüsünü kullandığınızdan emin olun ve render işlemini etkileyebilecek herhangi bir işletim sistemi spesifik ayarı kontrol edin.
Uygulamamın doğru IronPdfEngine versiyonunu kullandığından nasıl emin olabilirim?
Uyumluluğu sağlamak için, her IronPDF versiyonu için uygun IronPdfEngine versiyonu gereklidir. Çapraz versiyon sorunlarını önlemek için her iki bileşeni de eşzamanlı olarak güncellediğinizden emin olun.
Windows üzerinde IronPdfEngine kullanırken hangi sınırlamalarla karşılaşırsınız?
Windows üzerinde IronPdfEngine kullanırken, Docker için Linux Containers gereksinime ihtiyacınız vardır ve sunucu portunun erişilebilir olduğundan emin olmalısınız. İkili dosyalar platforma özgüdür ve Linux Containers'a geçiş gereklidir.
IronPDF'yi uzak IronPdfEngine sunucusuna nasıl bağlayabilirim?
IronPDF’i uzak bir sunucuya bağlamak için Installation.ConnectToIronPdfHost kullanarak, IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer yöntemini kullanın ve sunucu IP ve port detaylarını belirtin.
IronPdfEngine kullanırken uygulama büyüklüğünü nasıl en aza indirebilirim?
Uygulama boyutunu en aza indirmek için, NuGet'ten IronPdf.Slim paketini kullanmalısınız, çünkü bu paket yalnızca IronPDF'i IronPdfEngine ile çalıştırmak için gerekli bileşenleri içerir ve böylece uygulama boyutunu küçültür.

