Jak drukować pliki PDF w VB.NET bez Adobe przy użyciu IronPrint

Jak zainstalować IronPrint w projekcie VB.NET?

Instalacja IronPrint zajmuje kilka sekund za pomocą menedżera pakietów NuGet. Otwórz konsolę menedżera pakietów w Visual Studio i uruchom:

Install-Package IronPrint

Po instalacji dodaj import przestrzeni nazw na początku każdego pliku, który ma zostać wydrukowany, a następnie zastosuj swój klucz licencyjny przed wywołaniem dowolnej metody IronPrint:

Imports IronPrint

' Apply your license key (get a free trial key at ironsoftware.com)
License.LicenseKey = "YOUR-LICENSE-KEY"

Imports IronPrint

' Apply your license key (get a free trial key at ironsoftware.com)
License.LicenseKey = "YOUR-LICENSE-KEY"

Imports IronPrint

' Apply your license key (get a free trial key at ironsoftware.com)
License.LicenseKey = "YOUR-LICENSE-KEY"

IronPrint jest przeznaczony dla platformy .NET Framework 4.6.2 i nowszych, a także dla .NET 6, 7, 8, 9 i 10. Zawiera natywne silniki renderujące dla każdej platformy, więc nie ma potrzeby instalowania programu Adobe Acrobat, Ghostscript ani żadnego innego renderera plików PDF. Ten sam pakiet NuGet działa w przypadku projektów Windows Forms, WPF, aplikacji konsolowych oraz ASP.NET napisanych w języku VB.NET.

Obsługiwane formaty dokumentów to PDF, PNG, HTML, TIFF, GIF, JPEG i BMP. Pełen zakres możliwości można sprawdzić w Dokumentacji API zunifikowanego drukowania IronPrint.

Więcej informacji na temat licencjonowania i aktywacji można znaleźć w dokumentacji dotyczącej klucza licencyjnego IronPrint.

Jak wydrukować plik PDF w tle w VB.NET?

Ciche drukowanie wysyła dokument bezpośrednio do drukarki bez wyświetlania żadnych okien dialogowych. Tryb ten jest niezbędny w przypadku zautomatyzowanych przepływów pracy, przetwarzania faktur w trybie wsadowym, procesów generowania raportów oraz drukowania dokumentów po stronie serwera, gdzie nie ma użytkownika.

Zgodnie z dokumentacją Microsoftu dotyczącą drukowania GDI+ w .NET, tradycyjne drukowanie w .NET polega na utworzeniu obiektu PrintDocument, podłączeniu się do zdarzeń PrintPage oraz ręcznym zarządzaniu układem strony. IronPrint eliminuje wszystkie te powtarzające się fragmenty:

Imports IronPrint

Module SilentPrinting
    Sub Main()
        Dim pdfPath As String = "invoice.pdf"

        ' Print to the system default printer
        Printer.Print(pdfPath)

        ' Print to a specific printer by name
        Dim settings As New PrintSettings()
        settings.PrinterName = "Microsoft Print to PDF"
        Printer.Print(pdfPath, settings)
    End Sub
End Module

Imports IronPrint

Module SilentPrinting
    Sub Main()
        Dim pdfPath As String = "invoice.pdf"

        ' Print to the system default printer
        Printer.Print(pdfPath)

        ' Print to a specific printer by name
        Dim settings As New PrintSettings()
        settings.PrinterName = "Microsoft Print to PDF"
        Printer.Print(pdfPath, settings)
    End Sub
End Module

Imports IronPrint

Module SilentPrinting
    Sub Main()
        Dim pdfPath As String = "invoice.pdf"

        ' Print to the system default printer
        Printer.Print(pdfPath)

        ' Print to a specific printer by name
        Dim settings As New PrintSettings()
        settings.PrinterName = "Microsoft Print to PDF"
        Printer.Print(pdfPath, settings)
    End Sub
End Module

Metoda Printer.Print obsługuje wewnętrznie całe renderowanie plików PDF. Gdy wywołasz Printer.Print(pdfPath) bez argumentu PrintSettings, IronPrint automatycznie wybiera domyślną drukarkę systemówą. Gdy obiektowi PrintSettings przypiszesz wartość PrinterName, przekierowuje on zadanie do tego konkretnego urządzenia.

W przypadku scenariuszy wsadowych można przejść przez listę ścieżek plików i wywołać Printer.Print dla każdej z nich. Ponieważ IronPrint nie otwiera żadnego wątku interfejsu użytkownika do drukowania w tle, działa poprawnie w aplikacjach konsolowych, usługach Windows oraz modułach obsługi żądań ASP.NET.

Aby zapoznać się z dostępnymi opcjami, przeczytaj dokumentację dotyczącą ustawień drukowania w IronPrint.

Jak wyświetlić okno dialogowe PRINT przed rozpoczęciem drukowania?

Czasami przed rozpoczęciem zadania drukowania trzeba pozwolić użytkownikom wybrać drukarkę, dostosować zakres stron lub ustawić liczbę kopii. IronPrint zapewnia Printer.ShowPrintDialog właśnie na taką sytuację:

Imports IronPrint

Module DialogPrinting
    Sub Main()
        ' Display the standard Windows print dialog
        Printer.ShowPrintDialog("report.pdf")
    End Sub
End Module

Imports IronPrint

Module DialogPrinting
    Sub Main()
        ' Display the standard Windows print dialog
        Printer.ShowPrintDialog("report.pdf")
    End Sub
End Module

Imports IronPrint

Module DialogPrinting
    Sub Main()
        ' Display the standard Windows print dialog
        Printer.ShowPrintDialog("report.pdf")
    End Sub
End Module

Po uruchomieniu tej metody system Windows wyświetla standardowe okno dialogowe drukowania. Użytkownik może wybrać dowolną zainstalowaną drukarkę, zakres stron, liczbę kopii oraz dostosować ustawienia druku dwustronnego. Po kliknięciu przycisku PRINT lub Anuluj kontrola wraca do kodu użytkownika.

Metoda ta w naturalny sposób integruje się z aplikacjami Windows Forms. Można wywołać go z poziomu procedury obsługi kliknięcia przycisku i mieć pewność, że okno dialogowe będzie działało spójnie z innymi aplikacjami systemu Windows, które użytkownik już zna.

Strona z przykładami okna dialogowego drukowania pokazuje dodatkowe przypadki użycia, w tym wstępny wybór drukarki lub wstępne wypełnienie liczby kopii przed otwarciem okna dialogowego.

Jak dostosować ustawienia drukowania plików PDF w VB.NET?

Klasa PrintSettings zapewnia pełną kontrolę programową nad każdym aspektem zadania drukowania. Można ustawić rozdzielczość (DPI), rozmiar papieru, orientację, liczbę kopii oraz docelową drukarkę — wszystko to przed umieszczeniem zadania w kolejce drukowania:

Imports IronPrint

Module CustomPrintSettings
    Sub Main()
        Dim settings As New PrintSettings() With {
            .Dpi = 300,
            .NumberOfCopies = 2,
            .PaperOrientation = PaperOrientation.Landscape,
            .PaperSize = PaperSize.A4,
            .PrinterName = "Office Printer"
        }

        Printer.Print("document.pdf", settings)
    End Sub
End Module

Imports IronPrint

Module CustomPrintSettings
    Sub Main()
        Dim settings As New PrintSettings() With {
            .Dpi = 300,
            .NumberOfCopies = 2,
            .PaperOrientation = PaperOrientation.Landscape,
            .PaperSize = PaperSize.A4,
            .PrinterName = "Office Printer"
        }

        Printer.Print("document.pdf", settings)
    End Sub
End Module

Imports IronPrint

Module CustomPrintSettings
    Sub Main()
        Dim settings As New PrintSettings() With {
            .Dpi = 300,
            .NumberOfCopies = 2,
            .PaperOrientation = PaperOrientation.Landscape,
            .PaperSize = PaperSize.A4,
            .PrinterName = "Office Printer"
        }

        Printer.Print("document.pdf", settings)
    End Sub
End Module

Jak programowo wyliczyć i wybrać drukarki?

W środowiskach Enterprise stacje robocze często mają dostęp do kilkudziesięciu drukarek sieciowych. IronPrint ułatwia wyświetlenie listy wszystkich dostępnych drukarek i wybranie odpowiedniej w czasie wykonywania:

Imports IronPrint

Module PrinterManagement
    Sub Main()
        ' Retrieve all available printers
        Dim printers As List(Of String) = Printer.GetPrinterNames()

        Console.WriteLine($"Found {printers.Count} printer(s):")
        For Each printerName As String In printers
            Console.WriteLine($"  - {printerName}")
        Next

        ' Print to the first available printer
        If printers.Count > 0 Then
            Dim settings As New PrintSettings()
            settings.PrinterName = printers(0)
            Printer.Print("document.pdf", settings)
        Else
            Console.WriteLine("No printers found. Check system configuration.")
        End If
    End Sub
End Module

Imports IronPrint

Module PrinterManagement
    Sub Main()
        ' Retrieve all available printers
        Dim printers As List(Of String) = Printer.GetPrinterNames()

        Console.WriteLine($"Found {printers.Count} printer(s):")
        For Each printerName As String In printers
            Console.WriteLine($"  - {printerName}")
        Next

        ' Print to the first available printer
        If printers.Count > 0 Then
            Dim settings As New PrintSettings()
            settings.PrinterName = printers(0)
            Printer.Print("document.pdf", settings)
        Else
            Console.WriteLine("No printers found. Check system configuration.")
        End If
    End Sub
End Module

Imports IronPrint

Module PrinterManagement
    Sub Main()
        ' Retrieve all available printers
        Dim printers As List(Of String) = Printer.GetPrinterNames()

        Console.WriteLine($"Found {printers.Count} printer(s):")
        For Each printerName As String In printers
            Console.WriteLine($"  - {printerName}")
        Next

        ' Print to the first available printer
        If printers.Count > 0 Then
            Dim settings As New PrintSettings()
            settings.PrinterName = printers(0)
            Printer.Print("document.pdf", settings)
        Else
            Console.WriteLine("No printers found. Check system configuration.")
        End If
    End Sub
