C# Programlı Olarak PDF Dosyası Oluşturma

Daha ileri gitmeden önce, projemize IronPdf kütüphanesini kurmalıyız. Bunu çeşitli yollarla gerçekleştirebiliriz.

Yöntem 1: NuGet Package Manager

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

NuGet Paket Yöneticisini Açın

Gözat'a tıklayın ve arama çubuğuna IronPDF yazın. Aşağıdaki sonuç görünecektir. IronPDF'i seçin ve Yükle düğmesine tıklayın; kütüphane yüklenmeye başlayacaktır.

IronPDF paketini arayın ve yükleyin

Yöntem 2: NuGet Package Manager Console

Kütüphanemizi hızlı bir şekilde yüklemek için NuGet Paket Yöneticisi Konsolunu kullanabiliriz. Yüklemek için herhangi bir yönetici ayrıcalığı gerekmez. Projenize IronPdf kütüphanesini kurmak için bir NuGet komutu kullanabilirsiniz.

Install-Package IronPdf

Komut Satırıyla IronPDF paketini yükleyin

Yöntem 3: DLL dosyasını kullanarak

Projenizde IronPDF 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ını arayın.

IronPDF'yi kurmanız konusunda daha ayrıntılı bir kurulum kılavuzuna göz atın.

IronPDF kullanarak PDF'ler oluşturmanın çeşitli yöntemlerine bakacağız. PDF dosyalarını oluşturmanın ne kadar kolay olduğunu göreceğiz. HTML dizgisi kullanarak PDF oluşturmaya başlayalım.

4.1. HTML Dizgisi Kullanarak Programatik Olarak PDF Oluşturma

IronPDF kütüphanesinde HTML, stil amaçları için 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 dizgilerini işlemeyi ve bunları PDF formatına dönüştürmeyi çok kolay hale getirir. Bunu kod kullanarak nasıl yapacağımıza bakalım.

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 fonksiyonu kullanılmıştır. Bu fonksiyon, HTML Dizgisini 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 olmanız gerekir. SaveAs fonksiyonu, çıktı PDF dosyasını kaydetmek için kullanılır. Çıktı PDF dosyasını aşağıda görebilirsiniz.

Çıktı:

PDF dosyası çıktısı

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

IronPDF kütüphanesi, HTML dosyasından PDF dosyası oluşturmak için harika bir özellik sunar. IronPDF, bir HTML dosyasındaki her şeyi, resimler, CSS, formlar vb. dahil olmak üzere doğrudan bir PDF belgesine dönüştürür. İleri işleme için başka bir kütüphane veya fonksiyon gerektirmez. IronPDF herhangi bir HTML dosyasını doğrudan PDF dosyasına dönüştürür.

HTML dosyasından PDF dosyası oluşturma için bazı örnek kodlara bakalım:

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")

RenderHtmlFileAsPdf fonksiyonunu HTML dosyalarından PDF oluşturmak için kullanıyoruz. HTML Dosyası konumunu fonksiyon parametresine verebilir veya HTML dosyasını kaynak kodun bin klasörüne koyabilirsiniz, böylece RenderHtmlFileAsPdf fonksiyonun parametresine sadece dosya adı ve uzantısını koymanız yeterli olacaktır. Bu kodu çalıştırdığınızda çıktı PDF dosyası bin klasöründe kaydedilecektir. SaveAs fonksiyonu, oluşturulan PDF dosyalarını kaydetmeye yardımcı olur.

4.3. URL Kullanarak Programatik Olarak PDF Oluşturma

Bazen programımızda bir URL'nin PDF dosyalarını programatik olarak oluşturmamız gerekir. Her şeyi baştan kodlarsak, bu çok teknik bir görev olabilir. IronPDF, URL'lerden PDF oluşturmak için mükemmel bir fonksiyon sağlayarak burada bize yardımcı olur. PDF oluşturmak için herhangi bir URL'yi kullanabilirsiniz.

