Como renderizar PDFs com tamanho de papel personalizado em C#

Updated: 24 de abril de 2026

O IronPDF permite que você renderize PDFs com tamanhos de papel personalizados em C# usando a classe ChromePdfRenderer e definindo dimensões específicas através de métodos como SetCustomPaperSizeInInches(), permitindo controle preciso sobre as dimensões do documento para layouts especiais como cartazes ou banners.

Um tamanho de papel personalizado refere-se a um tamanho de papel não padrão, definido pelo usuário, em vez de um tamanho padrão como A4 ou carta (8,5 x 11 polegadas). Tamanhos de papel personalizados são frequentemente usados na impressão de documentos que exigem um layout único ou específico, como pôsteres, banners ou documentos especiais. Essa flexibilidade é essencial ao trabalhar com projetos de conversão de HTML para PDF que exigem dimensões específicas.

Descubra a vasta gama de tamanhos de papel disponíveis no IronPDF, que oferece uma ampla seleção para atender às suas necessidades!

Início rápido: Defina tamanhos de papel personalizados no IronPDF

Neste guia rápido, aprenda como definir tamanhos de papel personalizados usando o IronPDF com apenas algumas linhas de código. Com o IronPDF, você pode facilmente personalizar as dimensões do PDF definindo as medidas exatas de largura e altura em qualquer unidade de sua preferência. Essa flexibilidade é ideal para criar documentos com requisitos de layout específicos, como pôsteres ou banners. Comece baixando a biblioteca IronPDF via NuGet e siga este exemplo para definir o tamanho de papel desejado sem esforço.

1Install IronPDF with NuGet Package Manager
PM > Install-Package IronPdf
```
Install-Package IronPdf
```

2Copie e execute este trecho de código.

var renderer = new IronPdf.ChromePdfRenderer { RenderingOptions = { PaperSize = IronPdf.Rendering.PdfPaperSize.Custom } };
renderer.RenderingOptions.SetCustomPaperSizeInInches(5, 7);
renderer.RenderHtmlAsPdf("<h1>Custom size</h1>").SaveAs("custom-size.pdf")

var renderer = new IronPdf.ChromePdfRenderer { RenderingOptions = { PaperSize = IronPdf.Rendering.PdfPaperSize.Custom } };
renderer.RenderingOptions.SetCustomPaperSizeInInches(5, 7);
renderer.RenderHtmlAsPdf("<h1>Custom size</h1>").SaveAs("custom-size.pdf")

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

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

Fluxo de trabalho mínimo (5 etapas)

Baixe o IronPDF do NuGet para definir tamanhos de papel personalizados em PDFs.
Instancie a classe ChromePdfRenderer em C#
Acesse as RenderingOptions no novo objeto
Invoque um dos métodos SetCustomPaperSize com base na unidade de medida.
Renderize e exporte o documento PDF.

Como usar tamanhos de papel padrão?

Primeiro, crie uma instância da classe ChromePdfRenderer. Em seguida, use a propriedade RenderingOptions do objeto recém-criado para modificar PaperSize. Defina-a como um dos valores predefinidos do enum PdfPaperSize para especificar o tamanho de papel desejado. Oferecemos mais de 100 tamanhos de papel padrão predefinidos para sua conveniência.

Ao trabalhar com opções de renderização de PDF , o IronPDF oferece controle abrangente sobre a formatação dos seus documentos. Os tamanhos de papel padrão incluem formatos comumente usados, como A4, Carta, Ofício e muitos padrões internacionais.

Quais são os tamanhos de papel padrão disponíveis?

Abaixo segue um exemplo de como definir um tamanho de papel padrão:

using IronPdf;
using IronPdf.Rendering;

ChromePdfRenderer renderer = new ChromePdfRenderer();

// Set paper size to A4
renderer.RenderingOptions.PaperSize = PdfPaperSize.A4;

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Standard Paper Size</h1>");

pdf.SaveAs("standardPaperSize.pdf");

using IronPdf;
using IronPdf.Rendering;

ChromePdfRenderer renderer = new ChromePdfRenderer();

// Set paper size to A4
renderer.RenderingOptions.PaperSize = PdfPaperSize.A4;

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Standard Paper Size</h1>");

pdf.SaveAs("standardPaperSize.pdf");

Imports IronPdf
Imports IronPdf.Rendering

Private renderer As New ChromePdfRenderer()

