Jak skonfigurować ustawienia drukowania w C# z IronPrint

Updated: 4 czerwca 2026

Skonfiguruj ustawienia drukowania w C# za pomocą klasy PrintSettings IronPrint, aby kontrolować rozmiar papieru, orientację, DPI, marginesy i inne. Po prostu utwórz instancję PrintSettings, ustaw swoje preferencje i przekaż do metody Print.

Szybki start: Konfiguracja ustawień drukowania

Zainstaluj IronPrint przez NuGet: Install-Package IronPrint
Dodaj using IronPrint; do pliku
Utwórz obiekt PrintSettings
Ustaw właściwości jak PaperSize, Dpi, PaperOrientation, NumberOfCopies i Grayscale
Przekaż ustawienia do Printer.Print() lub Printer.ShowPrintDialog()

1Install IronPrint with NuGet Package Manager
PM > Install-Package IronPrint
```
Install-Package IronPrint
```

2Skopiuj i uruchom ten fragment kodu.

using IronPrint;

// Print with custom settings
Printer.Print("document.pdf", new PrintSettings
{
    PaperSize = PaperSize.A4,
    PaperOrientation = PaperOrientation.Landscape,
    Dpi = 300,
    NumberOfCopies = 2,
    Grayscale = true
});

using IronPrint;

// Print with custom settings
Printer.Print("document.pdf", new PrintSettings
{
    PaperSize = PaperSize.A4,
    PaperOrientation = PaperOrientation.Landscape,
    Dpi = 300,
    NumberOfCopies = 2,
    Grayscale = true
});

3Wdrożenie do testowania w środowisku produkcyjnym

Rozpocznij używanie IronPrint w swoim projekcie już dziś z darmową wersją próbną

Minimalny proces (5 kroków)

Zainstaluj bibliotekę IronPrint C#
Utwórz obiekt PrintSettings
Skonfiguruj rozmiar papieru, orientację, DPI, kopie i więcej
Przekaż ustawienia do Printer.Print() lub Printer.ShowPrintDialog()
Zweryfikuj, czy wydrukowany dokument odpowiada skonfigurowanym ustawieniom

Jak ustawić ustawienia drukowania?

Aby skonfigurować ustawienia drukowania, zainstaluj klasę PrintSettings i skonfiguruj ją zgodnie z preferencjami. W metodach Print lub ShowPrintDialog przekaż obiekt PrintSettings jako drugi parametr. Poniższy przykład kodu ilustruje to użycie. Aby uzyskać bardziej szczegółowe przykłady, odwiedź stronę przykłady kodu ustawień drukowania.

// Import the necessary namespace for IronPrint
using IronPrint;

// Initialize a new instance of the PrintSettings class
PrintSettings settings = new PrintSettings();

// Configure various print settings
settings.PaperSize = PaperSize.A4;                // Set paper size to A4
settings.PaperOrientation = PaperOrientation.Landscape; // Set paper orientation to Landscape
settings.Dpi = 300;                               // Set print resolution to 300 DPI
settings.NumberOfCopies = 2;                      // Set the number of copies to 2
settings.PrinterName = "MyPrinter";               // Set the name of the printer
settings.PaperMargins = new Margins(10, 10, 10, 10); // Set margins to 10mm on each side
settings.Grayscale = true;                        // Print in grayscale

// Use the PrintSettings in the Print method
IronPrint.Printer.Print(document, settings);

// Import the necessary namespace for IronPrint
using IronPrint;

// Initialize a new instance of the PrintSettings class
PrintSettings settings = new PrintSettings();

// Configure various print settings
settings.PaperSize = PaperSize.A4;                // Set paper size to A4
settings.PaperOrientation = PaperOrientation.Landscape; // Set paper orientation to Landscape
settings.Dpi = 300;                               // Set print resolution to 300 DPI
settings.NumberOfCopies = 2;                      // Set the number of copies to 2
settings.PrinterName = "MyPrinter";               // Set the name of the printer
settings.PaperMargins = new Margins(10, 10, 10, 10); // Set margins to 10mm on each side
settings.Grayscale = true;                        // Print in grayscale

