1. IronPrint
  2. Tutoriais
  3. Defina o tamanho do papel

Como Definir o Tamanho do Papel para Impressão em C#

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

A classe PrintSettings do IronPrint dá aos desenvolvedores controle direto sobre o tamanho do papel através da propriedade PaperSize. Atribuímos um valor do enum PaperSize — como PaperSize.A4 ou PaperSize.Letter — e passamos o objeto PrintSettings configurado para qualquer um dos métodos de impressão do IronPrint. A impressora então usa exatamente aquele tamanho de papel para o trabalho.

Este guia percorre a configuração de tamanhos de papel padrão, combinando tamanho com outras configurações de impressão e imprimindo de forma assíncrona — tudo com código C# funcional.

Início Rápido: Defina o Tamanho do Papel

  1. Instale o IronPrint via NuGet: Install-Package IronPrint
  2. Adicione using IronPrint; ao arquivo
  3. Crie um objeto PrintSettings
  4. Defina PaperSize para qualquer valor do enum PaperSize (por exemplo, PaperSize.A4)
  5. Passe as configurações para Printer.Print() ou Printer.PrintAsync()

  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 a PDF on A4 paper
Printer.Print("report.pdf", new PrintSettings
{
    PaperSize = PaperSize.A4
});

  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. Defina `PaperSize` a partir do enum `PaperSize`
  4. Passe as configurações para `Printer.Print()`
  5. Execute o projeto para imprimir no tamanho de papel selecionado

Como Defino o Tamanho do Papel ao Imprimir em C#?

Definimos o tamanho do papel atribuindo um valor do enum PaperSize à propriedade PaperSize em um objeto PrintSettings. Em seguida, passamos esse objeto para qualquer um dos métodos de impressão do IronPrint.

:path=/static-assets/print/content-code-examples/how-to/set-paper-size/set-paper-size.cs
// ESTE TRECHO DE CÓDIGO NÃO ESTÁ DISPONÍVEL!
$vbLabelText   $csharpLabel

Primeiro instanciamos PrintSettings, que é inicializado com os padrões da impressora. Em seguida, substituímos PaperSize por PaperSize.Letter, que corresponde ao formato padrão de 8,5 × 11 polegadas. Quando chamamos Printer.Print, o IronPrint envia o documento para a impressora padrão do sistema usando esse tamanho de papel.

Se nenhum PaperSize for especificado, o IronPrint usa PaperSize.PrinterDefault, que usa qualquer tamanho de papel que a impressora padrão do sistema operacional estiver configurada para usar. Este é um detalhe essencial para ambientes de produção onde as configurações das impressoras variam entre as máquinas.

Quais Tamanhos de Papel a Biblioteca Suporta?

O enum PaperSize inclui doze valores que cobrem padrões internacionais ISO, tamanhos comuns dos EUA, e o padrão da impressora. A tabela abaixo lista todas as opções disponíveis.

Valor do Enum Padrão Dimensões (mm) Dimensões (pol)
PaperSize.A0 ISO A0 841 × 1189 33.1 × 46.8
PaperSize.A1 ISO A1 594 × 841 23.4 × 33.1
PaperSize.A2 ISO A2 420 × 594 16.5 × 23.4
PaperSize.A3 ISO A3 297 × 420 11.7 × 16.5
PaperSize.A4 ISO A4 210 × 297 8.3 × 11.7
PaperSize.A5 ISO A5 148 × 210 5.8 × 8.3
PaperSize.B4 ISO B4 250 × 353 9,8 × 13,9
PaperSize.B5 ISO B5 176 × 250 6,9 × 9,8
PaperSize.Letter Carta dos EUA 216 × 279 8,5 × 11,0
PaperSize.Legal Legal dos EUA 216 × 356 8,5 × 14,0
PaperSize.Executive Executivo dos EUA 184 × 267 7,25 × 10,5
PaperSize.PrinterDefault Padrão da impressora Varia Varia

Cada valor mapeia diretamente para um padrão de papel bem conhecido. A opção PrinterDefault instrui o IronPrint a usar qualquer tamanho que a impressora esteja atualmente configurada — útil quando você deseja respeitar as preferências da impressora do usuário final em vez de impor um formato específico.

Para uma referência completa da API, consulte a documentação da classe PaperSize.

Como combinar o tamanho do papel com outras configurações de impressão?

A classe PrintSettings expõe várias propriedades além de PaperSize. Podemos configurar orientação, DPI, margens, contagem de cópias e modo em escala de cinza — tudo em um único objeto.

:path=/static-assets/print/content-code-examples/how-to/set-paper-size/combined-settings.cs
// ESTE TRECHO DE CÓDIGO NÃO ESTÁ DISPONÍVEL!
$vbLabelText   $csharpLabel

Usamos a sintaxe de inicializador de objeto aqui para clareza. PaperOrientation.Landscape gira a folha A4 para o seu eixo mais largo. Dpi a 300 garante uma saída nítida para gráficos e textos finos. PaperMargins aceita quatro valores em milímetros — superior, direito, inferior, esquerdo — através do construtor Margins. A propriedade Grayscale tem como padrão false, mas a definimos explicitamente para melhor legibilidade.

Essas propriedades funcionam juntas sem conflito. O IronPrint valida a configuração e passa as configurações combinadas para o driver da impressora como um único trabalho de impressão. Para configurações mais avançadas, como seleção de impressora e configuração de bandeja, consulte o guia completo de configurações de impressão.

Como imprimir de forma assíncrona com um tamanho de papel personalizado?

Para aplicativos onde bloquear a thread principal não é uma opção — como aplicativos WPF ou WinForms — usamos Printer.PrintAsync. O método aceita o mesmo objeto PrintSettings e retorna um Task.

:path=/static-assets/print/content-code-examples/how-to/set-paper-size/async-print.cs
// ESTE TRECHO DE CÓDIGO NÃO ESTÁ DISPONÍVEL!
$vbLabelText   $csharpLabel

Este exemplo baseado em classes demonstra um padrão realista onde um serviço DocumentPrinter envolve a lógica de impressão. Configuramos PaperSize.Legal (8,5 × 14 polegadas), que é o formato padrão para contratos e registros jurídicos. A palavra-chave await garante que a thread que faz chamada permaneça responsiva enquanto o IronPrint processa o trabalho de impressão.

Podemos chamar este método a partir de um manipulador de clique de botão, um serviço em segundo plano, ou em qualquer lugar que await seja suportado. Os métodos assíncronos do IronPrint — incluindo PrintAsync e ShowPrintDialogAsync — aceitam a mesma configuração PrintSettings, assim o comportamento do tamanho do papel é idêntico entre caminhos síncronos e assíncronos.

Quais são os meus próximos passos?

Cobrimos como definir o tamanho do papel em C# usando o enum PaperSize do IronPrint, desde a configuração básica de uma única propriedade até configurações combinadas e impressão assíncrona. A classe PrintSettings fornece uma API limpa e fortemente tipada que elimina suposições em torno das dimensões do papel.

Para continuar explorando as capacidades do IronPrint:

Inicie um teste gratuito de 30 dias para testar a configuração do tamanho do papel em seus próprios projetos, ou veja opções de licenciamento para implantação em produção.

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.