' Set paper size to A4
renderer.RenderingOptions.PaperSize = PdfPaperSize.A4

Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Standard Paper Size</h1>")

pdf.SaveAs("standardPaperSize.pdf")

Imports IronPdf
Imports IronPdf.Rendering

Private renderer As New ChromePdfRenderer()

' Set paper size to A4
renderer.RenderingOptions.PaperSize = PdfPaperSize.A4

Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Standard Paper Size</h1>")

pdf.SaveAs("standardPaperSize.pdf")

O IronPDF suporta uma ampla variedade de tamanhos de papel padrão, incluindo:

Série ISO 216 : A0 a A10, B0 a B10
América do Norte : Carta, Jurídico, Tablóide, Executivo
Arquitetura : ANSI A a E
Japonês : JIS B0 a B10
Tamanhos de envelopes : Vários padrões internacionais de envelopes

Para obter uma lista completa dos tamanhos de papel disponíveis e suas dimensões, consulte a documentação de referência da API .

Quais propriedades controlam o tamanho do papel?

PaperSize: Defina um tamanho de papel de saída para páginas PDF com tamanhos predefinidos como carta, A3, A4, etc.
ForcePaperSize: Força os tamanhos das páginas a serem exatamente como especificado via IronPdf.ChromePdfRenderOptions.PaperSize redimensionando a página após gerar um PDF a partir de HTML. Essa funcionalidade é útil para contornar regras CSS que especificam o tamanho do papel.

Ao usar essas propriedades em conjunto com margens personalizadas , você pode obter um controle preciso sobre o layout do seu PDF.

Como faço para obter tamanhos de papel padrão em unidades diferentes?

Precisa encontrar as dimensões de tamanhos de papel padrão? Você pode fazer isso facilmente usando o método ToMillimeters. Este método retorna uma tupla contendo a largura e a altura do tamanho de papel padrão como objetos Length. A classe Length é incrivelmente versátil, permitindo que você converta essas dimensões em uma variedade de unidades, incluindo:

Milímetros
Centímetros
Polegadas
Pixels
Pontos

using IronPdf.Rendering;

double A4WidthInPixel = PdfPaperSize.A4.ToMillimeters().width.ToPixel();
double A4HeightInCentimeter = PdfPaperSize.A4.ToMillimeters().height.ToCentimeter();

using IronPdf.Rendering;

double A4WidthInPixel = PdfPaperSize.A4.ToMillimeters().width.ToPixel();
double A4HeightInCentimeter = PdfPaperSize.A4.ToMillimeters().height.ToCentimeter();

Imports IronPdf.Rendering

Private A4WidthInPixel As Double = PdfPaperSize.A4.ToMillimeters().width.ToPixel()
Private A4HeightInCentimeter As Double = PdfPaperSize.A4.ToMillimeters().height.ToCentimeter()

Imports IronPdf.Rendering

Private A4WidthInPixel As Double = PdfPaperSize.A4.ToMillimeters().width.ToPixel()
Private A4HeightInCentimeter As Double = PdfPaperSize.A4.ToMillimeters().height.ToCentimeter()

Essa funcionalidade é particularmente útil ao integrar com layouts responsivos em CSS ou quando você precisa calcular as dimensões exatas para layouts personalizados.

Minha biblioteca favorita desse tipo é o IronPDF. Ele permite a manipulação rápida e eficiente de arquivos PDF. Além disso, possui muitos recursos valiosos, como a exportação para o formato PDF/A e a assinatura digital de documentos PDF.

Milan Jovanovic

Microsoft MVP

Veja o estudo de caso

Com o IronOCR, podemos economizar US$ 40.000 por ano em processamento manual, ao mesmo tempo que aumentamos a produtividade e liberamos recursos para tarefas de alto impacto. Eu o recomendo fortemente.

Brent Matzelle

Diretor de Tecnologia, OPYN

Veja o estudo de caso

Como faço para criar tamanhos de papel personalizados?

Primeiro, começamos instanciando a classe ChromePdfRenderer. A partir do objeto recém-criado, podemos acessar o RenderingOptions para aplicar um tamanho de papel personalizado ao documento PDF recém-gerado. Existem quatro métodos que podem ser usados para definir o tamanho do papel de saída para páginas PDF, cada um baseado em uma unidade de medida diferente:

SetCustomPaperSizeInCentimeters: Dimensões estão em centimeters.
SetCustomPaperSizeInInches: Dimensões estão em inches.
SetCustomPaperSizeInMillimeters: Dimensões estão em millimeters.
SetCustomPaperSizeInPixelsOrPoints: Dimensões estão em pixels or points.

Ao criar tamanhos de papel personalizados, é importante considerar como eles irão interagir com cabeçalhos e rodapés, bem como com as configurações de orientação da página .

Que unidades posso usar para dimensões personalizadas?

Abaixo, segue um exemplo de como definir um tamanho de papel personalizado em centímetros:

using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

// Set custom paper size in cm
renderer.RenderingOptions.SetCustomPaperSizeinCentimeters(15, 15);

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Custom Paper Size</h1>");

pdf.SaveAs("customPaperSize.pdf");

using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

// Set custom paper size in cm
renderer.RenderingOptions.SetCustomPaperSizeinCentimeters(15, 15);

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Custom Paper Size</h1>");

pdf.SaveAs("customPaperSize.pdf");

Imports IronPdf

Private renderer As New ChromePdfRenderer()

' Set custom paper size in cm
renderer.RenderingOptions.SetCustomPaperSizeinCentimeters(15, 15)

Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Custom Paper Size</h1>")

pdf.SaveAs("customPaperSize.pdf")

Imports IronPdf

Private renderer As New ChromePdfRenderer()

' Set custom paper size in cm
renderer.RenderingOptions.SetCustomPaperSizeinCentimeters(15, 15)

Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Custom Paper Size</h1>")

pdf.SaveAs("customPaperSize.pdf")

Seguem exemplos adicionais para cada unidade de medida:

// Example: Custom paper size in inches (for US letter-like custom size)
renderer.RenderingOptions.SetCustomPaperSizeInInches(8.5, 11.5);

// Example: Custom paper size in millimeters (for precise metric measurements)
renderer.RenderingOptions.SetCustomPaperSizeInMillimeters(297, 420); // A3 size

// Example: Custom paper size in pixels (useful for screen-based layouts)
renderer.RenderingOptions.SetCustomPaperSizeInPixelsOrPoints(1024, 768, 96); // 96 DPI

// Example: Custom paper size in inches (for US letter-like custom size)
renderer.RenderingOptions.SetCustomPaperSizeInInches(8.5, 11.5);

// Example: Custom paper size in millimeters (for precise metric measurements)
renderer.RenderingOptions.SetCustomPaperSizeInMillimeters(297, 420); // A3 size

// Example: Custom paper size in pixels (useful for screen-based layouts)
renderer.RenderingOptions.SetCustomPaperSizeInPixelsOrPoints(1024, 768, 96); // 96 DPI

' Example: Custom paper size in inches (for US letter-like custom size)
renderer.RenderingOptions.SetCustomPaperSizeInInches(8.5, 11.5)

' Example: Custom paper size in millimeters (for precise metric measurements)
renderer.RenderingOptions.SetCustomPaperSizeInMillimeters(297, 420) ' A3 size

' Example: Custom paper size in pixels (useful for screen-based layouts)
renderer.RenderingOptions.SetCustomPaperSizeInPixelsOrPoints(1024, 768, 96) ' 96 DPI

' Example: Custom paper size in inches (for US letter-like custom size)
renderer.RenderingOptions.SetCustomPaperSizeInInches(8.5, 11.5)

' Example: Custom paper size in millimeters (for precise metric measurements)
renderer.RenderingOptions.SetCustomPaperSizeInMillimeters(297, 420) ' A3 size

' Example: Custom paper size in pixels (useful for screen-based layouts)
renderer.RenderingOptions.SetCustomPaperSizeInPixelsOrPoints(1024, 768, 96) ' 96 DPI

Ao trabalhar com tamanhos personalizados, você também pode explorar as configurações de viewport e zoom para garantir que seu conteúdo se ajuste corretamente às dimensões personalizadas.

Como posso modificar as dimensões do papel?

Em um documento PDF existente ou um PDF recém-renderizado, o tamanho de cada página pode ser modificado usando o método ExtendPage. Este método permite especificar o índice da página de destino, os valores a serem modificados em cada um dos quatro lados e as unidades de medida. Os valores para cada lado podem ser negativos, o que reduzirá esse lado em particular, ou positivos, o que aumentará esse lado.

Essa funcionalidade é particularmente útil quando você precisa ajustar PDFs depois de criados, como ao mesclar vários PDFs com tamanhos de página diferentes ou ao preparar documentos para impressão.

