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.
-
NuGet Paket Yöneticisi ile https://www.nuget.org/packages/IronPdf yükleyin
PM > Install-Package IronPdf -
Bu kod parçasını kopyalayıp çalıştırın.
IronPdf.ChromePdfRenderer .StaticRenderHtmlAsPdf("<p>Hello World</p>") .SaveAs("pixelperfect.pdf"); -
Canlı ortamınızda test etmek için dağıtın
Bugün projenizde IronPDF kullanmaya başlayın ücretsiz deneme ile
IronPDF NuGet kütüphanesine gidin:
- Çözüm Gezgini'nde Referanslar'a sağ tıklayın
- 'NuGet Paketlerini Yönet' > 'Gözat' > IronPdf'i Ara'yı 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 Günlük 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 yapıcısı, ö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")
@@--CODE-1--@ 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")
WORD belgelerini PDF'ye dönüştürme DocxToPdfRenderer sınıfı ile DOCX dosyalarını doğrudan özelleştirilebilir PDF'lere dönüştürerek .NET uygulamalarına sorunsuz entegrasyon sağlayabilirsiniz.
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.
Metin üstbilgileri veya altbilgileri oluşturmak için TextHeaderFooter komutunu kullanın, metninizi ekleyin ve PDF'ye ekleyin.
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")
Tüm belgede bir ifadeyi kaldırmak için RedactTextOnAllPages kullanarak metni kolaylıkla redakte edin.
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")
İki PDF dosyasını C#'ta Merge yöntemiyle birleştirin. Eski metni yenisiyle değiştirmek için yeni veya içe aktarılmış herhangi bir PdfDocument üzerinde @@--CODE-6--@ 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
Uzak PDF oluşturma için IronPdfEngine nasıl kurabilirim?
Uzak 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ılandirin. Bu kurulum, uygulamanızın IronPdfEngine örneğine uzaktan baglanmasına olanak tanir.
Uygulamamla birlikte IronPdfEngine kullanmanın ana faydaları nelerdir?
Uygulamanızla birlikte IronPdfEngine kullanmak, PDF görevlerinin uzaktan yürütülmesini sağlar; özellikle eski sistemlerde ve mobil platformlarda platforma ozgu uyumluluk sorunlarini onler. Ayrica çalıştırma sırasında .NET çalışma zamanına ihtiyaçı azaltır.
IronPdfEngine'i neden doğal PDF kütüphanesi yerine kullanmayi seçebilirim?
IronPdfEngine, performansla ilgili yoğun PDF fonksiyonlarını uzaktan çalıştırmak için tercih edilebilir, farkli işletim sistemleriyle olan uyumluluk sorunlarını azaltir ve HTML'den PDF'ye dönüşümde Chrome'yle ayni render'ı kullanarak performansı artırır.
IronPdfEngine yatay ölçeklemeyi destekliyor mu?
Hayır, IronPdfEngine şu anda yatay ölçeklemeyi desteklemez; bu da PDF dosya ikili dosyalarının sunucu belleğinde nasıl işlendiğinden dolayı birden çok örneğe yük dengelemesi yapılamaz anlamına gelir.
IronPdfEngine farklı işletim sistemlerinde çalışabilir mi?
IronPdfEngine, Docker konteynerleri kullanarak Linux sistemlerinde çalışmak üzere tasarlanmıştır. Ancak, ikili dosyalar platforma ozgudur; bu nedenle işletim sisteminiz için doğru sürümu kullandığınızdan emin olmanız gerekir.
IronPdfEngine kullanara PDF çıktılarım farklıysa ne yapmalıyım?
PDF çıktılarında işletim sistem davranışlarından dolayı ufak farklar olabilir. Farkları en aza indirmek için doğru Docker imajını kullandığınızdan ve renderlemeyi etkileyebilecek herhangi bir issistem ozgü ayarini kontrol ettiğinizden emin olun.
Uygulamamın IronPdfEngine'in doğru sürümünü kullandığından nasıl emin olabilirim?
Uyumlulugu saglamak için, her IronPDF sürümü eslesik bir IronPdfEngine sürümu gerektirir. Farkli sürüm sorunlarini onlemek için her iki bileşeni ayni anda guncellediginizden emin olun.
IronPdfEngine'i Windows üzerinde kullanmanın sınırlamaları nelerdir?
IronPdfEngine'i Windows'ta kullanırken, Docker için Linux Konteynerlerine ihtiyaç olacaktır ve sunucu portunun erişilebilirliğine dikkat edilmelidir. İkili dosyalar platforma özgüdür ve Linux Konteynerlerine geçiş gereklidir.
IronPDF'yi uzak bir IronPdfEngine sunucusuna bağlamak için nasıl yapılandırırım?
Uzak bir sunucu için IronPDF'yi yapılandırmak için, sunucunun IP ve port detaylarını belirterek IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer yöntemini Installation.ConnectToIronPdfHost ile kullanın.
IronPdfEngine'i kullanırken uygulama boyutunu en aza indirmek için hangi paketi kullanımaliyim?
IronPDF'yi IronPdfEngine ile çalıştırmak için sadece gerekli bileşenleri içeren IronPdf.Slim paketini NuGet'ten kullanmalısınız, böylece uygulama boyutu azaltılır.

