Jak drukować dokumenty w tle w języku C

Jak działa ciche drukowanie w .NET?

Przestrzeń nazw .NET System.Drawing.Printing zawiera klasę StandardPrintController, która wyłącza okno dialogowe stanu podczas operacji drukowania. Domyślnie .NET używa PrintControllerWithStatusDialog, co powoduje wyświetlenie okienka "Drukowanie strony X z Y". Przejście na StandardPrintController eliminuje to okienko — ale koszt konfiguracji pozostaje znaczny.

Aby drukować w trybie cichym przy użyciu podejścia natywnego, tworzymy PrintDocument, dołączamy procedurę obsługi zdarzenia PrintPage, która rysuje zawartość na powierzchni graficznej wydruku, przypisujemy StandardPrintController, konfigurujemy PrinterSettings i wywołujemy Print(). Wymaga to około 15–25 wierszy kodu konfiguracyjnego dla pojedynczego dokumentu, a każdy nowy typ lub format dokumentu wymaga własnej logiki renderowania w zdarzeniu PrintPage. W szczególności renderowanie plików PDF nie jest wbudowane w System.Drawing.Printing — potrzebowalibyśmy oddzielnej biblioteki do analizowania plików PDF, aby wyodrębnić strony i narysować je na powierzchni Graphics.

IronPrint łączy cały ten proces w statycznej klasie Printer. Metoda Print() przyjmuje ścieżkę do pliku lub tablicę bajtów, wykrywa format pliku, renderuje go za pomocą odpowiedniego silnika i wysyła do domyślnej drukarki — wszystko to bez wyświetlania okna dialogowego.

:path=/static-assets/print/content-code-examples/how-to/silent-printing/silent-printing-print-pdf-and-byte-array.cs

using IronPrint;

// Print a PDF silently
Printer.Print("quarterly-report.pdf");

// Print from a byte array
byte[] pdfData = File.ReadAllBytes("shipping-label.pdf");
Printer.Print(pdfData);

Imports IronPrint

' Print a PDF silently
Printer.Print("quarterly-report.pdf")

' Print from a byte array
Dim pdfData As Byte() = File.ReadAllBytes("shipping-label.pdf")
Printer.Print(pdfData)

Metoda Print() obsługuje formaty plików PDF, PNG, TIFF, JPEG, GIF, HTML i BMP. Przekazujemy ścieżkę do pliku jako ciąg znaków lub surowe dane pliku jako byte[], a IronPrint automatycznie określa strategię renderowania.

Jak skonfigurować ustawienia drukowania dla cichego wydruku?

Klasa PrintSettings zapewnia nam pełną kontrolę nad zadaniem drukowania. Konfigurujemy docelową drukarkę, wymiary papieru, orientację, marginesy, rozdzielczość, tryb kolorów, liczbę kopii i tryb druku dwustronnego — a następnie przekazujemy obiekt ustawień do Printer.Print(). DPI Grayscale PaperMargins

:path=/static-assets/print/content-code-examples/how-to/silent-printing/silent-printing-print-with-settings.cs

using IronPrint;

// Configure print settings
var settings = new PrintSettings
{
    PrinterName = "HP LaserJet Pro",
    PaperSize = PaperSize.A4,
    PaperOrientation = PaperOrientation.Portrait,
    Dpi = 300,
    NumberOfCopies = 2,
    Grayscale = false,
    PaperMargins = new Margins(10, 10, 10, 10)
};

// Print with custom settings
Printer.Print("report.pdf", settings);

Imports IronPrint

' Configure print settings
Dim settings As New PrintSettings With {
    .PrinterName = "HP LaserJet Pro",
    .PaperSize = PaperSize.A4,
    .PaperOrientation = PaperOrientation.Portrait,
    .Dpi = 300,
    .NumberOfCopies = 2,
    .Grayscale = False,
    .PaperMargins = New Margins(10, 10, 10, 10)
}

' Print with custom settings
Printer.Print("report.pdf", settings)

