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
-
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.
:path=/static-assets/pdf/content-code-examples/get-started/quickstart-3.cs
IronPdf.License.LicenseKey = "YOUR-IRONPDF-LICENSE-KEY";
Imports IronPdf
IronPdf.License.LicenseKey = "YOUR-IRONPDF-LICENSE-KEY"
4. İlk PDF'inizi Oluşturun
Bunu .cs dosyanızın en üstüne ekleyin.
:path=/static-assets/pdf/content-code-examples/get-started/quickstart-4.cs
using IronPdf;
Imports IronPdf
Bir PDF nesnesi oluşturmanın en basit yolu sadece genişlik ve yüksekliği kullanmaktır. Bu PdfDocument yapıcı, özelleştirmeye hazır boş bir PDF oluşturur.
:path=/static-assets/pdf/content-code-examples/get-started/quickstart-5.cs
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öntemi kullanılarak, gömülü Chromium motorunu kullanarak herhangi bir HTML'yi (HTML5 dahil) bir PDF'ye dönüştürebilirsiniz.
:path=/static-assets/pdf/content-code-examples/get-started/quickstart-6.cs
using IronPdf;
IronPdf.ChromePdfRenderer
.StaticRenderHtmlAsPdf("<p>Hello World</p>")
.SaveAs("string-to-pdf.pdf");
Imports IronPdf
IronPdf.ChromePdfRenderer.StaticRenderHtmlAsPdf("<p>Hello World</p>").SaveAs("string-to-pdf.pdf")
Word belgelerini PDF'ye dönüştürün, DocxToPdfRenderer sınıfıyla DOCX dosyalarını özelleştirilebilir PDF'lere doğrudan dönüştürerek .NET uygulamalarına sorunsuz bir şekilde entegre edin.
:path=/static-assets/pdf/content-code-examples/get-started/quickstart-7.cs
using IronPdf;
DocxToPdfRenderer renderer = new DocxToPdfRenderer();
PdfDocument pdf = renderer.RenderDocxAsPdf("Modern-chronological-resume.docx");
pdf.SaveAs("pdfFromDocx.pdf");
Imports IronPdf
Dim renderer As New DocxToPdfRenderer()
Dim 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.
Metin başlıkları veya altbilgileri oluşturmak için TextHeaderFooter örneğini oluşturun, metninizi ekleyin ve bunu PDF'ye bağlayın.
:path=/static-assets/pdf/content-code-examples/get-started/quickstart-8.cs
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")
Metni kolayca düzenlemek için RedactTextOnAllPages kullanarak tüm belge boyunca bir ifadeyi kaldırın.
:path=/static-assets/pdf/content-code-examples/get-started/quickstart-9.cs
using IronPdf;
PdfDocument pdf = PdfDocument.FromFile("novel.pdf");
// Redact 'Alaric' phrase from all pages
pdf.RedactTextOnAllPages("Alaric");
pdf.SaveAs("redacted.pdf");
Imports IronPdf
Dim pdf As PdfDocument = PdfDocument.FromFile("novel.pdf")
' Redact 'Alaric' phrase from all pages
pdf.RedactTextOnAllPages("Alaric")
pdf.SaveAs("redacted.pdf")
Merge yöntemiyle C# içinde iki PDF dosyasını birleştirin. Eski metni yenisiyle değiştirmek için yeni veya içe aktarılan her PdfDocument üzerinde ReplaceTextOnAllPages kullanın.
:path=/static-assets/pdf/content-code-examples/get-started/quickstart-10.cs
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
Dim renderer As New ChromePdfRenderer()
Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>.NET6</h1>")
Dim oldText As String = ".NET6"
Dim 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.

