Converter PDF de Páginas ASPX em C# ASP.NET — Guia Completo

Quando devo instalar via DLL em vez de NuGet?

Como alternativa, baixe a DLL do IronPDF e instale-a manualmente no projeto ou no GAC a partir de Baixar Pacote IronPDF . Para instalações específicas do Windows, consulte nosso guia de instalação do Windows .

Lembre-se de adicionar esta declaração ao início de qualquer arquivo de classe cs que utilize o IronPDF:

using IronPdf;

using IronPdf;

Imports IronPdf

Como posso controlar o comportamento de exibição de PDFs?

O comportamento do arquivo "InBrowser" tenta exibir o PDF diretamente no navegador do usuário. Essa é uma característica comum dos navegadores modernos que seguem os padrões.

IronPdf.AspxToPdf.RenderThisPageAsPdf(IronPdf.AspxToPdf.FileBehavior.InBrowser);

IronPdf.AspxToPdf.RenderThisPageAsPdf(IronPdf.AspxToPdf.FileBehavior.InBrowser);

IronPdf.AspxToPdf.RenderThisPageAsPdf(IronPdf.AspxToPdf.FileBehavior.InBrowser)

O comportamento do arquivo "Attachment" faz com que o PDF seja baixado.

IronPdf.AspxToPdf.RenderThisPageAsPdf(IronPdf.AspxToPdf.FileBehavior.Attachment);

IronPdf.AspxToPdf.RenderThisPageAsPdf(IronPdf.AspxToPdf.FileBehavior.Attachment);

IronPdf.AspxToPdf.RenderThisPageAsPdf(IronPdf.AspxToPdf.FileBehavior.Attachment)

Como faço para personalizar o nome do arquivo PDF?

Defina o nome do arquivo PDF adicionando um parâmetro adicional. Isso controla o nome do arquivo quando os usuários baixam ou salvam o arquivo.

IronPdf.AspxToPdf.RenderThisPageAsPdf(IronPdf.AspxToPdf.FileBehavior.Attachment, "Invoice.pdf");

IronPdf.AspxToPdf.RenderThisPageAsPdf(IronPdf.AspxToPdf.FileBehavior.Attachment, "Invoice.pdf");

IronPdf.AspxToPdf.RenderThisPageAsPdf(IronPdf.AspxToPdf.FileBehavior.Attachment, "Invoice.pdf")

Quais opções de impressão em PDF posso configurar?

Controle a saída em PDF adicionando uma instância da classe IronPdf.ChromePdfRenderer. Referência da API ChromePdfRenderer

:path=/static-assets/pdf/content-code-examples/how-to/aspx-to-pdf-3.cs

var AspxToPdfOptions = new IronPdf.ChromePdfRenderOptions()
{
    EnableJavaScript = false,
    //.. many more options available
};
IronPdf.AspxToPdf.RenderThisPageAsPdf(IronPdf.AspxToPdf.FileBehavior.Attachment, "Invoice.pdf", AspxToPdfOptions);

Dim AspxToPdfOptions = New IronPdf.ChromePdfRenderOptions() With {.EnableJavaScript = False}
IronPdf.AspxToPdf.RenderThisPageAsPdf(IronPdf.AspxToPdf.FileBehavior.Attachment, "Invoice.pdf", AspxToPdfOptions)

As opções de renderização de PDF disponíveis incluem:

• CreatePdfFormsFromHtml: Converte formulários ASPX em formulários PDF editáveis. Veja como criar formulários em PDF .
• CssMediaType: Screen ou Print Estilos CSS. Veja as imagens comparativas .
• CustomCssUrl: Aplicar CSS personalizado ao HTML antes da renderização. Caminho do arquivo local ou URL remota.
• EnableMathematicalLaTex: Ativar/desativar a renderização de elementos LaTeX.
• EnableJavaScript: Executar JavaScript antes da renderização. Ideal para aplicativos Ajax/Angular. Consulte o guia WaitFor .
• JavaScript: JavaScript personalizado para ser executado após o carregamento do HTML, mas antes da renderização.
• JavaScriptMessageListener: Função de retorno de chamada para mensagens do console JavaScript do navegador.
• FirstPageNumber: Número da página inicial para cabeçalhos/rodapés. O valor padrão é 1.
• TableOfContents: Gerar sumário no elemento com o id "ironpdf-toc". Consulte o guia de sumário .
• TextHeader: Defina o conteúdo do cabeçalho como texto. Suporta mala direta e URLs com links automáticos.
• TextFooter: Defina o conteúdo do rodapé como texto. Suporta mala direta e URLs com links automáticos.
• HtmlHeader: Defina o conteúdo do cabeçalho usando HTML.
• HtmlFooter: Defina o conteúdo do rodapé usando HTML.
• MarginBottom: Margem inferior em milímetros. Zero para sem fronteiras.
• MarginLeft: Margem esquerda em milímetros. Zero para sem fronteiras.
• MarginRight: Margem direita em milímetros. Zero para sem fronteiras.
• MarginTop: Margem superior em milímetros. Zero para sem fronteiras.
• UseMarginsOnHeaderAndFooter: Use as margens do documento principal para cabeçalhos/rodapés.
• PaperFit: Gerenciador virtual de layout de papel. Inclui opções para comportamento no Chrome, zoom, CSS3 responsivo, dimensionamento para a página e feed contínuo. Consulte o guia de viewport .
• PaperOrientation: Orientação do PDF - Paisagem ou Retrato.
• PageRotation: Rotacionar páginas do documento existente. Veja exemplos de orientação .
• PaperSize: Tamanho do papel de saída usando System.Drawing.Printing.PaperKind.
• SetCustomPaperSizeinCentimeters: Defina o tamanho do papel em centímetros.
• SetCustomPaperSizeInInches: Defina o tamanho do papel em polegadas.
• SetCustomPaperSizeinMilimeters: Defina o tamanho do papel em milímetros.
• SetCustomPaperSizeinPixelsOrPoints: Defina o tamanho do papel em pixels ou pontos.
• ForcePaperSize: Forçar o tamanho exato do papel redimensionando após a geração.
• PrintHtmlBackgrounds: Imprimir fundos de imagem HTML.
• GrayScale: Gerar PDF em tons de cinza. Veja conversão para tons de cinza .
• WaitFor: Configuração para mecanismos de espera:
  • PageLoad: Renderização padrão sem espera.
  • RenderDelay: Tempo de espera arbitrário.
  • Fonts: Aguarde o carregamento das fontes.
  • JavaScript: Acionar renderização com função JavaScript.
  • HTML elements: Aguarde elementos específicos por ID, nome, tag ou seletor.
  • NetworkIdle: Aguarde a rede ficar ociosa (0, 2 ou personalizado).
• Title: Metadados do título do documento PDF. Consulte o guia de metadados .
• InputEncoding: Codificação de caracteres. UTF-8 é o padrão. Consulte o guia UTF-8 .
• RequestContext: Solicitar contexto para renderização.
• Timeout: Tempo limite de renderização em segundos.

Como faço para adicionar cabeçalhos e rodapés?

:path=/static-assets/pdf/content-code-examples/how-to/aspx-to-pdf-4.cs

using IronSoftware.Drawing;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;

namespace AspxToPdfTutorial
{
    public partial class Invoice : System.Web.UI.Page
    {
        protected void Page_Load(object sender, EventArgs e)
        {
            var AspxToPdfOptions = new IronPdf.ChromePdfRenderOptions()
            {
                TextHeader = new IronPdf.TextHeaderFooter()
                {
                    CenterText = "Invoice",
                    DrawDividerLine = false,
                    Font = FontTypes.Arial,
                    FontSize = 12
                },
                TextFooter = new IronPdf.TextHeaderFooter()
                {
                    LeftText = "{date} - {time}",
                    RightText = "Page {page} of {total-pages}",
                    Font = IronSoftware.Drawing.FontTypes.Arial,
                    FontSize = 12,
                },
            };
            IronPdf.AspxToPdf.RenderThisPageAsPdf(IronPdf.AspxToPdf.FileBehavior.Attachment, "Invoice.pdf", AspxToPdfOptions);
        }
    }
}

Imports IronSoftware.Drawing
Imports System
Imports System.Collections.Generic
Imports System.Linq
Imports System.Web
Imports System.Web.UI
Imports System.Web.UI.WebControls

