.NET PDF Printer (samouczek dla programistów)

Jakie są kluczowe cechy, które wyróżniają IronPrint?

1. Wszechstronność: Obsługuje pliki PDF, HTML i graficzne, zapewniając elastyczność w przypadku różnych typów dokumentów. Samouczek dotyczący drukowania dokumentów pokazuje sposób użycia na wielu platformach.

2. Łatwość integracji: Intuicyjny interfejs API i obszerna dokumentacja skracają czas i wysiłek związany z programowaniem. Przegląd funkcji biblioteki podkreśla możliwości płynnej integracji.

3. Zaawansowane opcje drukowania: Kontroluj układ strony, orientację, rozmiar papieru i jakość, aby spełnić konkretne wymagania. Zastosuj niestandardowe ustawienia drukowania, w tym marginesy, rozdzielczość DPI i specyfikacje papieru, za pomocą prostego kodu.

4. Płynna kompatybilność: Integruje się z ASP.NET, WPF i Windows Forms dla różnych scenariuszy programistycznych. Specjalistyczne wytyczne dotyczące platformy ASP.NET Web App Framework obejmują funkcje drukowania asynchronicznego.

5. Niezawodność i wsparcie: Poparte reputacją firmy Iron Software w zakresie jakości, solidnym wsparciem i częstymi aktualizacjami. Dziennik zmian zawiera informacje o najnowszych ulepszeniach.

Jak skonfigurować projekt do drukowania w formacie PDF?

Na początek utwórzmy nowy projekt .NET w Visual Studio i zainstalujmy bibliotekę IronPrint za pomocą menedżera pakietów NuGet. Otwórz program Visual Studio i wykonaj następujące czynności:

1. Wybierz "Plik" > "Nowy" > "Projekt", aby utworzyć nowy projekt .NET.

   

2. Wybierz odpowiedni szablon projektu (e.g., Aplikacja konsolowa, Aplikacja internetowa ASP.NET) i kliknij "Dalej".

   

3. Wpisz nazwę projektu i wybierz miejsce, w którym chcesz go zapisać. Kliknij "Dalej", aby kontynuować.

   

4. Po utworzeniu projektu otwórz konsolę menedżera pakietów NuGet (dostępną poprzez "Narzędzia" > "Menedżer pakietów NuGet" > "Konsola menedżera pakietów").

5. Użyj następującego polecenia, aby zainstalować pakiet IronPrint:

   Install-Package IronPrint

6. Alternatywnie można zainstalować pakiet za pomocą interfejsu użytkownika NuGet Package Manager, wyszukując "IronPrint" i klikając "Zainstaluj".

Po pomyślnym zainstalowaniu IronPrint jesteśmy gotowi przejść do następnego kroku: wdrożenia funkcji drukowania plików PDF. Pamiętaj, aby odpowiednio skonfigurować klucze licencyjne do użytku produkcyjnego. W przypadku aplikacji ASP.NET może być konieczne ustawienie klucza licencyjnego w pliku Web.config, aby uniknąć typowych błędów konfiguracji.

Jakiego kodu potrzebuję do drukowania dokumentów PDF?

Teraz, gdy nasz projekt jest już skonfigurowany, napiszmy kod, aby zaimplementować funkcję drukowania plików PDF przy użyciu IronPrint. Stworzymy prostą aplikację .NET, która drukuje dokument PDF przy użyciu IronPrint. Poniżej znajduje się podstawowy przykład, jak to osiągnąć:

using IronPrint;

class Program
{
    static void Main(string[] args)
    {
        // Create a new PrintSettings object to define printing preferences
        PrintSettings printSettings = new PrintSettings();

        // Set DPI (dots per inch) for clear printing
        printSettings.Dpi = 150;

        // Specify the number of copies to print
        printSettings.NumberOfCopies = 2;

        // Set paper orientation to Portrait
        printSettings.PaperOrientation = PaperOrientation.Portrait;

        // Print the specified PDF file using the default printer
        Printer.Print("output.pdf", printSettings);
    }
}

using IronPrint;

class Program
{
    static void Main(string[] args)
    {
        // Create a new PrintSettings object to define printing preferences
        PrintSettings printSettings = new PrintSettings();

        // Set DPI (dots per inch) for clear printing
        printSettings.Dpi = 150;

        // Specify the number of copies to print
        printSettings.NumberOfCopies = 2;

        // Set paper orientation to Portrait
        printSettings.PaperOrientation = PaperOrientation.Portrait;

        // Print the specified PDF file using the default printer
        Printer.Print("output.pdf", printSettings);
    }
}

Imports IronPrint

