C# İle Programatik PDF Dosyası Oluşturma

İlerlemeden önce, projemize IronPdf kütüphanesini kurmalıyız. Bunu çeşitli şekillerde yapabiliriz.

Yöntem 1: NuGet Paket Yonetici

NuGet Paket Yöneticisi'nden IronPdf C# Kütüphanesini kurabiliriz. NuGet Paket Yöneticisi'ni Tools > NuGet Package Manager > Manage NuGet Packages for Solution seçeneğine tıklayarak açın. Bu, NuGet Paket Yöneticisi Çözüm Gezgini'ni açacaktır.

NuGet Paket Yöneticisini Açın

"Browse" seçeneğine tıklayın ve arama çubuğuna IronPdf yazın. Aşağıdaki sonuç görünecektir. IronPdf'i seçin ve Yükle butonuna tıklayın; kütüphane yüklenmeye başlayacaktır.

IronPdf paketini arayın ve yükleyin

Yöntem 2: NuGet Paket Yonetici Konsolu

Kütüphanemizi hızla yüklemek için NuGet Paket Yöneticisi Konsolu'nu kullanabiliriz. Yükleme yapmak için herhangi bir yönetici ayrıcalığı gerektirmez. Projenize IronPdf kütüphanesini kurmak için bir NuGet komutu kullanabilirsiniz.

Install-Package IronPdf

IronPdf paketini Komut Satırı ile Yükleyin

Yöntem 3: DLL Dosyasi Kullanarak

Projenizde IronPDF'yi kullanmanın üçüncü yolu, IronPDF kütüphanesinden bir DLL dosyası eklemektir. DLL dosyasını indirebilirsiniz.

• DLL zip dosyasını indirin. Belirli bir klasöre çıkarın.
• Visual Studio'da bir proje açın. Çözüm Gezgini'nde, Referanslar'a sağ tıklayın ve IronPDF DLL dosyasına göz atın.

IronPDF'nin nasıl kurulacağına dair daha ayrıntılı bir kurulum kılavuzu ziyaret edin.

IronPDF kullanarak PDF oluşturmanın birçok yöntemini inceleyeceğiz. Basit işlevleri kullanarak PDF dosyası oluşturmanın ne kadar kolay olduğunu göreceğiz. HTML dizesi kullanarak PDF oluşturmaya başlayalım.

4.1. HTML Dizesi Kullanarak Programatik Olarak PDF Oluşturma

IronPDF kütüphanesinde HTML, stil oluşturma amacıyla kullanılır. IronPDF kütüphanesini kullanarak PDF belgeleri oluşturmak için HTML dili hakkında temel bilgiye sahip olmalısınız.

IronPDF kütüphanesi, HTML dizelerini işlemek ve bunları PDF formatına dönüştürmek için çok kolay hale getirir. Bunu kod ile nasıl yapacağımızı inceleyelim.

using IronPdf;

IronPdf.License.LicenseKey = "YourLicenseKey";

// HTML content to be converted into a PDF
string htmlString = "<h1> Generated PDF File!</h1> <p> This file is generated by IronPDF library from HTML String!</p> <p>It is a great Library to manipulate PDF Files.</p>";

// Create a PDF renderer
var renderer = new ChromePdfRenderer();

// Convert the HTML string to a PDF and save it
renderer.RenderHtmlAsPdf(htmlString).SaveAs("PDF from HTML String.pdf");

using IronPdf;

IronPdf.License.LicenseKey = "YourLicenseKey";

// HTML content to be converted into a PDF
string htmlString = "<h1> Generated PDF File!</h1> <p> This file is generated by IronPDF library from HTML String!</p> <p>It is a great Library to manipulate PDF Files.</p>";

// Create a PDF renderer
var renderer = new ChromePdfRenderer();

// Convert the HTML string to a PDF and save it
renderer.RenderHtmlAsPdf(htmlString).SaveAs("PDF from HTML String.pdf");