Każda właściwość odpowiada standardowemu ustawieniu bufora wydruku. Resolution kontroluje rozdzielczość wyjściową — 300 jest powszechnym wyborem dla dokumentów biznesowych, podczas gdy 150 sprawdza się dobrze w przypadku szkiców. ColorMode zmniejsza zużycie tonera, gdy kolor nie jest konieczny. Wartości Margins są podane w milimetrach.

:path=/static-assets/print/content-code-examples/how-to/silent-printing/silent-printing-select-specific-printer.cs

using IronPrint;

// List all available printers
List<string> printers = Printer.GetPrinterNames();
foreach (string name in printers)
{
    Console.WriteLine(name);
}

// Target a specific network printer
var settings = new PrintSettings
{
    PrinterName = printers.First(p => p.Contains("LaserJet"))
};

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

Imports IronPrint

' List all available printers
Dim printers As List(Of String) = Printer.GetPrinterNames()
For Each name As String In printers
    Console.WriteLine(name)
Next

' Target a specific network printer
Dim settings As New PrintSettings With {
    .PrinterName = printers.First(Function(p) p.Contains("LaserJet"))
}

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

Jak wydrukować wiele dokumentów w partii?

Drukowanie wsadowe przebiega według prostego schematu pętli. Przechodzimy przez zbiór ścieżek do plików i wywołujemy Printer.Print() dla każdego dokumentu. Ponieważ każde wywołanie przebiega w tle, cała partia jest przetwarzana bez wyświetlania żadnych okien dialogowych.

:path=/static-assets/print/content-code-examples/how-to/silent-printing/silent-printing-batch-print.cs

using IronPrint;

// Collect all PDFs in the batch folder
string[] invoices = Directory.GetFiles(@"C:\Invoices\Pending", "*.pdf");

// Configure print settings for the batch
var settings = new PrintSettings
{
    PrinterName = "Accounting Printer",
    NumberOfCopies = 1,
    Grayscale = true
};

// Print each invoice and track successes
int successCount = 0;
foreach (string invoice in invoices)
{
    try
    {
        Printer.Print(invoice, settings);
        successCount++;
        Console.WriteLine($"Printed: {Path.GetFileName(invoice)}");
    }
    catch (Exception ex)
    {
        Console.WriteLine($"Failed: {Path.GetFileName(invoice)}: {ex.Message}");
    }
}

// Report batch results
Console.WriteLine($"Batch complete: {successCount}/{invoices.Length} documents printed.");

Imports IronPrint
Imports System.IO

' Collect all PDFs in the batch folder
Dim invoices As String() = Directory.GetFiles("C:\Invoices\Pending", "*.pdf")

' Configure print settings for the batch
Dim settings As New PrintSettings With {
    .PrinterName = "Accounting Printer",
    .NumberOfCopies = 1,
    .Grayscale = True
}

' Print each invoice and track successes
Dim successCount As Integer = 0
For Each invoice As String In invoices
    Try
        Printer.Print(invoice, settings)
        successCount += 1
        Console.WriteLine($"Printed: {Path.GetFileName(invoice)}")
    Catch ex As Exception
        Console.WriteLine($"Failed: {Path.GetFileName(invoice)}: {ex.Message}")
    End Try
Next

' Report batch results
Console.WriteLine($"Batch complete: {successCount}/{invoices.Length} documents printed.")

Otoczenie każdego wywołania Print() w try-catch gwarantuje, że pojedynczy uszkodzony plik lub przekroczenie limitu czasu drukarki nie zatrzyma całej partii. W przypadku dużych partii przetwarzanych w usługach działających w tle rejestrowanie każdego wyniku w bazie danych lub systemie monitorowania zapewnia ścieżkę audytu, którą mogą przeglądać zespoły operacyjne.

Jak drukować asynchronicznie bez blokowania wątku?

Metoda Printer.PrintAsync() zwraca Task, dzięki czemu jest kompatybilna z wzorcami await. Ma to kluczowe znaczenie w przypadku aplikacji z interfejsem użytkownika, w których blokujące wywołanie PRINT spowodowałoby zawieszenie interfejsu, oraz w przypadku usług obsługujących operacje współbieżne.

