Jak skonfigurować ustawienia drukowania w pliku PDF przy użyciu języka C# | IronPrint

Jak skonfigurować ustawienia drukowania w C# z IronPrint

This article was translated from English: Does it need improvement?
Translated
View the article in English

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

Szybki start: Konfiguracja ustawień drukowania

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

    PM > Install-Package IronPrint
  2. Skopiuj 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
    });
  3. Wdrożenie do testowania w środowisku produkcyjnym

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

    arrow pointer

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)
$vbLabelText   $csharpLabel

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

' Example: Printing invoices with business requirements

' 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)
$vbLabelText   $csharpLabel

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, co skutkuje wydrukowaniem tylko jednej kopii
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żesz 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ępne tace, możesz 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ć?

W większości aplikacji biznesowych zawsze konfiguruj 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)
$vbLabelText   $csharpLabel

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 wieloplatformowych. 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
}
$vbLabelText   $csharpLabel

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.

Curtis Chau
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ę...

Czytaj więcej
Gotowy, aby rozpocząć?
Nuget Pliki do pobrania 38,948 | Wersja: 2026.4 just released
Still Scrolling Icon

Wciąż przewijasz?

Czy chcesz szybko dowodu? PM > Install-Package IronPrint
uruchom próbkę obserwuj, jak twój dokument trafia do drukarki.