Imports IronPdf

IronPdf.License.LicenseKey = "YourLicenseKey"

' HTML content to be converted into a PDF
Dim htmlString As String = "<h1> Generated PDF File!</h1> <p> This file is generated by IronPDF library from HTML String!</p> <p>It is a great Library to manipulate PDF Files.</p>"

' Create a PDF renderer
Dim renderer = New ChromePdfRenderer()

' Convert the HTML string to a PDF and save it
renderer.RenderHtmlAsPdf(htmlString).SaveAs("PDF from HTML String.pdf")

Bu kod, htmlString değişkeninde saklanan içeriği içeren bir PDF dosyası oluşturacaktır. Bu kod örneğinde, RenderHtmlAsPdf işlevi kullanılmıştır. Bu fonksiyon, HTML Dizesini bir PDF belgesine dönüştürme işlemini gerçekleştirir.

IronPDF kütüphanesini kullanarak PDF dosyaları oluşturmak için HTML etiketlerine aşina olmalısınız. SaveAs işlevi, çıktının PDF dosyasını kaydetmek için kullanılır. Aşağıda çıktı PDF dosyasını görebilirsiniz.

Çıktı:

PDF dosyası çıkışı

4.2. HTML Dosyaları Kullanarak Programatik Olarak PDF Oluşturma

IronPDF kutuphanesi, bir HTML dosyasindan PDF dosyasi oluşturmak icin mükemmel bir özellik sunar. IronPDF, HTML dosyalarindaki resimler, CSS, formlar vb. dahil her seyi dogrudan bir PDF belgesine cevirir. Daha fazla işlem icin baska bir kutuphane veya fonksiyona ihtiyaç duymaz. IronPDF her turlu HTML dosyasini dogrudan bir PDF dosyasina cevirir.

HTML dosyasindan PDF dosyasi oluşturmak icin bazi örnek kodlara bakalim:

using IronPdf;

IronPdf.License.LicenseKey = "YourLicenseKey";

// Create a PDF renderer
var renderer = new ChromePdfRenderer();

// Convert an HTML file to a PDF and save it
var pdf = renderer.RenderHtmlFileAsPdf("IronFile.html").SaveAs("IronPDF file.pdf");

using IronPdf;

IronPdf.License.LicenseKey = "YourLicenseKey";

// Create a PDF renderer
var renderer = new ChromePdfRenderer();

// Convert an HTML file to a PDF and save it
var pdf = renderer.RenderHtmlFileAsPdf("IronFile.html").SaveAs("IronPDF file.pdf");

Imports IronPdf

IronPdf.License.LicenseKey = "YourLicenseKey"

' Create a PDF renderer
Dim renderer = New ChromePdfRenderer()

' Convert an HTML file to a PDF and save it
Dim pdf = renderer.RenderHtmlFileAsPdf("IronFile.html").SaveAs("IronPDF file.pdf")

HTML dosyalarından PDF oluşturmak için RenderHtmlFileAsPdf işlevini kullanıyoruz. HTML Dosya konumunu işlev parametresinde verebilir veya HTML dosyasını kaynak kodu bin klasörüne koyabilirsiniz, böylece RenderHtmlFileAsPdf işlevinin parametresine sadece dosya adını uzantısıyla birlikte koymanız yeterli olacaktır. Bu kodu calistirdiginizda cikti PDF dosyasi bin klasorune kaydedilecektir. SaveAs işlevi, oluşturulan PDF dosyalarını kaydetmeye yardımcı olur.

4.3. URL'leri Kullanarak Programatik Olarak PDF Oluşturma

Bazen programimizda programatik olarak bir URL'nin PDF dosyasini oluşturmamiz gerekebilir. Her seyin sifirdan kodlanmasi durumunda bu çok teknik bir gorev olabilir. IronPDF, URL'lerden PDF oluşturmak icin harika bir fonksiyon saglayarak burada bize yardimci olur. Bir PDF oluşturmak icin herhangi bir URL kullanabilirsiniz.