// Use the PrintSettings in the Print method
IronPrint.Printer.Print(document, settings);

' Import the necessary namespace for IronPrint
Imports IronPrint

' Initialize a new instance of the PrintSettings class
Private settings As New PrintSettings()

' Configure various print settings
settings.PaperSize = PaperSize.A4 ' Set paper size to A4
settings.PaperOrientation = PaperOrientation.Landscape ' Set paper orientation to Landscape
settings.Dpi = 300 ' Set print resolution to 300 DPI
settings.NumberOfCopies = 2 ' Set the number of copies to 2
settings.PrinterName = "MyPrinter" ' Set the name of the printer
settings.PaperMargins = New Margins(10, 10, 10, 10) ' Set margins to 10mm on each side
settings.Grayscale = True ' Print in grayscale

' Use the PrintSettings in the Print method
IronPrint.Printer.Print(document, settings)

' Import the necessary namespace for IronPrint
Imports IronPrint

' Initialize a new instance of the PrintSettings class
Private settings As New PrintSettings()

' Configure various print settings
settings.PaperSize = PaperSize.A4 ' Set paper size to A4
settings.PaperOrientation = PaperOrientation.Landscape ' Set paper orientation to Landscape
settings.Dpi = 300 ' Set print resolution to 300 DPI
settings.NumberOfCopies = 2 ' Set the number of copies to 2
settings.PrinterName = "MyPrinter" ' Set the name of the printer
settings.PaperMargins = New Margins(10, 10, 10, 10) ' Set margins to 10mm on each side
settings.Grayscale = True ' Print in grayscale

' Use the PrintSettings in the Print method
IronPrint.Printer.Print(document, settings)

Dlaczego potrzebuję skonfigurować ustawienia drukowania?

Ustawienie drukowania odnosi się do konfiguracji lub zestawu parametrów, które decydują o tym, jak dokument lub treść powinna być drukowana. Te ustawienia obejmują szczegóły takie jak rozmiar papieru, orientacja (pionowa lub pozioma), rozdzielczość wydruku (punkty na cal - DPI), liczba kopii, wybór drukarki, marginesy i opcje, takie jak druk w odcieniach szarości. Dostosuj te ustawienia, aby osiągnąć określone preferencje i wymagania dotyczące drukowania.

Obszerne funkcje ustawień drukowania IronPrint zapewniają programistom precyzyjną kontrolę nad każdym aspektem procesu drukowania. Czy to budując aplikacje desktopowe, czy aplikacje internetowe ASP.NET, odpowiednia konfiguracja zapewnia spójne wyniki w różnych środowiskach.

Kiedy powinienem używać niestandardowych ustawień drukowania?

Niestandardowe ustawienia drukowania są niezbędne, gdy potrzebna jest precyzyjna kontrola nad wydrukiem, na przykład przy drukowaniu raportów z określonymi marginesami, generowaniu wielu kopii dokumentów lub zapewnieniu, że dokumenty są drukowane w odpowiedniej orientacji dla potrzeb biznesowych.

Oto praktyczny przykład drukowania faktur z określonymi wymaganiami:

// Example: Printing invoices with business requirements
using IronPrint;

// Invoice printing with specific business settings
var invoiceSettings = new PrintSettings
{
    PaperSize = PaperSize.Letter,        // US Letter size for business documents
    PaperOrientation = PaperOrientation.Portrait,
    Dpi = 600,                           // High quality for professional output
    NumberOfCopies = 3,                  // Original + customer copy + file copy
    PaperMargins = new Margins(15, 15, 15, 25), // Extra bottom margin for footer
    Grayscale = false,                   // Keep company logo in color
    PrinterName = "Office Color Printer" // Specific high-quality printer
};

// Print the invoice
Printer.Print("invoice_2024_001.pdf", invoiceSettings);

// Example: Printing invoices with business requirements
using IronPrint;

