1. IronPrint
  2. Tutoriais
  3. Configurações de impressão
Como configurar as definições de impressão em PDF usando C# | IronPrint

Como configurar as definições de impressão em C# com IronPrint

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

Configure as configurações de impressão em C# usando a classe PrintSettings do IronPrint para controlar o tamanho do papel, orientação, DPI, margens e mais. Basta instanciar PrintSettings, definir suas preferências e passá-lo para o método Print.

Início Rápido: Configurar Configurações de Impressão

  1. Instale o IronPrint via NuGet: Install-Package IronPrint
  2. Adicione using IronPrint; ao arquivo
  3. Crie um objeto PrintSettings
  4. Defina propriedades como PaperSize, Dpi, PaperOrientation, NumberOfCopies e Grayscale
  5. Passe as configurações para Printer.Print() ou Printer.ShowPrintDialog()

  1. Instale IronPrint com o Gerenciador de Pacotes NuGet

    PM > Install-Package IronPrint

  2. Copie e execute este trecho de código.

    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. Implante para testar em seu ambiente de produção.

    Comece a usar IronPrint em seu projeto hoje com uma avaliação gratuita

    arrow pointer
### Fluxo de trabalho mínimo (5 etapas)
  1. Instale a biblioteca de impressão IronPrint C#
  2. Crie um objeto `PrintSettings`
  3. Configure tamanho do papel, orientação, DPI, cópias e mais
  4. Passe as configurações para `Printer.Print()` ou `Printer.ShowPrintDialog()`
  5. Verifique se o documento impresso corresponde às suas configurações configuradas

Como configuro as definições de impressão?

Para configurar as definições de impressão, instancie a classe PrintSettings e configure-a de acordo com as suas preferências. Nos métodos Print ou ShowPrintDialog, passe o objeto PrintSettings como o segundo parâmetro. O exemplo de código abaixo ilustra esse uso. Para exemplos mais detalhados, consulte a página de exemplos de código de configurações de impressão .

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

Por que preciso configurar as definições de impressão?

Uma configuração de impressão refere-se a uma configuração ou conjunto de parâmetros que ditam como um documento ou conteúdo deve ser impresso. Essas configurações incluem detalhes como tamanho do papel, orientação (retrato ou paisagem), resolução de impressão (pontos por polegada - DPI), número de cópias, seleção da impressora, margens e opções como impressão em tons de cinza. Personalize essas configurações para atender às suas preferências e requisitos de impressão específicos.

Os recursos abrangentes de configuração de impressão do IronPrint oferecem aos desenvolvedores um controle preciso sobre todos os aspectos do processo de impressão. Seja no desenvolvimento de aplicações desktop ou aplicações web ASP.NET , uma configuração adequada garante resultados consistentes em diferentes ambientes.

Quando devo usar configurações de impressão personalizadas?

As configurações de impressão personalizadas são essenciais quando é necessário um controle preciso sobre a saída impressa, como ao imprimir relatórios com margens específicas, gerar várias cópias de documentos ou garantir que os documentos sejam impressos na orientação correta para as necessidades da empresa.

Aqui está um exemplo prático de impressão de faturas com requisitos específicos:

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

O que acontece se eu não especificar as configurações de impressão?

Se as configurações de impressão não forem especificadas, o IronPrint usará as configurações padrão da impressora padrão do seu sistema, que podem não corresponder ao formato de saída ou aos requisitos de qualidade desejados. Para descobrir as impressoras disponíveis em seu sistema, use o método GetPrinterNames para recuperar programaticamente todas as impressoras conectadas.

Quais são as configurações de impressão disponíveis?

Explore todas as opções de configuração de impressão disponíveis abaixo. A referência completa da API fornece documentação detalhada para cada propriedade e método:

Contexto Descrição Valor padrão Observações
Configurações padrão Inicializa uma nova instância da classe IronPrint com valores padrão. N / D N / D
Tamanho do papel Define o tamanho do papel usado pela impressora. IronPrint.PaperSize.PrinterDefault N / D
Orientação do Papel Especifica a orientação do papel (por exemplo, retrato ou paisagem). IronPrint.PaperOrientation.Portrait N / D
dpi Representa a resolução de impressão pretendida em pontos por polegada. 300 A resolução DPI real usada para impressão pode ser limitada pelas capacidades da impressora.
Número de cópias Indica o número de cópias idênticas a serem geradas ao imprimir um documento. 1 Em certas plataformas, podem existir limitações que impeçam a reprodução precisa de múltiplas cópias. Em tais casos, o valor especificado de IronPrint.PrintSettings.NumberOfCopies pode ser ignorado, resultando na impressão de apenas uma cópia
Nome da impressora Especifica o nome da impressora a ser usada para impressão. nulo (usa a impressora padrão do SO) Se você selecionar a impressora em uma caixa de diálogo de impressão, essa configuração será ignorada. Para obter os nomes de impressoras disponíveis, você pode usar IronPrint.Printer.GetPrinterNames ou IronPrint.Printer.GetPrinterNamesAsync para buscar a lista de nomes de impressoras
Margens do papel Define as margens a serem usadas na impressão em milímetros. nulo (usa as margens padrão da impressora) N / D
Escala de cinza Indica se a impressão deve ser em tons de cinza. falso (tentativas de impressão colorida) N / D
Achatar Achate o PDF antes de imprimir, o que é útil para exibir valores de campos de formulário e imagens. falso N / D
Bandeja Bandeja da impressora utilizada para a impressão. Isso permite que os usuários especifiquem uma bandeja específica da qual o papel deve ser alimentado na impressora. nulo (usa a bandeja padrão da impressora) Se você selecionar a bandeja em uma caixa de diálogo de impressão, essa configuração será ignorada. Para obter a bandeja disponível, você pode usar IronPrint.Printer.GetPrinterTrays(System.String) ou IronPrint.Printer.GetPrinterTraysAsync(System.String). Essa propriedade de seleção da bandeja está disponível apenas no Windows.