Bunu nasıl yapacagimizi inceleyelim:

using IronPdf;

IronPdf.License.LicenseKey = "YourLicenseKey";

// Create a PDF renderer
var renderer = new ChromePdfRenderer();

// Convert a URL to a PDF and save it
var pdf = renderer.RenderUrlAsPdf("https://ironpdf.com/blog/using-ironpdf/csharp-generate-pdf-tutorial/").SaveAs("IronPDF Generate PDF.pdf");

using IronPdf;

IronPdf.License.LicenseKey = "YourLicenseKey";

// Create a PDF renderer
var renderer = new ChromePdfRenderer();

// Convert a URL to a PDF and save it
var pdf = renderer.RenderUrlAsPdf("https://ironpdf.com/blog/using-ironpdf/csharp-generate-pdf-tutorial/").SaveAs("IronPDF Generate PDF.pdf");

Imports IronPdf

IronPdf.License.LicenseKey = "YourLicenseKey"

' Create a PDF renderer
Dim renderer = New ChromePdfRenderer()

' Convert a URL to a PDF and save it
Dim pdf = renderer.RenderUrlAsPdf("https://ironpdf.com/blog/using-ironpdf/csharp-generate-pdf-tutorial/").SaveAs("IronPDF Generate PDF.pdf")

Yukarıdaki kod, RenderUrlAsPdf işlevine verilen URL parametresinin PDF'ini oluşturacaktır. Bu fonksiyon URL'nin bir PDF'ini oluşturur. Bu, sifirdan yapmaya calissaydiniz çok kompleks bir gorev olabilirdi. IronPDF, her turlu URL'yi bir PDF'e cevirmenin basit bir yolunu geliştiricilere sunar. SaveAs işlevi, çıktıları bin klasörüne kaydetmek için kullanılır. Dosya formatını PDF olarak ayarlamak için, SaveAs işlevinde dosya adı parametresi ile birlikte bir .pdf uzantısı belirtmelisiniz. Proje klasorunuzde bin klasorunu gorebilirsiniz. Cikti asagida görüntülenmektedir.

Çıktı:

URL'den PDF Dosyasi Oluşturma

4.4. ASP.NET Web Formlari kullanarak Programatik Olarak PDF Oluşturma

ASP.NET, HTML'nin islevselligini genişleten ve bir tarayici icinde web geliştirmeyi destekleyen bir sunucu-tarafi programlama cercevesidir. ASP.NET sayfalari HTML, CSS ve JavaScript ile yazilir ve .aspx olarak kodlanabilir. ASP.NET web formlari kullanıcı dostu, islevsel zengin web siteleri, cevrimici bankacilik, intranetler ve muhasebe sistemleri oluşturur.

ASP.NET web formlarini PDF'ye cevirmek icin IronPDF kutuphanesini kullanacagiz. Ilk olarak, bir web sayfasi olarak render edilen bu form, bir web tarayicisinda görüntülemek ve indirmek icin bir PDF'ye dönüştürecegiz. Donusumu tamamlamak icin IronPDF'un AspxToPdf sinifini kullanacagiz.

Bunu nasıl yapacagimizi gorelim:

1. Visual Studio'da bir ASP.NET web form projesti oluşturun. Visual Studio'nun en güncel sürümü önerilir.
2. IronPDF kutuphanesini NuGet Paket Yonetici veya DLL dosyasi kullanarak kurun. Ayrica NuGet Paket Yonetici Konsolu'nu kullanarak da kurabilirsiniz.
3. Simdi, PDF dosyasina dönüştürmek istediginiz herhangi bir ASPX web sayfasinin kodunu acin. Burada projenin Default.aspx sayfasinin PDF'sini oluşturacagiz.

Visual Studio'da Web Form Proje yapisi