// Invoice printing with specific business settings
var invoiceSettings = new PrintSettings
{
    PaperSize = PaperSize.Letter,        // US Letter size for business documents
    PaperOrientation = PaperOrientation.Portrait,
    Dpi = 600,                           // High quality for professional output
    NumberOfCopies = 3,                  // Original + customer copy + file copy
    PaperMargins = new Margins(15, 15, 15, 25), // Extra bottom margin for footer
    Grayscale = false,                   // Keep company logo in color
    PrinterName = "Office Color Printer" // Specific high-quality printer
};

// Print the invoice
Printer.Print("invoice_2024_001.pdf", invoiceSettings);

Imports IronPrint

' Invoice printing with specific business settings
Dim invoiceSettings As New PrintSettings With {
    .PaperSize = PaperSize.Letter,        ' US Letter size for business documents
    .PaperOrientation = PaperOrientation.Portrait,
    .Dpi = 600,                           ' High quality for professional output
    .NumberOfCopies = 3,                  ' Original + customer copy + file copy
    .PaperMargins = New Margins(15, 15, 15, 25), ' Extra bottom margin for footer
    .Grayscale = False,                   ' Keep company logo in color
    .PrinterName = "Office Color Printer" ' Specific high-quality printer
}

' Print the invoice
Printer.Print("invoice_2024_001.pdf", invoiceSettings)

Imports IronPrint

' Invoice printing with specific business settings
Dim invoiceSettings As New PrintSettings With {
    .PaperSize = PaperSize.Letter,        ' US Letter size for business documents
    .PaperOrientation = PaperOrientation.Portrait,
    .Dpi = 600,                           ' High quality for professional output
    .NumberOfCopies = 3,                  ' Original + customer copy + file copy
    .PaperMargins = New Margins(15, 15, 15, 25), ' Extra bottom margin for footer
    .Grayscale = False,                   ' Keep company logo in color
    .PrinterName = "Office Color Printer" ' Specific high-quality printer
}

' Print the invoice
Printer.Print("invoice_2024_001.pdf", invoiceSettings)

Co się stanie, jeśli nie określę ustawień drukowania?

Jeśli ustawienia drukowania nie zostaną określone, IronPrint użyje domyślnych ustawień domyślnej drukarki systemowej, które mogą nie odpowiadać zamierzonej formatowi wyjściowemu lub wymaganiom jakościowym. Aby odkryć dostępne drukarki w systemie, użyj metody GetPrinterNames do programowego pobrania wszystkich podłączonych drukarek.

Jakie ustawienia drukowania są dostępne?

Odkryj wszystkie dostępne opcje ustawień drukowania poniżej. Pełna dokumentacja API zawiera szczegółową dokumentację dla każdej właściwości i metody:

Ustawienie	Opis	Wartość domyślna	Uwagi
`DefaultSettings`	Inicjalizuje nową instancję klasy IronPrint.PrintSettings z wartościami domyślnymi	Nie dotyczy	Nie dotyczy
`PaperSize`	Ustawia rozmiar papieru używanego przez drukarkę	IronPrint.PaperSize.PrinterDefault	Nie dotyczy
`PaperOrientation`	Określa orientację papieru (np. Pionowa lub Pozioma)	IronPrint.PaperOrientation.Portrait	Nie dotyczy
`Dpi`	Reprezentuje planowaną rozdzielczość wydruku w punktach na cal	300	Rzeczywiste DPI używane do drukowania może być ograniczone możliwościami drukarki
`NumberOfCopies`	Wskazuje liczbę identycznych kopii, które mają być wygenerowane w trakcie drukowania dokumentu	1	Na niektórych platformach mogą występować ograniczenia, które uniemożliwiają dokładne powielanie wielu kopii. W takich przypadkach, określona wartość `IronPrint.PrintSettings.NumberOfCopies` może zostać zignorowana, w wyniku czego wydrukowana zostaje tylko jedna kopia
`PrinterName`	Określa nazwę drukarki do użycia podczas drukowania	null (używa domyślnej drukarki systemu operacyjnego)	Jeśli wybierzesz drukarkę w oknie dialogowym drukowania, to ustawienie zostanie zignorowane. Aby uzyskać dostępne nazwy drukarek, można użyć `IronPrint.Printer.GetPrinterNames` lub `IronPrint.Printer.GetPrinterNamesAsync`, aby pobrać listę nazw drukarek
`PaperMargins`	Ustawia marginesy używane do drukowania w milimetrach	null (używa domyślnych marginesów drukarki)	Nie dotyczy
`Grayscale`	Wskazuje, czy drukować w odcieniach szarości	false (próbuje drukować w kolorze)	Nie dotyczy
`Flatten`	Spłaszcza PDF przed drukowaniem, co jest przydatne do wyświetlania wartości pól formularzy i obrazów	false	Nie dotyczy
`Tray`	Taca drukarki używana do zadania drukowania. Pozwala użytkownikom określić, z której konkretnej tacy papier ma być podawany do drukarki	null (używa domyślnej tacy drukarki)	Jeśli wybierzesz tacę w oknie dialogowym drukowania, to ustawienie zostanie zignorowane. Aby uzyskać dostęp do dostępnej tacy, można użyć `IronPrint.Printer.GetPrinterTrays(System.String)` lub `IronPrint.Printer.GetPrinterTraysAsync(System.String)`. Ta właściwość wyboru z paska zadań jest dostępna tylko w systemie Windows

Jakie ustawienia drukowania należy zawsze konfigurować?

Dla większości aplikacji biznesowych zawsze należy skonfigurować PaperSize, PaperOrientation i Dpi, aby zapewnić spójne wyniki na różnych drukarkach i systemach. Te trzy ustawienia mają największy wpływ na wygląd i czytelność dokumentu.

Podczas pracy z drukowaniem opartym na oknie dialogowym należy połączyć ustawienia niestandardowe z interakcją użytkownika za pomocą metody ShowPrintDialog:

// Pre-configure settings but allow user to modify
var presetSettings = new PrintSettings
{
    PaperSize = PaperSize.A4,
    PaperOrientation = PaperOrientation.Portrait,
    Dpi = 300
};

// Show dialog with preset values
Printer.ShowPrintDialog("report.pdf", presetSettings);

// Pre-configure settings but allow user to modify
var presetSettings = new PrintSettings
{
    PaperSize = PaperSize.A4,
    PaperOrientation = PaperOrientation.Portrait,
    Dpi = 300
};

// Show dialog with preset values
Printer.ShowPrintDialog("report.pdf", presetSettings);

Imports System

' Pre-configure settings but allow user to modify
Dim presetSettings As New PrintSettings With {
    .PaperSize = PaperSize.A4,
    .PaperOrientation = PaperOrientation.Portrait,
    .Dpi = 300
}

' Show dialog with preset values
Printer.ShowPrintDialog("report.pdf", presetSettings)

Imports System

' Pre-configure settings but allow user to modify
Dim presetSettings As New PrintSettings With {
    .PaperSize = PaperSize.A4,
    .PaperOrientation = PaperOrientation.Portrait,
    .Dpi = 300
}

' Show dialog with preset values
Printer.ShowPrintDialog("report.pdf", presetSettings)

Jak postępować z ustawieniami specyficznymi dla platformy?

Niektóre ustawienia, takie jak wybór tacy, są dostępne tylko w systemie Windows. Zawsze sprawdzaj zgodność platformy podczas korzystania z funkcji specyficznych dla danej platformy i zapewnij zachowanie awaryjne dla aplikacji wielopłatformowych. W celu rozwiązywania problemów związanych z konkretną platformą należy zapoznać się z przewodnikiem pomocy technicznej.

Jakie są typowe kombinacje ustawień drukowania?

Typowe kombinacje to A4/pion/300 DPI dla standardowych dokumentów, A3/poziomy/600 DPI dla szczegółowych raportów oraz Letter/pion/300 DPI/skala szarości dla wydruków roboczych w celu oszczędzania atramentu.

