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

Updated: 29 de junho de 2026

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 configurado PrintSettings 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

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

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

2Copie e execute este trecho de código.

using IronPrint;

// Print a PDF on A4 paper
Printer.Print("report.pdf", new PrintSettings
{
    PaperSize = PaperSize.A4
});

using IronPrint;

// Print a PDF on A4 paper
Printer.Print("report.pdf", new PrintSettings
{
    PaperSize = PaperSize.A4
});

3Implante para testar em seu ambiente de produção.

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

Fluxo de trabalho mínimo (5 etapas)

Instale a biblioteca de impressão IronPrint C#
Crie um objeto PrintSettings
Defina PaperSize a partir do enum PaperSize
Passe as configurações para Printer.Print()
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.

using IronPrint;

// Configure print settings with US Letter paper
PrintSettings settings = new PrintSettings();
settings.PaperSize = PaperSize.Letter;

// Print to the default printer
Printer.Print("invoice.pdf", settings);

using IronPrint;

// Configure print settings with US Letter paper
PrintSettings settings = new PrintSettings();
settings.PaperSize = PaperSize.Letter;

// Print to the default printer
Printer.Print("invoice.pdf", settings);

Imports IronPrint

' Configure print settings with US Letter paper
Dim settings As New PrintSettings()
settings.PaperSize = PaperSize.Letter

' Print to the default printer
Printer.Print("invoice.pdf", settings)

Imports IronPrint

' Configure print settings with US Letter paper
Dim settings As New PrintSettings()
settings.PaperSize = PaperSize.Letter

' Print to the default printer
Printer.Print("invoice.pdf", settings)

Primeiro instanciamos PrintSettings, que inicializa com os padrões da impressora. Em seguida, substituímos PaperSize por PaperSize.Letter, que mapeia para o 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 aquele tamanho de papel.

Se nenhum PaperSize for especificado, o IronPrint usa PaperSize.PrinterDefault, que delega ao tamanho de papel que a impressora padrão do sistema operacional está 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 abrangem 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 informa ao IronPrint para usar o tamanho que a impressora está atualmente configurada — útil quando você deseja respeitar as preferências de impressão 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.

using IronPrint;

// Configure full print settings
PrintSettings settings = new PrintSettings
{
    PaperSize = PaperSize.A4,
    PaperOrientation = PaperOrientation.Landscape,
    Dpi = 300,
    NumberOfCopies = 3,
    PaperMargins = new Margins(15, 15, 15, 15),
    Grayscale = false
};

// Print the quarterly report
Printer.Print("quarterly-report.pdf", settings);

using IronPrint;

// Configure full print settings
PrintSettings settings = new PrintSettings
{
    PaperSize = PaperSize.A4,
    PaperOrientation = PaperOrientation.Landscape,
    Dpi = 300,
    NumberOfCopies = 3,
    PaperMargins = new Margins(15, 15, 15, 15),
    Grayscale = false
};

// Print the quarterly report
Printer.Print("quarterly-report.pdf", settings);

Imports IronPrint

' Configure full print settings
Dim settings As New PrintSettings With {
    .PaperSize = PaperSize.A4,
    .PaperOrientation = PaperOrientation.Landscape,
    .Dpi = 300,
    .NumberOfCopies = 3,
    .PaperMargins = New Margins(15, 15, 15, 15),
    .Grayscale = False
}

' Print the quarterly report
Printer.Print("quarterly-report.pdf", settings)

Imports IronPrint

' Configure full print settings
Dim settings As New PrintSettings With {
    .PaperSize = PaperSize.A4,
    .PaperOrientation = PaperOrientation.Landscape,
    .Dpi = 300,
    .NumberOfCopies = 3,
    .PaperMargins = New Margins(15, 15, 15, 15),
    .Grayscale = False
}

' Print the quarterly report
Printer.Print("quarterly-report.pdf", settings)

Usamos a sintaxe de inicializador de objeto aqui para clareza. Orientation rotaciona a folha A4 para seu eixo mais largo. DPI a 300 garante saída nítida para gráficos e texto fino. Margins aceita quatro valores em milímetros — superior, direito, inferior, esquerdo — através do construtor Margins. A propriedade CopyCount por padrão é 1, mas nós a configuramos explicitamente para 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.

using IronPrint;
using System.Threading.Tasks;

public class DocumentPrinter
{
    public async Task PrintLegalDocumentAsync(string filePath)
    {
        // Configure Legal paper size
        PrintSettings settings = new PrintSettings
        {
            PaperSize = PaperSize.Legal,
            PaperOrientation = PaperOrientation.Portrait,
            Dpi = 300
        };

        // Print asynchronously
        await Printer.PrintAsync(filePath, settings);
    }
}

using IronPrint;
using System.Threading.Tasks;

