Programatik C#'da PDF Yazdırma (Kod Örneği Eğitim)

NuGet Paket Yöneticisi Üzerinden Kurulum Süreci

IronPrint'in kurulumu basittir. .NET projenize eklemenin en kolay yolu NuGet Paket Yöneticisi aracılığıyladır:

• Projenizi Visual Studio'da açın.
• NuGet Paket Yöneticisine gidin.
• "IronPrint"i arayın.
• Yükleye tıklayın ve Visual Studio'nun geri kalanını halletmesine izin verin.

Paket Yöneticisi Konsolunu tercih edenler için, aşağıdaki komutu kullanın:

Install-Package IronPrint

Kurulumdan sonra tüm bağımlılıkların doğru şekilde geri yüklendiğinden emin olun.

.NET Projesinde Temel Kurulum ve Yapılandırma

Kurulum tamamlandıktan sonra, IronPrint'in çalışmaya başlaması için minimal yapılandırma gerektirir. Öncelikle uygulamanızın gerekli yazıcı sürücülerine erişimi olduğundan emin olun. Sonra, kütüphaneyi referans alarak ve temel parametreleri ayarlayarak IronPrint'i başlatın. Basit bir uygulama şöyle görünebilir:

// Import the IronPrint namespace to access its functionalities.
using IronPrint;

// Use the Printer object to send a PDF file to the default printer.
Printer.Print("sample-document.pdf");

// Import the IronPrint namespace to access its functionalities.
using IronPrint;

// Use the Printer object to send a PDF file to the default printer.
Printer.Print("sample-document.pdf");

' Import the IronPrint namespace to access its functionalities.
Imports IronPrint

' Use the Printer object to send a PDF file to the default printer.
Printer.Print("sample-document.pdf")

Bu temel kurulum, uygulamanın PDF dosyasını varsayılan yazıcıya anında göndermesini sağlar. Geliştiriciler farklı bir yazıcı belirleyerek, baskı ayarlarını ayarlayarak veya ihtiyaçlarına göre ek yapılandırmaları entegre ederek davranışı özelleştirebilirler. Kurulum ve yapılandırma tamamlandıktan sonra, farklı baskı senaryolarını verimli bir şekilde yönetmek için IronPrint'in temel işlevlerini keşfetme zamanı geldi.

PDF'leri Programlamatik Olarak Basma

IronPrint, PDF ve resimleri basmayı basit hale getirir. Print yöntemi, PDF dosyalarını gereksiz adımlar olmadan doğrudan yazıcıya göndererek verimli bir şekilde işler. Bu, PDF dosyalarını hızlı ve verimli bir şekilde basmanız gerektiğinde özellikle faydalıdır. Basit bir uygulama şöyle görünür:

using IronPrint;

// Print a PDF document using the default settings.
Printer.Print("invoice.pdf");

using IronPrint;

// Print a PDF document using the default settings.
Printer.Print("invoice.pdf");

Imports IronPrint

' Print a PDF document using the default settings.
Printer.Print("invoice.pdf")

Resim Basma

Görüntü dosyaları için, IronPrint PNG, JPEG ve BMP gibi yaygın formatları destekler. Print yöntemi, yazdırıldığında netlik ve çözünürlüğü koruyacak şekilde görüntüleri otomatik olarak algılar ve işler.

using IronPrint;

// Print an image file, ensuring clarity and resolution are maintained during the process.
Printer.Print("logo.png");

using IronPrint;

// Print an image file, ensuring clarity and resolution are maintained during the process.
Printer.Print("logo.png");

Imports IronPrint

' Print an image file, ensuring clarity and resolution are maintained during the process.
Printer.Print("logo.png")

Tek bir belgede birden fazla görüntü sıralı olarak işlenir. IronPrint, formatlamanın bozulmadan kalmasını sağlar, bozulma veya kalite kaybını önler. Bu, PDF dosyalarına ek olarak karmaşık raporlar veya grafik belgelerin basımı için ideal hale getirir.

Gizli Yazdırma vs. Yazdırma Diyaloğu

IronPrint, geliştiricilere belgelerin nasıl basılacağını kontrol etme olanağı sağlar. Sessiz baskı, kullanıcının girişi gerekmeden PDF belgelerini doğrudan yazıcıya gönderir. Bu, toplu baskıyı otomatikleştiren uygulamalar için gereksiz kesintileri azaltır ve iş akışlarını hızlandırır. Ayrıca birden fazla PDF dosyasını da verimli bir şekilde yazdırabilirsiniz.

using IronPrint;

// Silent printing of a PDF without requiring user input.
Printer.Print("report.pdf");

using IronPrint;

// Silent printing of a PDF without requiring user input.
Printer.Print("report.pdf");

Imports IronPrint

' Silent printing of a PDF without requiring user input.
Printer.Print("report.pdf")

Alternatif olarak, kullanıcılar baskı öncesi ayarlarını ayarlamalıysa, IronPrint bir baskı diyalogu tetikleyebilir. Bu, kullanıcıların, baskı işini tamamlamadan önce, bir yazıcı seçmesine, sayfa yönünü ayarlamasına ve baskı kalitesini ayarlamasına olanak tanır.

using IronPrint;

// Display a print dialog for user configuration before printing the document.
Printer.ShowPrintDialog("document.pdf");

using IronPrint;

// Display a print dialog for user configuration before printing the document.
Printer.ShowPrintDialog("document.pdf");

Imports IronPrint

' Display a print dialog for user configuration before printing the document.
Printer.ShowPrintDialog("document.pdf")