4. Default.aspx.cs dosyasını açın. Dosyaya IronPdf ad alanını ekleyin, bu en önemli satırdır.

using IronPdf;

using IronPdf;

Imports IronPdf

5. Sayfanın PDF belgesini oluşturmak icin Page_Load fonksiyonuna asagidaki kod satirini yazin.

AspxToPdf.RenderThisPageAsPdf(AspxToPdf.FileBehavior.InBrowser);

AspxToPdf.RenderThisPageAsPdf(AspxToPdf.FileBehavior.InBrowser);

AspxToPdf.RenderThisPageAsPdf(AspxToPdf.FileBehavior.InBrowser)

Ve işte bu kadar! ASPX web sayfasinin bir PDF dosyasi oluşturuldu. Proje calistiginda, tarayicida web sayfasinin PDF'sini goreceksiniz. Sonuc Ctrl+P'ye basarak PDF yapma sonucu ile aynidir. Burada, ASPX dosyasinin PDF'sini oluşturmak icin Ctrl+P'ye basmaniz gerekmedi.

Bu, sunucu tarafinda yapildi. Bu kodda, IronPDF'un AspxToPdf sinifini kullaniyoruz. RenderThisPageAsPdf işlevi, ASPX web sayfasının PDF'ini oluşturur.

Yukaridaki kod tarayicida PDF dosyasini gösterir. Asagidaki kod satirini Page_Load fonksiyonuna ekleyerek PDF dosyasini dogrudan sistemimize indirebiliriz:

AspxToPdf.RenderThisPageAsPdf(IronPdf.AspxToPdf.FileBehavior.Attachment);

AspxToPdf.RenderThisPageAsPdf(IronPdf.AspxToPdf.FileBehavior.Attachment);

AspxToPdf.RenderThisPageAsPdf(IronPdf.AspxToPdf.FileBehavior.Attachment)

Bu kod ASPX web sayfasinin PDF dosyasini sistemde indirir. ASPX PDF dosyasinin adini da ayarlayabiliriz. Basliklar, altbilgiler, baski seçenekleri, kalite vb. gibi değişiklik ve formatlama icin coklu seçenekler mevcuttur. Ayrintilar icin bu kapsamli ASPX'den PDF'ye donusum rehberine bakin.

Çıktı:

Sunucu-tarafindan PDF dosyasinin ciktisi

Son Microsoft teknolojisini kesfedin Blazor uygulamasi ile PDF dosyalari oluşturmak icin

4.5. Formatlama Ile Programatik Olarak PDF'ler Oluşturma

PDF dosyalari oluştururken, çok fazla sorun genellikle PDF belgelerinin formatlanmasi sirasinda karsilasir. PDF'leri programatik olarak formatlamak kolay degildir. Ancak, simdi IronPDF seklinde bir cozumumuz var. IronPDF, oluşturdugumuz PDF dosyasini ozellestirmemize olanak tanimak icin çeşitli formatlama seçenekleri ile yardimci olur. Basliklar, altbilgiler, kenar bosluklari ve daha bircok formatlama seçenekleri eklememizi saglayan yöntemler sunar.

IronPDF kullanarak sayfa yonlendirmesini, sayfa boyutunu ve basliklarini ayarlamamiza olanak tanir. Ayrica yazi tipi boyutunu, yazi tipi rengini, yazi tipi turunu ve diğer font ile ilgili işlemleri değiştirmeyi destekler. Bolucu cizgi ve ozellestirilmis metin ile altbilgiler ve basliklar ekleyebilirsiniz. IronPDF kullanarak PDF dosyalarini nasıl ozellestirebilecegimize bakalim.

• Bir C# konsol projesi oluşturun. Gereksinimlerinize bagli olarak bir GUI projesi de oluşturabilirsiniz. Mevcut projeleri de acabilirsiniz.
• IronPDF kutuphanesini NuGet Paket Yonetici veya DLL dosyasi kullanarak kurun.
• Kod dosyasinin en ustune IronPDF isim alanini ekleyin.