Quais configurações de impressão devo sempre configurar?

Para a maioria das aplicações empresariais, sempre configure PaperSize, PaperOrientation e Dpi para garantir uma saída consistente em diferentes impressoras e sistemas. Essas três configurações são as que mais impactam a aparência e a legibilidade do documento.

Ao trabalhar com impressão baseada em diálogo, combine configurações personalizadas com a interação do usuário usando o método 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);
$vbLabelText   $csharpLabel

Como faço para gerenciar as configurações específicas da plataforma?

Algumas configurações, como a seleção da bandeja do sistema, estão disponíveis apenas no Windows. Sempre verifique a compatibilidade da plataforma ao usar recursos específicos da plataforma e forneça um comportamento alternativo para aplicativos multiplataforma. Para solucionar problemas específicos da plataforma, consulte o guia de suporte de engenharia .

Quais são as combinações de configurações de impressão mais comuns?

As combinações mais comuns incluem A4/Retrato/300 DPI para documentos padrão, A3/Paisagem/600 DPI para relatórios detalhados e Carta/Retrato/300 DPI/Escala de cinza para impressão de rascunhos, visando economizar tinta.

Aqui está um exemplo que ilustra diferentes cenários:

// 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
};
$vbLabelText   $csharpLabel

Para exemplos mais abrangentes e cenários de impressão avançados, explore o tutorial de impressão de documentos , que abrange todo o fluxo de trabalho de impressão do início ao fim.

Ao implementar configurações de impressão em ambientes de produção, especialmente em aplicações web que utilizam o arquivo Web.config, consulte o guia sobre como configurar chaves de licença no Web.config para garantir a configuração correta.

Perguntas frequentes

Como configuro as opções de impressão em C#?

Para configurar as definições de impressão em C#, instancie a classe PrintSettings do IronPrint e defina propriedades como PaperSize, PaperOrientation, Dpi, NumberOfCopies e Grayscale. Em seguida, passe este objeto PrintSettings como segundo parâmetro para os métodos Print ou ShowPrintDialog.

Quais configurações de impressão posso personalizar?

A classe PrintSettings do IronPrint permite personalizar o tamanho do papel (A4, Carta, etc.), a orientação (Retrato/Paisagem), a resolução DPI, o número de cópias, a seleção da impressora, as margens do papel e as opções de impressão em tons de cinza.

Como faço para definir o tamanho e a orientação do papel?

Defina o tamanho do papel usando a propriedade PaperSize (por exemplo, PaperSize.A4) e a orientação usando a propriedade PaperOrientation (por exemplo, PaperOrientation.Landscape) no objeto PrintSettings do IronPrint antes de chamar o método Print.

Posso imprimir várias cópias de um documento?

Sim, você pode imprimir várias cópias definindo a propriedade NumberOfCopies na classe PrintSettings. Por exemplo, settings.NumberOfCopies = 2 imprimirá duas cópias do seu documento usando o IronPrint.

Como faço para definir margens personalizadas para impressão?

Defina margens personalizadas usando a propriedade PaperMargins em PrintSettings com a classe Margins. Por exemplo: settings.PaperMargins = new Margins(10, 10, 10, 10) define margens de 10 mm em todos os lados ao imprimir com IronPrint.

Posso imprimir em tons de cinza em vez de colorido?

Sim, habilite a impressão em tons de cinza definindo a propriedade Grayscale como true no objeto PrintSettings. Isso converterá documentos coloridos para tons de cinza ao imprimir pelo IronPrint.

Curtis Chau
Curtis Chau
  Converse agora mesmo com a equipe de engenharia.
Redator Técnico

Curtis Chau é bacharel em Ciência da Computação (Universidade Carleton) e se especializa em desenvolvimento front-end, com experiência em Node.js, TypeScript, JavaScript e React. Apaixonado por criar interfaces de usuário intuitivas e esteticamente agradáveis, Curtis gosta de trabalhar com frameworks modernos e criar manuais ...

Leia mais
Pronto para começar?
Nuget Downloads 38,093 | Versão: 2026.3 acaba de ser lançado
Still Scrolling Icon

Ainda está rolando a tela?

Quer provas rápidas? PM > Install-Package IronPrint
executar um exemplo Veja seu documento chegar à impressora.