End Module

Printer.GetPrinterNames() wysyła zapytanie do podsystemu drukowania systemu Windows i zwraca wszystkie drukarki, do których ma dostęp bieżący użytkownik, w tym lokalne drukarki USB, drukarki sieciowe, drukarki wirtualne, takie jak Microsoft Print to PDF, oraz wszelkie sterowniki drukarek zainstalowane za pośrednictwem oprogramowania innych firm.

Jak radzić sobie z błędami drukowania w VB.NET?

Kod drukowania produkcyjnego musi płynnie radzić sobie z awariami. Ścieżki do plików mogą być nieprawidłowe, drukarki mogą być w trybie offline lub konto użytkownika może nie mieć uprawnień do drukowania. Otoczenie wywołań PRINT w ustrukturyzowaną obsługę wyjątków zapobiega awariom aplikacji spowodowanym przez nieobsługiwane wyjątki:

Imports IronPrint
Imports System.IO

Module BłądHandling
    Sub Main()
        Dim filePath As String = "document.pdf"

        If Not File.Exists(filePath) Then
            Console.WriteLine("PDF file not found. Verify the path and try again.")
            Return
        End If

        Try
            Dim settings As New PrintSettings()
            settings.PrinterName = "Office Printer"
            Printer.Print(filePath, settings)
            Console.WriteLine("Print job sent successfully.")
        Catch ex As Exception
            Console.WriteLine($"Printing failed: {ex.Message}")
        End Try
    End Sub
End Module

Imports IronPrint
Imports System.IO

Module BłądHandling
    Sub Main()
        Dim filePath As String = "document.pdf"

        If Not File.Exists(filePath) Then
            Console.WriteLine("PDF file not found. Verify the path and try again.")
            Return
        End If

        Try
            Dim settings As New PrintSettings()
            settings.PrinterName = "Office Printer"
            Printer.Print(filePath, settings)
            Console.WriteLine("Print job sent successfully.")
        Catch ex As Exception
            Console.WriteLine($"Printing failed: {ex.Message}")
        End Try
    End Sub
End Module

Imports IronPrint
Imports System.IO

Module BłądHandling
    Sub Main()
        Dim filePath As String = "document.pdf"

        If Not File.Exists(filePath) Then
            Console.WriteLine("PDF file not found. Verify the path and try again.")
            Return
        End If

        Try
            Dim settings As New PrintSettings()
            settings.PrinterName = "Office Printer"
            Printer.Print(filePath, settings)
            Console.WriteLine("Print job sent successfully.")
        Catch ex As Exception
            Console.WriteLine($"Printing failed: {ex.Message}")
        End Try
    End Sub
End Module

Jak połączyć generowanie plików PDF i drukowanie w VB.NET?

Typowy przebieg pracy obejmuje generowanie pliku PDF w czasie wykonywania, a następnie natychmiastowe drukowanie — na przykład tworzenie faktury na podstawie rekordów z bazy danych i wysyłanie jej do drukarki w jednym kroku. IronPDF zajmuje się tworzeniem plików PDF, a IronPrint obsługuje wydruk:

Jak drukować wiele stron i kontrolować zakresy stron?

Podczas drukowania dużych dokumentów może zaistnieć potrzeba wydrukowania tylko określonych stron — na przykład stron od 1 do 5 w 50-stronicowym raporcie. Klasa PrintSettings w IronPrint obsługuje konfigurację zakresu stron:

Jakie są Twoje kolejne kroki?

Masz teraz podstawowe elementy do drukowania plików PDF w aplikacjach VB.NET:

• Ciche drukowanie -- Printer.Print(path) dla zautomatyzowanych procesów
• Drukowanie okien dialogowych -- Printer.ShowPrintDialog(path) dla zadań kontrolowanych przez użytkownika
• Ustawienia niestandardowe -- PrintSettings dla DPI, orientacji, liczby kopii i wyboru drukarki
• Wymienianie drukarek -- Printer.GetPrinterNames() dla dynamicznego kierowania wydruków
• Obsługa błędów — strukturalna obsługa wyjątków z walidacją plików przed przetwarzaniem
• Połączone procesy — IronPDF do generowania, IronPrint do wydruku

Aby wykorzystać te możliwości, rozpocznij bezpłatny okres próbny IronPrint i zapoznaj się z tymi dodatkowymi zasobami:

• Przewodnik po IronPrint — kompletny opis konfiguracji
• Drukowanie z przykładami okien dialogowych — wzorce dostosowywania okien dialogowych
• Zaawansowane funkcje ustawień drukowania — kompletny opis ustawień
• Funkcje informacji o drukarce — sprawdzanie właściwości drukarki
• Dokumentacja API IronPrint — pełna dokumentacja klas i metod
• Przewodnik rozwiązywania problemów z IronPrint — rozwiązywanie typowych problemów