Uygulamanin kurulumunu tamamladik. Siradaki adimda, PDF dosyasina asagidaki kodu ekleyin:

using IronPdf;

IronPdf.License.LicenseKey = "YourLicenseKey";

// Create a PDF renderer
ChromePdfRenderer renderer = new IronPdf.ChromePdfRenderer();

// Configure rendering options
renderer.RenderingOptions.PaperOrientation = IronPdf.Rendering.PdfPaperOrientation.Portrait;
renderer.RenderingOptions.SetCustomPaperSizeInInches(14, 40);
renderer.RenderingOptions.PrintHtmlBackgrounds = true;
renderer.RenderingOptions.Title = "PDF Generated";
renderer.RenderingOptions.Zoom = 100;

// Margin Settings
renderer.RenderingOptions.MarginTop = 40;  
renderer.RenderingOptions.MarginLeft = 20;  
renderer.RenderingOptions.MarginRight = 20;  
renderer.RenderingOptions.MarginBottom = 40;  

renderer.RenderingOptions.FirstPageNumber = 1; 

// Header Settings
renderer.RenderingOptions.TextHeader.DrawDividerLine = true;
renderer.RenderingOptions.TextHeader.CenterText = "Header!";
renderer.RenderingOptions.TextHeader.Font = IronSoftware.Drawing.FontTypes.Helvetica;

// Footer Settings
renderer.RenderingOptions.TextFooter.DrawDividerLine = true;
renderer.RenderingOptions.TextFooter.Font = IronSoftware.Drawing.FontTypes.Arial;
renderer.RenderingOptions.TextFooter.FontSize = 10;
renderer.RenderingOptions.TextFooter.LeftText = "{date} {time}";
renderer.RenderingOptions.TextFooter.RightText = "{page} of {total-pages}"; 

// HTML content to be converted into a PDF
string htmlStr = "<h1>PDF Formatting!</h1><h3>Functions and properties for formatting </h3> <p>IronPDF is the best ever library for PDF operations and formatting. </p>";

// Convert the HTML string to a PDF and save it
renderer.RenderHtmlAsPdf(htmlStr).SaveAs("PDF-Formatted.pdf");

using IronPdf;

IronPdf.License.LicenseKey = "YourLicenseKey";

// Create a PDF renderer
ChromePdfRenderer renderer = new IronPdf.ChromePdfRenderer();

// Configure rendering options
renderer.RenderingOptions.PaperOrientation = IronPdf.Rendering.PdfPaperOrientation.Portrait;
renderer.RenderingOptions.SetCustomPaperSizeInInches(14, 40);
renderer.RenderingOptions.PrintHtmlBackgrounds = true;
renderer.RenderingOptions.Title = "PDF Generated";
renderer.RenderingOptions.Zoom = 100;

// Margin Settings
renderer.RenderingOptions.MarginTop = 40;  
renderer.RenderingOptions.MarginLeft = 20;  
renderer.RenderingOptions.MarginRight = 20;  
renderer.RenderingOptions.MarginBottom = 40;  

renderer.RenderingOptions.FirstPageNumber = 1; 

// Header Settings
renderer.RenderingOptions.TextHeader.DrawDividerLine = true;
renderer.RenderingOptions.TextHeader.CenterText = "Header!";
renderer.RenderingOptions.TextHeader.Font = IronSoftware.Drawing.FontTypes.Helvetica;

// Footer Settings
renderer.RenderingOptions.TextFooter.DrawDividerLine = true;
renderer.RenderingOptions.TextFooter.Font = IronSoftware.Drawing.FontTypes.Arial;
renderer.RenderingOptions.TextFooter.FontSize = 10;
renderer.RenderingOptions.TextFooter.LeftText = "{date} {time}";
renderer.RenderingOptions.TextFooter.RightText = "{page} of {total-pages}"; 