:path=/static-assets/print/content-code-examples/how-to/silent-printing/silent-printing-async-print.cs

using IronPrint;

// Print asynchronously without blocking the thread
await Printer.PrintAsync("report.pdf");

// Print a batch of reports asynchronously
string[] files = Directory.GetFiles(@"C:\Reports", "*.pdf");
foreach (string file in files)
{
    await Printer.PrintAsync(file);
}

Imports IronPrint

' Print asynchronously without blocking the thread
Await Printer.PrintAsync("report.pdf")

' Print a batch of reports asynchronously
Dim files As String() = Directory.GetFiles("C:\Reports", "*.pdf")
For Each file As String In files
    Await Printer.PrintAsync(file)
Next

PrintAsync() akceptuje te same parametry co Print() — ścieżkę do pliku lub tablicę bajtów oraz opcjonalny obiekt PrintSettings. Przeładowanie async zapobiega wyczerpaniu puli wątków w scenariuszach o dużej przepustowości, w których dziesiątki dokumentów czekają jednocześnie w kolejce do wydruku. Jest to zgodne z tym samym wzorcem asynchronicznym opartym na zadaniach, który jest zalecany w nowoczesnym programowaniu .NET.

Jakie są kwestie związane z platformą?

IronPrint obsługuje drukowanie w tle na platformach stacjonarnych i mobilnych, choć zachowanie różni się w zależności od systemu operacyjnego.

Na platformach mobilnych ograniczenia systemu operacyjnego uniemożliwiają prawdziwie ciche drukowanie — Printer.Print() wyświetli natywne okno dialogowe PRINT niezależnie od tego. W przypadku systemu Android przed każdą operacją PRINT wymagane jest wywołanie Printer.Initialize(Android.Content.Context). Platformy stacjonarne (Windows i macOS) obsługują w pełni automatyczne drukowanie w trybie cichym bez żadnych zastrzeżeń.

Jak to się ma do natywnego drukowania w .NET?

Dla zespołów inżynierów rozważających, czy wdrożyć bibliotekę, czy opierać się na natywnej przestrzeni nazw System.Drawing.Printing, kompromisy przedstawiają się następująco:

Podejście natywne sprawdza się w prostych scenariuszach, w których zespół dysponuje już infrastrukturą do renderowania dokumentów. Dla zespołów drukujących pliki PDF, obrazy lub HTML bez istniejącego kodu renderującego, IronPrint eliminuje tygodnie pracy programistycznej i bieżącej konserwacji. 30-procentowy wzrost szybkości drukowania wprowadzony w wydaniu z maja 2025 r. to rodzaj optymalizacji, której wdrożenie we własnym zakresie wymagałoby poświęcenia czasu inżynierów.

Kolejne kroki

Ciche drukowanie za pomocą IronPrint sprowadza się do trzech podstawowych metod: Printer.Print() dla synchronicznego cichego wydruku, Printer.PrintAsync() dla wykonywania bez blokowania oraz PrintSettings dla pełnej kontroli nad zadaniem drukowania. Łącznie obejmują one scenariusze drukowania pojedynczych dokumentów, drukowania wsadowego oraz drukowania równoległego na platformach stacjonarnych.

Zapoznaj się z samouczkami IronPrint, aby uzyskać bardziej szczegółowe instrukcje, lub przejrzyj Dokumentację API klasy Printer, aby zapoznać się z pełnym zestawem metod. Poradnik dotyczący ustawień drukowania obejmuje dodatkowe opcje konfiguracyjne, takie jak wybór tacy i spłaszczanie.

Rozpocznij bezpłatny 30-dniowy okres próbny, aby przetestować ciche drukowanie w rzeczywistym środowisku — nie jest wymagana karta kredytowa. Gdy wszystko będzie gotowe do wdrożenia, zapoznaj się z opcjami licencyjnymi, zaczynając od $999.

Porozmawiaj z inżynierem Iron Software, aby uzyskać pomoc w konkretnych scenariuszach wdrożeniowych.