Bunu nasıl yapabileceğimize bakalım:

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 fonksiyonuna verilen URL parametresinin PDF'sini oluşturacaktır. Bu fonksiyon, URL'nin bir PDF dosyasını oluşturur. Bunu baştan yapmaya kalkışırsanız bu çok karmaşık bir görev olurdu, bu yüzden IronPDF geliştiricilere herhangi bir URL'yi bir PDF'ye dönüştürebilen basit bir süreç sunar. SaveAs fonksiyonu, çıktı dosyalarını bin klasörüne kaydetmek için kullanılır. Dosya formatını PDF olarak ayarlamak için, SaveAs fonksiyonundaki dosya adı parametresine bir .pdf uzantısı belirtmeniz gerekir. Proje klasörünüzde bin klasörünü görebilirsiniz. Çıktı aşağıda gösterilmiştir.

Çıktı:

URL'den PDF dosyası oluşturma

4.4. ASP.NET Web Forms Kullanarak Programatik Olarak PDF Oluşturma

ASP.NET, HTML'nin işlevselliğini genişleten ve bir tarayıcıda web geliştirmeyi destekleyen bir sunucu tarafı programlama çerçevesidir. ASP.NET sayfaları HTML, CSS ve JavaScript ile yazılmıştır ve ASPX dosyaları (.aspx) olarak kodlanabilir. ASP.NET web formları, kullanıcı dostu, işlevsellik zengin internet siteleri, çevrimiçi bankacılık, intranetler ve muhasebe sistemleri oluşturur.

ASP.NET web formlarını PDF'ye dönüştürmek için IronPDF kütüphanesini kullanacağız. Başlangıçta bir web sayfası olarak alınan sayfayı PDF'ye dönüştürüp web tarayıcısında görüntüleyeceğiz ve indireceğiz. Dönüşümü tamamlamak için IronPDF'ün AspxToPdf sınıfını kullanacağız.

Bunu nasıl yapacağımıza bakalım:

1. Visual Studio'da bir ASP.NET web formu projesi oluşturun. Visual Studio'nun en son sürümü önerilir.
2. IronPDF kütüphanesini NuGet Paket Yöneticisi veya tercih ettiğiniz DLL dosyası ile yükleyin. Ayrıca NuGet Paket Yöneticisi Konsolunu kullanarak yükleyebilirsiniz.
3. Şimdi, PDF dosyasına dönüştürmek istediğiniz herhangi bir ASPX web sayfasının kodunu açın. Burda projenin Default.aspx sayfasının PDF'sini oluşturacağız.

Visual Studio'da Web Formu proje yapısı

4. Default.aspx.cs dosyasını açın. Dosyaya IronPdf namespace'ini ekleyin; bu en önemli satırdır.

using IronPdf;

using IronPdf;

Imports IronPdf

5. Sayfanın PDF belgesini oluşturmak için Page_Load fonksiyonunda aşağıdaki kod satırını yazın.

AspxToPdf.RenderThisPageAsPdf(AspxToPdf.FileBehavior.InBrowser);

AspxToPdf.RenderThisPageAsPdf(AspxToPdf.FileBehavior.InBrowser);

AspxToPdf.RenderThisPageAsPdf(AspxToPdf.FileBehavior.InBrowser)

İşte bu kadar! ASPX web sayfasının PDF dosyası oluşturuldu. Projeyi çalıştırdığınızda tarayıcıda web sayfasının bir PDF'sini göreceksiniz. Sonuç, Ctrl+P tuşlarına basarak bir PDF oluşturduğunuzda yapılanla aynıdır. Burada ASPX dosyasının PDF'sini oluşturmak için Ctrl+P tuşlarına basmanıza gerek yoktur.

Bu server tarafında yapılmıştır. Bu kodda IronPDF'ün AspxToPdf sınıfını kullanıyoruz. RenderThisPageAsPdf fonksiyonu, ASPX web sayfasının PDF'sini oluşturur.