Oto przykład przedstawiający różne scenariusze:

// Standard office document
var standardDocument = new PrintSettings
{
    PaperSize = PaperSize.A4,
    PaperOrientation = PaperOrientation.Portrait,
    Dpi = 300
};

// Detailed engineering drawing
var technicalDrawing = new PrintSettings
{
    PaperSize = PaperSize.A3,
    PaperOrientation = PaperOrientation.Landscape,
    Dpi = 600,
    Grayscale = false
};

// Draft mode for review
var draftMode = new PrintSettings
{
    PaperSize = PaperSize.Letter,
    PaperOrientation = PaperOrientation.Portrait,
    Dpi = 150,
    Grayscale = true,
    NumberOfCopies = 5
};

// High-volume batch printing
var batchPrint = new PrintSettings
{
    PaperSize = PaperSize.A4,
    PaperOrientation = PaperOrientation.Portrait,
    Dpi = 300,
    NumberOfCopies = 100,
    Tray = "Tray 2" // Large capacity tray on Windows
};

// Standard office document
var standardDocument = new PrintSettings
{
    PaperSize = PaperSize.A4,
    PaperOrientation = PaperOrientation.Portrait,
    Dpi = 300
};

// Detailed engineering drawing
var technicalDrawing = new PrintSettings
{
    PaperSize = PaperSize.A3,
    PaperOrientation = PaperOrientation.Landscape,
    Dpi = 600,
    Grayscale = false
};

// Draft mode for review
var draftMode = new PrintSettings
{
    PaperSize = PaperSize.Letter,
    PaperOrientation = PaperOrientation.Portrait,
    Dpi = 150,
    Grayscale = true,
    NumberOfCopies = 5
};

// High-volume batch printing
var batchPrint = new PrintSettings
{
    PaperSize = PaperSize.A4,
    PaperOrientation = PaperOrientation.Portrait,
    Dpi = 300,
    NumberOfCopies = 100,
    Tray = "Tray 2" // Large capacity tray on Windows
};

Imports System

' Standard office document
Dim standardDocument As New PrintSettings With {
    .PaperSize = PaperSize.A4,
    .PaperOrientation = PaperOrientation.Portrait,
    .Dpi = 300
}

' Detailed engineering drawing
Dim technicalDrawing As New PrintSettings With {
    .PaperSize = PaperSize.A3,
    .PaperOrientation = PaperOrientation.Landscape,
    .Dpi = 600,
    .Grayscale = False
}

' Draft mode for review
Dim draftMode As New PrintSettings With {
    .PaperSize = PaperSize.Letter,
    .PaperOrientation = PaperOrientation.Portrait,
    .Dpi = 150,
    .Grayscale = True,
    .NumberOfCopies = 5
}

' High-volume batch printing
Dim batchPrint As New PrintSettings With {
    .PaperSize = PaperSize.A4,
    .PaperOrientation = PaperOrientation.Portrait,
    .Dpi = 300,
    .NumberOfCopies = 100,
    .Tray = "Tray 2" ' Large capacity tray on Windows
}

Imports System

' Standard office document
Dim standardDocument As New PrintSettings With {
    .PaperSize = PaperSize.A4,
    .PaperOrientation = PaperOrientation.Portrait,
    .Dpi = 300
}

' Detailed engineering drawing
Dim technicalDrawing As New PrintSettings With {
    .PaperSize = PaperSize.A3,
    .PaperOrientation = PaperOrientation.Landscape,
    .Dpi = 600,
    .Grayscale = False
}

' Draft mode for review
Dim draftMode As New PrintSettings With {
    .PaperSize = PaperSize.Letter,
    .PaperOrientation = PaperOrientation.Portrait,
    .Dpi = 150,
    .Grayscale = True,
    .NumberOfCopies = 5
}

' High-volume batch printing
Dim batchPrint As New PrintSettings With {
    .PaperSize = PaperSize.A4,
    .PaperOrientation = PaperOrientation.Portrait,
    .Dpi = 300,
    .NumberOfCopies = 100,
    .Tray = "Tray 2" ' Large capacity tray on Windows
}