Namespace AspxToPdfTutorial
	Partial Public Class Invoice
		Inherits System.Web.UI.Page

		Protected Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs)
			Dim AspxToPdfOptions = New IronPdf.ChromePdfRenderOptions() With {
				.TextHeader = New IronPdf.TextHeaderFooter() With {
					.CenterText = "Invoice",
					.DrawDividerLine = False,
					.Font = FontTypes.Arial,
					.FontSize = 12
				},
				.TextFooter = New IronPdf.TextHeaderFooter() With {
					.LeftText = "{date} - {time}",
					.RightText = "Page {page} of {total-pages}",
					.Font = IronSoftware.Drawing.FontTypes.Arial,
					.FontSize = 12
				}
			}
			IronPdf.AspxToPdf.RenderThisPageAsPdf(IronPdf.AspxToPdf.FileBehavior.Attachment, "Invoice.pdf", AspxToPdfOptions)
		End Sub
	End Class
End Namespace

Alternativamente, gere cabeçalhos e rodapés HTML usando a classe HtmlHeaderFooter, que suporta CSS, imagens e hiperlinks.

:path=/static-assets/pdf/content-code-examples/how-to/aspx-to-pdf-5.cs

using System;
using System.Collections.Generic;
using System.Linq;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;

namespace AspxToPdfTutorial
{
    public partial class Invoice : System.Web.UI.Page
    {
        protected void Page_Load(object sender, EventArgs e)
        {
            var AspxToPdfOptions = new IronPdf.ChromePdfRenderOptions()
            {
                MarginTop = 50, // make sufficiant space for an HTML header
                HtmlHeader = new IronPdf.HtmlHeaderFooter()
                {
                    HtmlFragment = "<div style='text-align:right'><em style='color:pink'>page {page} of {total-pages}</em></div>"
                }
            };
            IronPdf.AspxToPdf.RenderThisPageAsPdf(IronPdf.AspxToPdf.FileBehavior.Attachment, "MyDocument.pdf", AspxToPdfOptions);
        }
    }
}

Imports System
Imports System.Collections.Generic
Imports System.Linq
Imports System.Web
Imports System.Web.UI
Imports System.Web.UI.WebControls

Namespace AspxToPdfTutorial
	Partial Public Class Invoice
		Inherits System.Web.UI.Page

		Protected Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs)
			Dim AspxToPdfOptions = New IronPdf.ChromePdfRenderOptions() With {
				.MarginTop = 50,
				.HtmlHeader = New IronPdf.HtmlHeaderFooter() With {.HtmlFragment = "<div style='text-align:right'><em style='color:pink'>page {page} of {total-pages}</em></div>"}
			}
			IronPdf.AspxToPdf.RenderThisPageAsPdf(IronPdf.AspxToPdf.FileBehavior.Attachment, "MyDocument.pdf", AspxToPdfOptions)
		End Sub
	End Class
End Namespace

Como pode ser visto em nossos exemplos, mescle texto dinâmico ou HTML em cabeçalhos/rodapés usando marcadores de posição:

• {page}: Número da página atual.
• {total-pages}: Número total de páginas.
• {url}: URL da Web a partir da qual o PDF foi gerado.
• {date}: Data de hoje no formato do sistema.
• {time}: Hora no formato de 24 horas.
• {html-title}: Título da tag do ASPX.
• {pdf-title}: Nome do arquivo do documento.

Tutorial de Acesso Rápido

Explore este tutorial no GitHub

O código deste projeto C# ASPX-To-PDF está disponível em C# e VB.NET no GitHub como um projeto de site ASP.NET. Sinta-se à vontade para criar um fork do nosso projeto no GitHub para obter mais ajuda com o IronPDF. Compartilhe este projeto com qualquer pessoa que possa estar se perguntando: "Como faço para converter ASPX em PDF?"

Projeto de site C# ASPX para PDF Exemplos avançados de conversão de páginas ASP.NET para PDF em C# para criação de PDFs Exemplos de PDF em ASP.NET usando VB.NET para criar PDFs

Baixe o guia de início rápido em PDF de C#

Para facilitar o desenvolvimento de PDFs em suas aplicações .NET, compilamos um guia de início rápido em formato PDF. Este "Guia Rápido" oferece acesso rápido a funções e exemplos comuns para gerar e editar PDFs em C# e VB.NET, e ajudará você a economizar tempo ao começar a usar o IronPDF em seu projeto .NET.

Download

Consulte a Referência da API.

Explore a Referência da API do IronPDF, que descreve em detalhes todos os recursos, namespaces, classes, métodos, campos e enumerações do IronPDF.

Consulte a Referência da API do IronPDF.