Quais parâmetros o ExtendPage aceita?

O método ExtendPage aceita os seguintes parâmetros:

Índice da Página: O índice baseado em zero da página a ser modificada
Extensão à Esquerda: Quantidade para estender/reduzir o lado esquerdo
Extensão à Direita: Quantidade para estender/reduzir o lado direito
Extensão Superior: Quantidade para estender/reduzir o lado superior
Extensão Inferior: Quantidade para estender/reduzir o lado inferior
Unidade de Medida: A unidade de medida (millimeters, inches, etc.)

Segue abaixo um exemplo de como modificar as dimensões do papel:

using IronPdf;
using IronPdf.Editing;

PdfDocument pdf = PdfDocument.FromFile("customPaperSize.pdf");

pdf.ExtendPage(0, 50, 0, 0, 0, MeasurementUnit.Millimeter);

pdf.SaveAs( "extendedLeftSide.pdf");

using IronPdf;
using IronPdf.Editing;

PdfDocument pdf = PdfDocument.FromFile("customPaperSize.pdf");

pdf.ExtendPage(0, 50, 0, 0, 0, MeasurementUnit.Millimeter);

pdf.SaveAs( "extendedLeftSide.pdf");

Imports IronPdf
Imports IronPdf.Editing

Private pdf As PdfDocument = PdfDocument.FromFile("customPaperSize.pdf")

pdf.ExtendPage(0, 50, 0, 0, 0, MeasurementUnit.Millimeter)

pdf.SaveAs("extendedLeftSide.pdf")

Imports IronPdf
Imports IronPdf.Editing

Private pdf As PdfDocument = PdfDocument.FromFile("customPaperSize.pdf")

pdf.ExtendPage(0, 50, 0, 0, 0, MeasurementUnit.Millimeter)

pdf.SaveAs("extendedLeftSide.pdf")

Aqui está um exemplo mais completo mostrando várias modificações na página:

// Extend all sides equally
pdf.ExtendPage(0, 10, 10, 10, 10, MeasurementUnit.Millimeter);

// Reduce page size (negative values)
pdf.ExtendPage(1, -20, -20, -10, -10, MeasurementUnit.Millimeter);

// Extend only top and bottom (useful for adding header/footer space)
pdf.ExtendPage(2, 0, 0, 25, 25, MeasurementUnit.Millimeter);

// Work with inches instead of millimeters
pdf.ExtendPage(3, 0.5, 0.5, 1, 1, MeasurementUnit.Inch);

// Extend all sides equally
pdf.ExtendPage(0, 10, 10, 10, 10, MeasurementUnit.Millimeter);

// Reduce page size (negative values)
pdf.ExtendPage(1, -20, -20, -10, -10, MeasurementUnit.Millimeter);

// Extend only top and bottom (useful for adding header/footer space)
pdf.ExtendPage(2, 0, 0, 25, 25, MeasurementUnit.Millimeter);

// Work with inches instead of millimeters
pdf.ExtendPage(3, 0.5, 0.5, 1, 1, MeasurementUnit.Inch);

' Extend all sides equally
pdf.ExtendPage(0, 10, 10, 10, 10, MeasurementUnit.Millimeter)

' Reduce page size (negative values)
pdf.ExtendPage(1, -20, -20, -10, -10, MeasurementUnit.Millimeter)

' Extend only top and bottom (useful for adding header/footer space)
pdf.ExtendPage(2, 0, 0, 25, 25, MeasurementUnit.Millimeter)

' Work with inches instead of millimeters
pdf.ExtendPage(3, 0.5, 0.5, 1, 1, MeasurementUnit.Inch)

' Extend all sides equally
pdf.ExtendPage(0, 10, 10, 10, 10, MeasurementUnit.Millimeter)

' Reduce page size (negative values)
pdf.ExtendPage(1, -20, -20, -10, -10, MeasurementUnit.Millimeter)

' Extend only top and bottom (useful for adding header/footer space)
pdf.ExtendPage(2, 0, 0, 25, 25, MeasurementUnit.Millimeter)

' Work with inches instead of millimeters
pdf.ExtendPage(3, 0.5, 0.5, 1, 1, MeasurementUnit.Inch)

Melhores práticas para tamanhos de papel personalizados

Ao trabalhar com tamanhos de papel personalizados no IronPDF, considere estas boas práticas:

Teste diferentes unidades : Ao trabalhar com tamanhos personalizados, teste qual unidade de medida funciona melhor para o seu caso de uso. Pixels são ótimos para layouts em tela, enquanto milímetros ou polegadas são melhores para impressão.
Considere as margens de impressão : Ao criar PDFs para impressão, lembre-se de levar em conta as margens da impressora. A maioria das impressoras não consegue imprimir até a borda do papel.
Design responsivo : Ao converter HTML para PDF , certifique-se de que seu HTML utilize princípios de design responsivo para se adaptar a diferentes tamanhos de papel.
Otimização de desempenho : Tamanhos de papel personalizados muito grandes podem afetar o desempenho. Considere usar compressão para documentos grandes.
Compatibilidade : Teste seus PDFs de tamanho personalizado em diferentes visualizadores de PDF para garantir a compatibilidade, especialmente se estiver usando dimensões não padronizadas.

Pronto para ver o que mais você pode fazer? Confira nossa página de tutoriais aqui: Criar PDFs

Perguntas frequentes

Como faço para definir tamanhos de papel personalizados para documentos PDF em C#?

Com o IronPDF, você pode definir tamanhos de papel personalizados usando a classe ChromePdfRenderer. Basta definir a propriedade PaperSize como PdfPaperSize.Custom em RenderingOptions e, em seguida, usar métodos como SetCustomPaperSizeInInches() para definir suas dimensões específicas. Por exemplo: renderer.RenderingOptions.SetCustomPaperSizeInInches(5, 7).

Quais unidades de medida posso usar para tamanhos de papel personalizados?

O IronPDF suporta múltiplas unidades de medida para tamanhos de papel personalizados através de diferentes métodos SetCustomPaperSize. Você pode especificar dimensões em polegadas, centímetros, milímetros ou pixels, tornando-o flexível para diversos padrões internacionais e requisitos de projeto.

Em que situações eu precisaria usar tamanhos de papel personalizados em vez de tamanhos padrão?

Os tamanhos de papel personalizados no IronPDF são ideais para criar PDFs com layouts exclusivos, como pôsteres, banners, documentos especiais ou qualquer design que não se encaixe em formatos padrão como A4 ou Carta. Essa flexibilidade é especialmente útil para projetos de conversão de HTML para PDF que exigem dimensões específicas.

Quantos tamanhos de papel padrão predefinidos estão disponíveis?

O IronPDF oferece mais de 100 tamanhos de papel padrão predefinidos através da enumeração PdfPaperSize, incluindo formatos comumente usados como A4, Carta, Ofício e muitos padrões internacionais, fornecendo opções abrangentes para a maioria das necessidades de documentos.

Quais são os passos para implementar tamanhos de papel personalizados?

Para implementar tamanhos de papel personalizados com o IronPDF: 1) Baixe o IronPDF via NuGet, 2) Crie uma instância de ChromePdfRenderer, 3) Acesse a propriedade RenderingOptions, 4) Chame o método SetCustomPaperSize com as dimensões desejadas e 5) Renderize e salve seu documento PDF.

What is the purpose of the `ForcePaperSize` option in IronPDF?

The `ForcePaperSize` option in IronPDF ensures that the page size is exactly as specified by resizing the page after generating a PDF from HTML. This overrides any CSS rules that might specify a different paper size, providing consistency in your PDF dimensions.

How can I ensure my custom paper sizes are compatible with different PDF viewers?

For compatibility with different PDF viewers, test your custom-sized PDFs in multiple viewers and ensure your dimensions adhere to PDF standards. Additionally, consider factors like printer margins for print-ready documents.

What should I consider when setting custom paper sizes for print in IronPDF?

When setting custom paper sizes for print, consider the printer margins since most printers cannot print to the edge. Use appropriate units like millimeters or inches, and verify the dimensions using the `ExtendPage` method if adjustments are needed post-creation.

How do I convert standard paper sizes to different units in IronPDF?

You can convert standard paper sizes to different units using IronPDF’s `ToMillimeters` method. This method provides the width and height as `Length` objects, which can easily be converted into millimeters, centimeters, inches, pixels, or points.

What are some best practices for using custom paper sizes in IronPDF?

Some best practices include testing different units for suitability, considering print margins, ensuring your HTML uses responsive design for HTML to PDF conversion, optimizing performance for very large sizes, and testing compatibility across different PDF viewers.

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.

...