Aby zapoznać się z bardziej kompleksowymi przykładami i zaawansowanymi scenariuszami drukowania, zapoznaj się z samouczkiem dotyczącym drukowania dokumentów, który obejmuje cały proces drukowania od początku do końca.

Podczas wdrażania ustawień drukowania w środowiskach produkcyjnych, zwłaszcza w aplikacjach internetowych korzystających z pliku Web.config, zapoznaj się z przewodnikiem dotyczącym ustawiania kluczy licencyjnych w pliku Web.config, aby zapewnić prawidłową konfigurację.

Często Zadawane Pytania

Jak skonfigurować ustawienia drukowania w C#?

Aby skonfigurować ustawienia drukowania w C#, zainicjalizuj klasę PrintSettings z IronPrint i ustaw właściwości takie jak PaperSize, PaperOrientation, Dpi, NumberOfCopies i Grayscale. Następnie przekaż ten obiekt PrintSettings jako drugi parametr do metody Print lub ShowPrintDialog.

Jakie ustawienia drukowania mogę dostosować?

Klasa PrintSettings z IronPrint pozwala na dostosowanie rozmiaru papieru (A4, Letter itp.), orientacji (Pionowa/Pozioma), rozdzielczości DPI, liczby kopii, wyboru drukarki, marginesów papieru i opcji drukowania w odcieniach szarości.

Jak ustawić rozmiar papieru i orientację?

Ustaw rozmiar papieru używając właściwości PaperSize (np. PaperSize.A4) i orientację używając właściwości PaperOrientation (np. PaperOrientation.Landscape) w obiekcie PrintSettings z IronPrint przed wywołaniem metody Print.

Czy mogę wydrukować wiele kopii dokumentu?

Tak, możesz wydrukować wiele kopii, ustawiając właściwość NumberOfCopies w klasie PrintSettings. Na przykład, ustawienie settings.NumberOfCopies = 2 wydrukuje dwie kopie dokumentu za pomocą IronPrint.

Jak ustawić niestandardowe marginesy do drukowania?

Ustaw niestandardowe marginesy, używając właściwości PaperMargins w PrintSettings z klasą Margins. Na przykład: settings.PaperMargins = new Margins(10, 10, 10, 10) ustawia marginesy 10 mm po każdej stronie podczas drukowania z IronPrint.

Czy mogę drukować w odcieniach szarości zamiast w kolorze?

Tak, umożliw drukowanie w odcieniach szarości, ustawiając właściwość Grayscale na true w obiekcie PrintSettings. Przekształci to kolorowe dokumenty w odcienie szarości podczas drukowania z IronPrint.

How can I handle platform-specific print settings with IronPrint?

Check platform compatibility when using settings like Tray selection, which is only available on Windows. Provide fallback options for cross-platform applications.

Why is it important to configure print settings?

Configuring print settings is crucial to ensure documents print as intended with specific parameters like paper size, margins, and quality, maintaining consistency across different environments.

Can I allow users to modify print settings during the print process?

Yes, you can use the `ShowPrintDialog` method to pre-configure settings and allow users to modify them before printing.

What options are available for printing multiple copies of a document?

You can print multiple copies by setting the `NumberOfCopies` property in the `PrintSettings` class. Note that some platforms may have limitations on reproducing multiple copies.

Curtis Chau

Czat z zespołem inżynierów teraz

Autor tekstów technicznych

Curtis Chau posiada tytuł licencjata z informatyki (Uniwersytet Carleton) i specjalizuje się w front-endowym rozwoju, z ekspertką w Node.js, TypeScript, JavaScript i React. Pasjonuje się tworzeniem intuicyjnych i estetycznie przyjemnych interfejsów użytkownika, Curtis cieszy się pracą z nowoczesnymi frameworkami i tworzeniem dobrze zorganizowanych, atrakcyjnych wizualnie podręczników.

...

Czytaj więcej