Yukarıdaki kod, PDF dosyasını tarayıcıda gösterir. PDF dosyasını sistemimize doğrudan indirmek için Page_Load fonksiyonuna aşağıdaki kod satırını ekleyebilirsiniz:

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

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

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

Bu kod ASPX web sayfasının PDF dosyasını sistemde indirecektir. ASPX PDF dosyasının adını da ayarlayabiliriz. Başlıklar, alt bilgeler, yazdırma seçenekleri, kalite vb. gibi değişiklik ve formatlama için birçok seçenek bulunmaktadır. Daha fazla ayrıntı için bu kapsamlı ASPX to PDF eğitimine göz atın.

Çıktı:

Sunucu tarafında bir PDF dosyasının oluşturulma çıktısı

Microsoft'un en son teknolojisini Blazor uygulamasıyla PDF dosyaları oluşturmak için inceleyin

4.5. Formatlama ile Programatik Olarak PDF Oluşturma

PDF oluştururken en çok karşılaşılan problemler, PDF belgelerinin formatlanması sırasında görülür. PDF'leri programatik olarak formatlamak kolay değildir. Ama artık elimizde IronPDF şeklinde bir çözüm var. IronPDF, oluşturduğumuz PDF dosyasını özelleştirmemize olanak tanıyan çeşitli formatlama seçenekleri sunar. Başlıklar, alt bilgiler, kenar boşlukları ve birçok başka formatlama seçeneği eklememizi sağlayan yöntemler sunar.

IronPDF kullanarak sayfa yönelimi, sayfa boyutu ve başlıkları ayarlamamıza olanak tanır. Ayrıca, yazı tipi boyutunu, yazı tipi rengini, yazı tipi türünü değiştirmeyi ve diğer yazı tipi ile ilgili işlemleri destekler. Bir ayırıcı çizgi ve özel metin ile alt bilgiler ve başlıklar ekleyebilirsiniz. IronPDF kullanarak PDF dosyalarını nasıl özelleştirebileceğimize bir göz atalım.

• Bir C# konsol projesi oluşturun. Gereksinimlerinize bağlı olarak bir GUI projesi de oluşturabilirsiniz. Ayrıca mevcut projeleri de açabilirsiniz.
• IronPDF kütüphanesini NuGet Paket Yöneticisi veya DLL dosyası ile yükleyin.
• Kod dosyasının en üstüne IronPDF ad alanını ekleyin.

Uygulamamızın kurulumu şimdi tamamlandı. Sonra, PDF dosyasına aşağıdaki 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 parçası, PDF dosyalarını biçimlendiriyor. RenderingOptions, PDF belgeleri oluştururken farklı özellikler ayarlamak için birincil araçtır.

• renderer.RenderingOptions.TextHeader
  • Bu kod satırı PDF dosyasının başlığını ayarlamak için kullanılır. Bu kod satırı ile başlık için daha fazla özelliğe erişebilirsiniz.
• renderer.RenderingOptions.TextFooter
  • Bu kod satırı alt bilgi özelliklerini, metin, alt bilginin sağ ve sol tarafını, yazı tipi boyutunu ve diğer birçok özelliği ayarlar.
• renderer.RenderingOptions.PaperOrientation
  • Bu kod satırı, PDF dosyasının sayfa yönelimi (yatay veya dikey) ayarını yapmayı sağlar.
• renderer.RenderingOptions.Title
  • Bu satır PDF dosyasının başlığını ayarlamak için kullanılabilir.

Son satırlarda, bir HTML String'in PDF'sini oluşturmak için RenderHtmlAsPdf fonksiyonunu kullanırız, ancak geçerli formatlamayı koruyarak bunu nahtarsız bir şekilde PDF'ye dönüştürmek için bir HTML dosyası kullanabiliriz. IronPDF'ün size PDF belgeleriyle ilgili her şeyi özelleştirme özgürlüğü sunan çok kullanışlı bir özelliğidir.

Çıktı:

Formatlama desteği ile PDF çıktısı