Friend Class Program
	Shared Sub Main(ByVal args() As String)
		' Create a new PrintSettings object to define printing preferences
		Dim printSettings As New PrintSettings()

		' Set DPI (dots per inch) for clear printing
		printSettings.Dpi = 150

		' Specify the number of copies to print
		printSettings.NumberOfCopies = 2

		' Set paper orientation to Portrait
		printSettings.PaperOrientation = PaperOrientation.Portrait

		' Print the specified PDF file using the default printer
		Printer.Print("output.pdf", printSettings)
	End Sub
End Class

Powyższy kod w języku C# wykorzystuje bibliotekę IronPrint do drukowania plików PDF. Rozpoczyna się od zaimportowania niezbędnej przestrzeni nazw IronPrint. Wewnątrz metody Main inicjuje się obiekt PrintSettings, konfigurując parametry, takie jak DPI, liczba kopii i orientacja papieru. W tym przypadku DPI jest ustawione na 150, liczba kopii na 2, a orientacja papieru na pionową. Na koniec wywołuje metodę Print klasy Printer, określając nazwę pliku wyjściowego jako "output.pdf" i przekazując obiekt printSettings. Ten fragment kodu pokazuje podstawową konfigurację drukowania plików PDF przy użyciu biblioteki IronPrint w języku C# i domyślnej drukarki.

W bardziej zaawansowanych scenariuszach warto rozważyć drukowanie z opcjami okna dialogowego, umożliwiającym użytkownikom konfigurację preferencji drukowania za pomocą znanego interfejsu. Oto przykład:

using IronPrint;
using System;
using System.Collections.Generic;

class AdvancedPrintingExample
{
    static void Main(string[] args)
    {
        // Get available printers on the system
        List<string> printerNames = Printer.GetPrinterNames();

        Console.WriteLine("Available printers:");
        foreach (string printer in printerNames)
        {
            Console.WriteLine($"- {printer}");
        }

        // Create advanced print settings
        PrintSettings advancedSettings = new PrintSettings()
        {
            // Specify a particular printer
            PrinterName = printerNames[0], // Use first available printer

            // Set paper size to A4
            PaperSize = PaperSize.A4,

            // Configure margins (in hundredths of an inch)
            MarginTop = 50,
            MarginBottom = 50,
            MarginLeft = 100,
            MarginRight = 100,

            // Enable grayscale printing
            Grayscale = true,

            // Set custom DPI for high-quality output
            Dpi = 300
        };

        // Show print dialog for user customization
        Printer.ShowPrintDialog("output.pdf", advancedSettings);
    }
}

using IronPrint;
using System;
using System.Collections.Generic;

class AdvancedPrintingExample
{
    static void Main(string[] args)
    {
        // Get available printers on the system
        List<string> printerNames = Printer.GetPrinterNames();

        Console.WriteLine("Available printers:");
        foreach (string printer in printerNames)
        {
            Console.WriteLine($"- {printer}");
        }

        // Create advanced print settings
        PrintSettings advancedSettings = new PrintSettings()
        {
            // Specify a particular printer
            PrinterName = printerNames[0], // Use first available printer

            // Set paper size to A4
            PaperSize = PaperSize.A4,

            // Configure margins (in hundredths of an inch)
            MarginTop = 50,
            MarginBottom = 50,
            MarginLeft = 100,
            MarginRight = 100,

            // Enable grayscale printing
            Grayscale = true,

            // Set custom DPI for high-quality output
            Dpi = 300
        };

        // Show print dialog for user customization
        Printer.ShowPrintDialog("output.pdf", advancedSettings);
    }
}

Imports IronPrint
Imports System
Imports System.Collections.Generic

Class AdvancedPrintingExample
    Shared Sub Main(args As String())
        ' Get available printers on the system
        Dim printerNames As List(Of String) = Printer.GetPrinterNames()

        Console.WriteLine("Available printers:")
        For Each printer As String In printerNames
            Console.WriteLine($"- {printer}")
        Next

        ' Create advanced print settings
        Dim advancedSettings As New PrintSettings() With {
            ' Specify a particular printer
            .PrinterName = printerNames(0), ' Use first available printer

            ' Set paper size to A4
            .PaperSize = PaperSize.A4,

            ' Configure margins (in hundredths of an inch)
            .MarginTop = 50,
            .MarginBottom = 50,
            .MarginLeft = 100,
            .MarginRight = 100,

            ' Enable grayscale printing
            .Grayscale = True,

            ' Set custom DPI for high-quality output
            .Dpi = 300
        }

        ' Show print dialog for user customization
        Printer.ShowPrintDialog("output.pdf", advancedSettings)
    End Sub
End Class

Ten przykład pokazuje, jak uzyskać nazwy drukarek i pobrać informacje o drukarkach, umożliwiając aplikacji uzyskanie informacji o drukarkach dla urządzeń lokalnych na platformach Windows, iOS i Android. Kompleksowy przewodnik po ustawieniach drukowania obejmuje wszystkie dostępne opcje konfiguracyjne przy użyciu klasy PrintSettings.