// HTML content to be converted into a PDF
string htmlStr = "<h1>PDF Formatting!</h1><h3>Functions and properties for formatting </h3> <p>IronPDF is the best ever library for PDF operations and formatting. </p>";

// Convert the HTML string to a PDF and save it
renderer.RenderHtmlAsPdf(htmlStr).SaveAs("PDF-Formatted.pdf");

Imports IronPdf

IronPdf.License.LicenseKey = "YourLicenseKey"

' Create a PDF renderer
Dim renderer As ChromePdfRenderer = New IronPdf.ChromePdfRenderer()

' Configure rendering options
renderer.RenderingOptions.PaperOrientation = IronPdf.Rendering.PdfPaperOrientation.Portrait
renderer.RenderingOptions.SetCustomPaperSizeInInches(14, 40)
renderer.RenderingOptions.PrintHtmlBackgrounds = True
renderer.RenderingOptions.Title = "PDF Generated"
renderer.RenderingOptions.Zoom = 100

' Margin Settings
renderer.RenderingOptions.MarginTop = 40
renderer.RenderingOptions.MarginLeft = 20
renderer.RenderingOptions.MarginRight = 20
renderer.RenderingOptions.MarginBottom = 40

renderer.RenderingOptions.FirstPageNumber = 1

' Header Settings
renderer.RenderingOptions.TextHeader.DrawDividerLine = True
renderer.RenderingOptions.TextHeader.CenterText = "Header!"
renderer.RenderingOptions.TextHeader.Font = IronSoftware.Drawing.FontTypes.Helvetica

' Footer Settings
renderer.RenderingOptions.TextFooter.DrawDividerLine = True
renderer.RenderingOptions.TextFooter.Font = IronSoftware.Drawing.FontTypes.Arial
renderer.RenderingOptions.TextFooter.FontSize = 10
renderer.RenderingOptions.TextFooter.LeftText = "{date} {time}"
renderer.RenderingOptions.TextFooter.RightText = "{page} of {total-pages}"

' HTML content to be converted into a PDF
Dim htmlStr As String = "<h1>PDF Formatting!</h1><h3>Functions and properties for formatting </h3> <p>IronPDF is the best ever library for PDF operations and formatting. </p>"

' Convert the HTML string to a PDF and save it
renderer.RenderHtmlAsPdf(htmlStr).SaveAs("PDF-Formatted.pdf")

Bu kod parcasi PDF dosyalarini formatlamaktadir. RenderingOptions, PDF belgeleri oluştururken farklı özellikleri ayarlamak için birincil araçtır.

• renderer.RenderingOptions.TextHeader
  • Bu kod satiri PDF dosyasinin basligini ayarlamak icin kullanilir. Bu kod satiri ile baslik icin daha fazla ozellige ulasabilirsiniz.
• renderer.RenderingOptions.TextFooter
  • Bu kod satiri, altbilgi özelliklerini, yazi, altbilgi'nin sag ve sol tarafi, yazi boyutu ve digerlerini ayarlamak icin kullanilir.
• renderer.RenderingOptions.PaperOrientation
  • Bu kod satiri, kullanicinin PDF dosyasinin sayfa yonunu (yatay veya dikey) ayarlamasina olanak tanir.
• renderer.RenderingOptions.Title
  • Bu satiri kullanarak PDF dosyasinin basligini belirleyebiliriz.

Son satırlarda, bir HTML Dizesinin PDF'ini oluşturmak için RenderHtmlAsPdf işlevini kullanıyoruz, ancak mevcut formatlamayı koruyarak sorunsuz bir şekilde PDF'ye dönüştürmek için bir HTML dosyası kullanabiliriz. IronPDF'un bu çok kullanisli ozelligi size PDF belgeleriyle ilgili her seyi ozellestirmede tam ozgurluk saglar.

Çıktı:

Formatlama destegi ile PDF cikti