Sessiz baskı, kullanıcı müdahalesinin gerekmediği otomatik iş akışları için en iyisidir, baskı diyalogları ise özelleştirmenin gerektiği durumlarda idealdir. Her iki yöntem de uygulamanın ihtiyaçlarına bağlı olarak esneklik ve verimlilik sağlar. Bu işlevlerden yararlanarak, geliştiriciler .NET uygulamaları içinde otomatik ve kullanıcı dostu baskı yeteneklerini entegre edebilir, baskı PDF belgelerinin sorunsuz bir şekilde ele alınmasını sağlar.

Kağıt Ayarları

IronPrint ile geliştiriciler, uygulamalarının ihtiyaçlarına göre kağıt boyutlarını ve yönlerini özelleştirebilir. Bu, standart olmayan kağıt formatlarına basmak veya belirli bir düzen gerektiğinde özellikle kullanışlıdır. Geçerli baskı belgesi nesnesi, geliştiricilerin bu yapılandırmaları verimli bir şekilde yönetmesine olanak tanır. Kağıt boyutunu ve yönünü ayarlamak için, PrintSettings sınıfını başlatın ve istenen özellikleri belirtin:

using IronPrint;

// Configure paper settings such as size and orientation.
PrintSettings printSettings = new PrintSettings
{
    PaperSize = PaperSize.A4,
    PaperOrientation = PaperOrientation.Landscape
};

// Print the document using the specified settings.
Printer.Print("document.pdf", printSettings);

using IronPrint;

// Configure paper settings such as size and orientation.
PrintSettings printSettings = new PrintSettings
{
    PaperSize = PaperSize.A4,
    PaperOrientation = PaperOrientation.Landscape
};

// Print the document using the specified settings.
Printer.Print("document.pdf", printSettings);

Imports IronPrint

' Configure paper settings such as size and orientation.
Private printSettings As New PrintSettings With {
	.PaperSize = PaperSize.A4,
	.PaperOrientation = PaperOrientation.Landscape
}

' Print the document using the specified settings.
Printer.Print("document.pdf", printSettings)

Baskı Kalitesi ve Kopyalar

Baskı kalitesi üzerinde daha iyi kontrol sağlamak için, geliştiriciler, belgelerin doğru detay seviyesinde basılmasını sağlamak için DPI (inç başına düşen nokta) ayarını ayarlayabilirler. Daha yüksek DPI ayarları netliği artırır ancak baskı süresini uzatabilir. Ayrıca, basılacak kopya sayısını da belirtebilirsiniz:

using IronPrint;

// Configure print settings for quality and number of copies.
PrintSettings printSettings = new PrintSettings
{
    Dpi = 300,
    NumberOfCopies = 2
};

// Print the document with the specified settings.
Printer.Print("report.pdf", printSettings);

using IronPrint;

// Configure print settings for quality and number of copies.
PrintSettings printSettings = new PrintSettings
{
    Dpi = 300,
    NumberOfCopies = 2
};

// Print the document with the specified settings.
Printer.Print("report.pdf", printSettings);

Imports IronPrint

' Configure print settings for quality and number of copies.
Private printSettings As New PrintSettings With {
	.Dpi = 300,
	.NumberOfCopies = 2
}

' Print the document with the specified settings.
Printer.Print("report.pdf", printSettings)

Yazıcı Seçimi

Geliştiriciler, sistemin varsayılan yazıcısına bağımlı kalmak yerine hangi yazıcının kullanılacağını belirtebilirler. Bu, özellikle birden fazla yazıcının mevcut olduğu ofis ortamlarında kullanışlıdır:

using IronPrint;

// Specify the printer to use for printing the document.
PrintSettings printSettings = new PrintSettings
{
    PrinterName = "Your Printer Name"
};

// Print the document using the specified printer.
Printer.Print("invoice.pdf", printSettings);

using IronPrint;

// Specify the printer to use for printing the document.
PrintSettings printSettings = new PrintSettings
{
    PrinterName = "Your Printer Name"
};

// Print the document using the specified printer.
Printer.Print("invoice.pdf", printSettings);

Imports IronPrint

' Specify the printer to use for printing the document.
Private printSettings As New PrintSettings With {.PrinterName = "Your Printer Name"}

' Print the document using the specified printer.
Printer.Print("invoice.pdf", printSettings)

Marjinler ve Grayscale Baskı

Özel marjinler, belgenin doğru hizalanmasını sağlarken, gri tonlama baskı, renk gereksiz olduğunda mürekkep tasarrufu sağlayabilir. Marjinler, hassas ayarlamalar için milimetre olarak tanımlanır:

using IronPrint;

// Configure print settings for margins and grayscale printing.
PrintSettings printSettings = new PrintSettings
{
    PaperMargins = new Margins
    {
        Top = 10,
        Right = 10,
        Bottom = 10,
        Left = 10
    },
    Grayscale = true
};

// Print the document using the specified settings.
Printer.Print("draft.pdf", printSettings);

using IronPrint;

// Configure print settings for margins and grayscale printing.
PrintSettings printSettings = new PrintSettings
{
    PaperMargins = new Margins
    {
        Top = 10,
        Right = 10,
        Bottom = 10,
        Left = 10
    },
    Grayscale = true
};

// Print the document using the specified settings.
Printer.Print("draft.pdf", printSettings);

Imports IronPrint

' Configure print settings for margins and grayscale printing.
Private printSettings As New PrintSettings With {
	.PaperMargins = New Margins With {
		.Top = 10,
		.Right = 10,
		.Bottom = 10,
		.Left = 10
	},
	.Grayscale = True
}

' Print the document using the specified settings.
Printer.Print("draft.pdf", printSettings)

Bu ileri düzey baskı ayarlarından yararlanarak, geliştiriciler baskı işlemini belirli gereksinimlere uydurabilir ve tutarlı ve profesyonel kalitede çıktı alabilirler.