public class DocumentPrinter
{
    public async Task PrintLegalDocumentAsync(string filePath)
    {
        // Configure Legal paper size
        PrintSettings settings = new PrintSettings
        {
            PaperSize = PaperSize.Legal,
            PaperOrientation = PaperOrientation.Portrait,
            Dpi = 300
        };

        // Print asynchronously
        await Printer.PrintAsync(filePath, settings);
    }
}

Imports IronPrint
Imports System.Threading.Tasks

Public Class DocumentPrinter
    Public Async Function PrintLegalDocumentAsync(filePath As String) As Task
        ' Configure Legal paper size
        Dim settings As New PrintSettings With {
            .PaperSize = PaperSize.Legal,
            .PaperOrientation = PaperOrientation.Portrait,
            .Dpi = 300
        }

        ' Print asynchronously
        Await Printer.PrintAsync(filePath, settings)
    End Function
End Class

Imports IronPrint
Imports System.Threading.Tasks

Public Class DocumentPrinter
    Public Async Function PrintLegalDocumentAsync(filePath As String) As Task
        ' Configure Legal paper size
        Dim settings As New PrintSettings With {
            .PaperSize = PaperSize.Legal,
            .PaperOrientation = PaperOrientation.Portrait,
            .Dpi = 300
        }

        ' Print asynchronously
        Await Printer.PrintAsync(filePath, settings)
    End Function
End Class

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

Podemos chamar este método a partir de um manipulador de cliques de botão, um serviço em segundo plano ou em qualquer lugar onde await seja suportado. Os métodos assíncronos do IronPrint — incluindo PrintAsync e ShowPrintDialogAsync — aceitam a mesma configuração PrintSettings, de modo que o comportamento do tamanho do papel é idêntico entre os 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 da IronPrint, desde a configuração básica de propriedade única até configurações combinadas e impressão assíncrona. A classe PrintSettings fornece uma API limpa e fortemente tipada que elimina adivinhações sobre as dimensões do papel.

Para continuar explorando as capacidades do IronPrint:

Saiba como configurar todas as configurações de impressão incluindo nome da impressora, bandeja e escala de cinza
Veja exemplos de código de configurações de impressão para cenários comuns
Navegue pela referência de API completa para classes como Printer, PrintSettings, PaperSize

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.

PaperOrientation.Landscape

Dpi

PaperMargins

Margins

Grayscale

false

Perguntas frequentes

O que é IronPrint e como ele ajuda a definir o tamanho de papel para impressão em C#?

IronPrint é uma biblioteca que simplifica as tarefas de impressão em C#. Permite que os desenvolvedores configurem facilmente tamanhos de papel como A4, Carta e Legal usando exemplos de código direto.

Posso definir tamanhos de papel personalizados usando o IronPrint em C#?

Sim, o IronPrint permite que você defina tamanhos de papel personalizados para impressão em C#. Você pode definir dimensões que atendam às suas necessidades específicas de impressão.

Como faço para mudar o tamanho do papel para A4 usando o IronPrint?

Para mudar o tamanho do papel para A4 usando o IronPrint, você precisa configurar as configurações de tamanho de papel em seu código. O IronPrint fornece um método simples para definir o tamanho do papel para A4 com mínimo esforço de codificação.

O IronPrint suporta configuração de tamanho de papel Legal?

Sim, o IronPrint suporta configuração de tamanho de papel Legal em C#. Você pode facilmente definir o tamanho do papel para Legal ajustando as configurações de tamanho de papel dentro do seu código de configuração de impressão.

É possível alternar entre diferentes tamanhos de papel usando o IronPrint?

Absolutamente, o IronPrint permite que você alterne entre diferentes tamanhos de papel como A4, Carta e Legal, modificando as configurações de tamanho de papel em sua aplicação C#.

How does IronPrint handle cases where no paper size is specified?

If no `PaperSize` is specified in the `PrintSettings`, IronPrint defaults to `PaperSize.PrinterDefault`, which uses the paper size configured in the operating system's default printer.

What happens if I want to respect end-user printer preferences in IronPrint?

Using `PaperSize.PrinterDefault` allows IronPrint to respect end-user printer preferences, as it uses the size set in the default printer configuration.

How do I install IronPrint for use in a C# project?

You can install IronPrint via NuGet with the command `Install-Package IronPrint`, and then include `using IronPrint;` in your C# files to access its functionalities.

What are some paper sizes supported by IronPrint?

IronPrint supports several paper sizes including ISO standards like A0, A1, A2, A3, A4, A5, and common US sizes like Letter, Legal, and Executive.

How can I access the full API reference for IronPrint?

The full API reference for IronPrint can be accessed through their documentation at the IronSoftware website, providing detailed information on classes and methods.

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 bem estruturados e visualmente atraentes.

...