Converter HTML para PDF em .NET Core usando C# com IronPDF

Jacob Mellor

Updated: 17 de setembro de 2026

Download IronPDF

• NuGet Download
• DLL Download
• Windows Installer

• ---

• Start Free Trial

Copy for LLMs

• Copy for LLMs

  Copy page as Markdown for LLMs

• ---

• Open in ChatGPT

  Ask ChatGPT about this page
• Open in Gemini

  Ask Gemini about this page
• Open in Grok

  Ask Grok about this page
• Open in Perplexity

  Ask Perplexity about this page

Share

• Share on Facebook
• Share on X (Twitter)
• Share on LinkedIn

• ---

• Email article

Gerar PDFs de alta fidelidade diretamente a partir de HTML é um requisito rotineiro em aplicações .NET modernas - relatórios, faturas e ingressos precisam de uma saída com qualidade impecável que corresponda à interface web. O IronPDF simplifica esse fluxo de trabalho ao expor uma única API C# para renderizar HTML, visualizações Razor e sites completos em documentos PDF compatíveis com os padrões. Ao final deste guia, o desenvolvedor será capaz de converter URLs, HTML bruto ou visualizações MVC em um projeto ASP.NET Core e implantar o mesmo código em ambientes Windows, Linux, Docker ou sem servidor.

Converta HTML para PDF sem esforço em .NET Core usando a biblioteca IronPDF . Este guia fornece um exemplo simples para você começar rapidamente, renderizando conteúdo HTML em um PDF de alta qualidade com o mínimo de código. Ideal para desenvolvedores que desejam integrar a criação de PDFs em seus aplicativos com facilidade.

Lista de verificação de início rápido

1. Install – Install-Package IronPdf
2. Render a URL – ChromePdfRenderer.RenderUrlAsPdf()
3. Render raw HTML – ChromePdfRenderer.RenderHtmlAsPdf()
4. Exportar uma visão Razor – ChromePdfRenderer.RenderHtmlAsPdfAsync()
5. Ajustar saída – aproveite ChromePdfRenderer.RenderingOptions

O que este tutorial aborda

• Conversão de URL, string HTML e visão Razor
• Configuração de papel, margem e tipo de mídia
• Implantação multiplataforma (Windows, Linux, Docker)
• Pós-processamento: mesclar, adicionar marca d'água, proteger com senha e assinar digitalmente PDFs
• Exemplo completo: aplicativo MVC de reserva de ingressos

Como faço para instalar a biblioteca PDF no .NET Core?

A instalação da biblioteca é feita com apenas uma linha de comando em qualquer projeto .NET 8 e permanece compatível com versões futuras do .NET 9 (prévia) e com o lançamento do .NET 10. Utilize o Console do Gerenciador de Pacotes do NuGet e o gerenciador de pacotes resolverá automaticamente todas as dependências para Windows, Linux, Docker e ambientes sem servidor.

PM> Install-Package IronPdf             # .NET 8 LTS and higher

PM> Install-Package IronPdf             # .NET 8 LTS and higher

Após a instalação, confirme se tudo está conectado convertendo qualquerURLpública:

public class ClientModel
{
    [Required]
    public string Name { get; set; }
    [Required]
    public string Phone { get; set; }
    [Required]
    public string Email { get; set; }
}

public class ClientModel
{
    [Required]
    public string Name { get; set; }
    [Required]
    public string Phone { get; set; }
    [Required]
    public string Email { get; set; }
}

Public Class ClientModel
	<Required>
	Public Property Name() As String
	<Required>
	Public Property Phone() As String
	<Required>
	Public Property Email() As String
End Class

Public Class ClientModel
	<Required>
	Public Property Name() As String
	<Required>
	Public Property Phone() As String
	<Required>
	Public Property Email() As String
End Class

Como funciona

• ChromePdfRenderer inicia uma instância do Chromium em sandbox por trás dos bastidores - nenhuma instalação separada do Chrome é necessária.
• RenderUrlAsPdf captura o DOM totalmente renderizado, incluindo conteúdo impulsionado por JavaScript, media queries de CSS e fontes.
• O PdfDocument resultante expõe métodos auxiliares para mesclar, proteger com senha ou assinar digitalmente a saída - capacidades cobertas mais adiante neste tutorial.

Para obter mais detalhes sobre as nuances de implantação (Azure App Service, AWS Lambda, Linux local), consulte o guia de instalação específico e as páginas de configuração avançada do NuGet . Dicas internas de CI/CD para clusters Docker e K8s são abordadas nas melhores práticas de implantação do Docker .

Como um serviço .NET Core pode converter umURLde um site ativo em PDF?

Uma única chamada para RenderUrlAsPdf é suficiente: passe qualquerURLpublicamente acessível e o IronPDF retorna um PDF totalmente renderizado e compatível com os padrões. O código abaixo é direcionado ao .NET 8 LTS e compila sem alterações no .NET 9 Preview, bem como na futura versão do .NET 10, prevista para 2025.

Exemplo passo a passo

public class ClientServices
{
    private static ClientModel _clientModel;
    public static void AddClient(ClientModel clientModel)
    {
        _clientModel = clientModel;
    }
    public static ClientModel GetClient()
    {
        return _clientModel;
    }
}

public class ClientServices
{
    private static ClientModel _clientModel;
    public static void AddClient(ClientModel clientModel)
    {
        _clientModel = clientModel;
    }
    public static ClientModel GetClient()
    {
        return _clientModel;
    }
}

Public Class ClientServices
	Private Shared _clientModel As ClientModel
	Public Shared Sub AddClient(ByVal clientModel As ClientModel)
		_clientModel = clientModel
	End Sub
	Public Shared Function GetClient() As ClientModel
		Return _clientModel
	End Function
End Class

Public Class ClientServices
	Private Shared _clientModel As ClientModel
	Public Shared Sub AddClient(ByVal clientModel As ClientModel)
		_clientModel = clientModel
	End Sub
	Public Shared Function GetClient() As ClientModel
		Return _clientModel
	End Function
End Class

Por que funciona

• ChromePdfRenderer inicia uma instância do Chromium em sandbox - sem dependência do Chrome do sistema, mantendo as imagens Docker leves.
• RenderUrlAsPdf espera que o DOM e o JavaScript terminem antes de fazer a captura, para que apps de página única renderizem corretamente.
• Ao configurar CssMediaType para Print, o motor é instruído a usar regras específicas de impressão, correspondendo à saída de Print → Save as PDF de um navegador.
• O PdfDocument resultante pode ser criptografado, assinado digitalmente, mesclado ou rasterizado - capacidades cobertas em seções posteriores.

Recursos relacionados

• Referência da API – ChromePdfRenderer.RenderUrlAsPdf
• Referência da API – PdfDocument.SaveAs
• Tutorial – Implantar IronPDF em contêineres Docker

Como faço para converter HTML bruto em PDF no .NET Core?

Passando uma string HTML - ou a marcação renderizada de uma visão Razor - para ChromePdfRenderer.RenderHtmlAsPdf produz instantaneamente um PDF compatível com os padrões. O método inicia o mecanismo Chromium integrado do IronPDF, portanto, não é necessária a instalação de um navegador externo nem a dependência do WebView. O mesmo código mostrado abaixo compila no .NET 8 LTS atualmente e permanece compatível com o .NET 9 e com o lançamento previsto do .NET 10 em novembro de 2025.

Exemplo - gerar um PDF a partir de um fragmento HTML

@model IronPdfMVCHelloWorld.Models.ClientModel
@{
  ViewBag.Title = "Book Ticket";
}
<h2>Index</h2>
@using (Html.BeginForm())
{
  <div class="form-horizontal">
    @Html.ValidationSummary(true, "", new { @class = "text-danger" })
    <div class="form-group">
      @Html.LabelFor(model => model.Name, htmlAttributes: new { @class = "control-label col-md-2" })
      <div class="col-md-10">
        @Html.EditorFor(model => model.Name, new { htmlAttributes = new { @class = "form-control" } })
        @Html.ValidationMessageFor(model => model.Name, "", new { @class = "text-danger" })
      </div>
    </div>
    <div class="form-group">
      @Html.LabelFor(model => model.Phone, htmlAttributes: new { @class = "control-label col-md-2" })
      <div class="col-md-10">
        @Html.EditorFor(model => model.Phone, new { htmlAttributes = new { @class = "form-control" } })
        @Html.ValidationMessageFor(model => model.Phone, "", new { @class = "text-danger" })
      </div>
    </div>
    <div class="form-group">
      @Html.LabelFor(model => model.Email, htmlAttributes: new { @class = "control-label col-md-2" })
      <div class="col-md-10">
        @Html.EditorFor(model => model.Email, new { htmlAttributes = new { @class = "form-control" } })
        @Html.ValidationMessageFor(model => model.Email, "", new { @class = "text-danger" })
      </div>
    </div>
    <div class="form-group">
      <div class="col-md-10 pull-right">
        <button type="submit" value="Save" class="btn btn-sm">
          <i class="fa fa-plus"></i>
          <span>
            Save
          </span>
        </button>
      </div>
    </div>
  </div>
}

@model IronPdfMVCHelloWorld.Models.ClientModel
@{
  ViewBag.Title = "Book Ticket";
}
<h2>Index</h2>
@using (Html.BeginForm())
{
  <div class="form-horizontal">
    @Html.ValidationSummary(true, "", new { @class = "text-danger" })
    <div class="form-group">
      @Html.LabelFor(model => model.Name, htmlAttributes: new { @class = "control-label col-md-2" })
      <div class="col-md-10">
        @Html.EditorFor(model => model.Name, new { htmlAttributes = new { @class = "form-control" } })
        @Html.ValidationMessageFor(model => model.Name, "", new { @class = "text-danger" })
      </div>
    </div>
    <div class="form-group">
      @Html.LabelFor(model => model.Phone, htmlAttributes: new { @class = "control-label col-md-2" })
      <div class="col-md-10">
        @Html.EditorFor(model => model.Phone, new { htmlAttributes = new { @class = "form-control" } })
        @Html.ValidationMessageFor(model => model.Phone, "", new { @class = "text-danger" })
      </div>
    </div>
    <div class="form-group">
      @Html.LabelFor(model => model.Email, htmlAttributes: new { @class = "control-label col-md-2" })
      <div class="col-md-10">
        @Html.EditorFor(model => model.Email, new { htmlAttributes = new { @class = "form-control" } })
        @Html.ValidationMessageFor(model => model.Email, "", new { @class = "text-danger" })
      </div>
    </div>
    <div class="form-group">
      <div class="col-md-10 pull-right">
        <button type="submit" value="Save" class="btn btn-sm">
          <i class="fa fa-plus"></i>
          <span>
            Save
          </span>
        </button>
      </div>
    </div>
  </div>
}

model ReadOnly Property () As IronPdfMVCHelloWorld.Models.ClientModel
  ViewBag.Title = "Book Ticket"
End Property
'INSTANT VB TODO TASK: The following line could not be converted:
(Of h2) Index</h2> [using](Html.BeginForm())
If True Then
'INSTANT VB TODO TASK: The following line uses invalid syntax:
'  <div class="form-horizontal"> @Html.ValidationSummary(True, "", New { @class = "text-danger" }) <div class="form-group"> @Html.LabelFor(model => model.Name, htmlAttributes: New { @class = "control-label col-md-2" }) <div class="col-md-10"> @Html.EditorFor(model => model.Name, New { htmlAttributes = New { @class = "form-control" } }) @Html.ValidationMessageFor(model => model.Name, "", New { @class = "text-danger" }) </div> </div> <div class="form-group"> @Html.LabelFor(model => model.Phone, htmlAttributes: New { @class = "control-label col-md-2" }) <div class="col-md-10"> @Html.EditorFor(model => model.Phone, New { htmlAttributes = New { @class = "form-control" } }) @Html.ValidationMessageFor(model => model.Phone, "", New { @class = "text-danger" }) </div> </div> <div class="form-group"> @Html.LabelFor(model => model.Email, htmlAttributes: New { @class = "control-label col-md-2" }) <div class="col-md-10"> @Html.EditorFor(model => model.Email, New { htmlAttributes = New { @class = "form-control" } }) @Html.ValidationMessageFor(model => model.Email, "", New { @class = "text-danger" }) </div> </div> <div class="form-group"> <div class="col-md-10 pull-right"> <button type="submit" value="Save" class="btn btn-sm"> <i class="fa fa-plus"></i> <span> Save </span> </button> </div> </div> </div> }

model ReadOnly Property () As IronPdfMVCHelloWorld.Models.ClientModel
  ViewBag.Title = "Book Ticket"
End Property
'INSTANT VB TODO TASK: The following line could not be converted:
(Of h2) Index</h2> [using](Html.BeginForm())
If True Then
'INSTANT VB TODO TASK: The following line uses invalid syntax:
'  <div class="form-horizontal"> @Html.ValidationSummary(True, "", New { @class = "text-danger" }) <div class="form-group"> @Html.LabelFor(model => model.Name, htmlAttributes: New { @class = "control-label col-md-2" }) <div class="col-md-10"> @Html.EditorFor(model => model.Name, New { htmlAttributes = New { @class = "form-control" } }) @Html.ValidationMessageFor(model => model.Name, "", New { @class = "text-danger" }) </div> </div> <div class="form-group"> @Html.LabelFor(model => model.Phone, htmlAttributes: New { @class = "control-label col-md-2" }) <div class="col-md-10"> @Html.EditorFor(model => model.Phone, New { htmlAttributes = New { @class = "form-control" } }) @Html.ValidationMessageFor(model => model.Phone, "", New { @class = "text-danger" }) </div> </div> <div class="form-group"> @Html.LabelFor(model => model.Email, htmlAttributes: New { @class = "control-label col-md-2" }) <div class="col-md-10"> @Html.EditorFor(model => model.Email, New { htmlAttributes = New { @class = "form-control" } }) @Html.ValidationMessageFor(model => model.Email, "", New { @class = "text-danger" }) </div> </div> <div class="form-group"> <div class="col-md-10 pull-right"> <button type="submit" value="Save" class="btn btn-sm"> <i class="fa fa-plus"></i> <span> Save </span> </button> </div> </div> </div> }

O que o código demonstra

• Chromium Embutido - IronPDF vem com o motor Chromium, garantindo paridade HTML5, CSS3 e JavaScript com navegadores modernos.
• Dependência única - Uma instalação leve do NuGet cobre Windows, Linux, Docker e Azure/AWS sem bibliotecas de sistema adicionais.
• Opções de renderização - PaperSize, CssMediaType e RenderDelay espelham as configurações de impressão do navegador para que os PDFs correspondam aos layouts na tela.
• Alvo preparado para o futuro - A superfície da API é a mesma no .NET 8, .NET 9 STS e no próximo .NET 10, portanto, a manutenção de longo prazo é mínima.
• Ganchos de pós-processamento - PdfDocument expõe auxiliares para mesclagem, proteção por senha e assinaturas digitais - cada uma coberta mais adiante neste guia.

Leitura adicional: veja o tutorial passo a passo de HTML-string-to-PDF e a documentação completa da API ChromePdfRenderer.

Como exportar uma view do .NET Core MVC para PDF?

IronPDF renderiza uma visão Razor totalmente processada ( .cshtml ) da mesma forma que um navegador faria e transmite o resultado como um PdfDocument. O fluxo de trabalho abaixo mantém a lógica do controlador limpa, não requer plugins de navegador e funciona no .NET 8 LTS, no .NET 9 Preview e na versão .NET 10, com lançamento previsto para novembro de 2025.

Exemplo de controlador de ponta a ponta

// TicketsController.cs — .NET 8 LTS / MVC
using IronPdf;
using Microsoft.AspNetCore.Mvc;
using YourApp.Models;           // TicketViewModel

public class TicketsController : Controller
{
    private readonly ChromePdfRenderer _renderer;

    public TicketsController()
    {
        _renderer = new ChromePdfRenderer
        {
            RenderingOptions =
            {
                PaperSize        = PdfPaperSize.A5,            // Compact ticket size
                PaperOrientation = PdfPdfOrientation.Portrait,
                FitToPaperWidth  = true,
                CssMediaType     = PdfCssMediaType.Print,
                Margins = new PdfMargins(5, 10, 5, 10)         // mm
            }
        };
    }

    // GET /Tickets/Print/42
    public async Task<IActionResult> Print(int id)
    {
        TicketViewModel vm = await _service.GetTicketAsync(id);

        // 1. Render the Razor view to an HTML string
        string html  = await RazorTemplateEngine.RenderViewAsync(
                           HttpContext, "~/Views/Tickets/Print.cshtml", vm);

        // 2. Convert HTML → PDF
        using PdfDocument pdf = _renderer.RenderHtmlAsPdf(html);

        // 3. Stream back as a file
        return File(pdf.BinaryData, "application/pdf",
                    $"ticket-{id}.pdf");
    }
}

// TicketsController.cs — .NET 8 LTS / MVC
using IronPdf;
using Microsoft.AspNetCore.Mvc;
using YourApp.Models;           // TicketViewModel

public class TicketsController : Controller
{
    private readonly ChromePdfRenderer _renderer;

    public TicketsController()
    {
        _renderer = new ChromePdfRenderer
        {
            RenderingOptions =
            {
                PaperSize        = PdfPaperSize.A5,            // Compact ticket size
                PaperOrientation = PdfPdfOrientation.Portrait,
                FitToPaperWidth  = true,
                CssMediaType     = PdfCssMediaType.Print,
                Margins = new PdfMargins(5, 10, 5, 10)         // mm
            }
        };
    }

    // GET /Tickets/Print/42
    public async Task<IActionResult> Print(int id)
    {
        TicketViewModel vm = await _service.GetTicketAsync(id);

        // 1. Render the Razor view to an HTML string
        string html  = await RazorTemplateEngine.RenderViewAsync(
                           HttpContext, "~/Views/Tickets/Print.cshtml", vm);

        // 2. Convert HTML → PDF
        using PdfDocument pdf = _renderer.RenderHtmlAsPdf(html);

        // 3. Stream back as a file
        return File(pdf.BinaryData, "application/pdf",
                    $"ticket-{id}.pdf");
    }
}

Imports IronPdf
Imports Microsoft.AspNetCore.Mvc
Imports YourApp.Models ' TicketViewModel

Public Class TicketsController
    Inherits Controller

    Private ReadOnly _renderer As ChromePdfRenderer

    Public Sub New()
        _renderer = New ChromePdfRenderer With {
            .RenderingOptions = New PdfRenderingOptions With {
                .PaperSize = PdfPaperSize.A5, ' Compact ticket size
                .PaperOrientation = PdfPdfOrientation.Portrait,
                .FitToPaperWidth = True,
                .CssMediaType = PdfCssMediaType.Print,
                .Margins = New PdfMargins(5, 10, 5, 10) ' mm
            }
        }
    End Sub

    ' GET /Tickets/Print/42
    Public Async Function Print(id As Integer) As Task(Of IActionResult)
        Dim vm As TicketViewModel = Await _service.GetTicketAsync(id)

        ' 1. Render the Razor view to an HTML string
        Dim html As String = Await RazorTemplateEngine.RenderViewAsync(
            HttpContext, "~/Views/Tickets/Print.cshtml", vm)

        ' 2. Convert HTML → PDF
        Using pdf As PdfDocument = _renderer.RenderHtmlAsPdf(html)
            ' 3. Stream back as a file
            Return File(pdf.BinaryData, "application/pdf", $"ticket-{id}.pdf")
        End Using
    End Function
End Class

Imports IronPdf
Imports Microsoft.AspNetCore.Mvc
Imports YourApp.Models ' TicketViewModel

Public Class TicketsController
    Inherits Controller

    Private ReadOnly _renderer As ChromePdfRenderer

    Public Sub New()
        _renderer = New ChromePdfRenderer With {
            .RenderingOptions = New PdfRenderingOptions With {
                .PaperSize = PdfPaperSize.A5, ' Compact ticket size
                .PaperOrientation = PdfPdfOrientation.Portrait,
                .FitToPaperWidth = True,
                .CssMediaType = PdfCssMediaType.Print,
                .Margins = New PdfMargins(5, 10, 5, 10) ' mm
            }
        }
    End Sub

    ' GET /Tickets/Print/42
    Public Async Function Print(id As Integer) As Task(Of IActionResult)
        Dim vm As TicketViewModel = Await _service.GetTicketAsync(id)

        ' 1. Render the Razor view to an HTML string
        Dim html As String = Await RazorTemplateEngine.RenderViewAsync(
            HttpContext, "~/Views/Tickets/Print.cshtml", vm)

        ' 2. Convert HTML → PDF
        Using pdf As PdfDocument = _renderer.RenderHtmlAsPdf(html)
            ' 3. Stream back as a file
            Return File(pdf.BinaryData, "application/pdf", $"ticket-{id}.pdf")
        End Using
    End Function
End Class

O que este código ilustra

• Sem arquivos temporários - a visão Razor é renderizada na memória e então passada diretamente para RenderHtmlAsPdf, evitando I/O de disco e condições de corrida em pasta temporária race conditions.
• Saída do tamanho de ingressos - PaperSize = A5 e margens estreitas mantêm os ingressos para impressão em casa compactos.
• Estilos de impressão consistentes - CssMediaType = Print aplica as mesmas regras de CSS @media print que os navegadores usam.
• Transmissão binária - pdf.BinaryData transmite o documento sem tocar no sistema de arquivos; Ideal para endpoints de API e funções Lambda.
• Renderizador reutilizável - ChromePdfRenderer é instanciado uma vez por controlador e depois reutilizado, minimizando a sobrecarga de spawn de processos.

Próximo passo: adicione criptografia, assinaturas digitais ou combine vários ingressos em um único arquivo. Veja o exemplo de combinação e o guia de instruções para assinatura digital .

Como posso ajustar com precisão o tamanho do papel, as margens, os cabeçalhos, as marcas d'água e a segurança antes da renderização?

IronPDF expõe um único objeto ChromePdfRenderOptions que controla todos os aspectos da saída - dimensões de papel, orientação, cabeçalhos e rodapés, tempo de JavaScript, marcas d'água, criptografia e assinaturas digitais - tudo sem plugins adicionais do navegador.

Exemplo de código - aplicar várias opções simultaneamente

[HttpPost]
public ActionResult Index(ClientModel model)
{
    if (ModelState.IsValid)
    {
        ClientServices.AddClient(model);
        return RedirectToAction("TicketView");
    }
  return View(model);
}

[HttpPost]
public ActionResult Index(ClientModel model)
{
    if (ModelState.IsValid)
    {
        ClientServices.AddClient(model);
        return RedirectToAction("TicketView");
    }
  return View(model);
}

<HttpPost>
Public Function Index(ByVal model As ClientModel) As ActionResult
	If ModelState.IsValid Then
		ClientServices.AddClient(model)
		Return RedirectToAction("TicketView")
	End If
  Return View(model)
End Function

<HttpPost>
Public Function Index(ByVal model As ClientModel) As ActionResult
	If ModelState.IsValid Then
		ClientServices.AddClient(model)
		Return RedirectToAction("TicketView")
	End If
  Return View(model)
End Function

Por que essas opções são importantes?

• PaperSize, Margins e CssMediaType espelham o diálogo de impressão de um navegador para que layouts na tela e o PDF permaneçam idênticos no Windows, Linux e Docker.
• cabeçalhos e rodapés HTML suportam tokens Razor, CSS e JavaScript - úteis para números de página dinâmicos ou branding.
• HtmlStamp permite que uma única linha crie marcas d'água com marca com controle total de HTML + CSS.
• As opções de segurança permitem criptografia de 128 bits, senhas de proprietário/usuário e permissões granulares sem a necessidade de ferramentas de terceiros.
• As assinaturas digitais adicionam um selo criptográfico diretamente no código, mantendo a autenticidade legal e a inviolabilidade.
• Auxiliares de extração como ExtractAllText e ExtractAllImages revertem o processo quando a análise é necessária.

Referência rápida - Configurações populares

Próximas tarefas: mesclar vários PDFs, extrair texto e imagens e implantar em Docker ou em um sistema sem servidor. Continue para a seção de implantação para garantir a paridade entre plataformas.

Como posso implantar um código de geração de PDF no Docker em sistemas Linux e Windows?

IronPdf é entregue como um único pacote NuGet auto-contido, assim containerizar um aplicativo ASP.NET Core (ou console) é simples em tanto Windows quanto Linux. A chave é copiar os binários publicados para uma imagem de tempo de execução esguia e, no Linux, adicionar as duas bibliotecas nativas que o IronPDF requer (libnss3 e libatk1.0-0).

Dockerfile de múltiplos estágios (Ubuntu 22.04)

####### ---------- stage 1 ----------
FROM mcr.microsoft.com/dotnet/sdk:8.0 AS build
WORKDIR /src
COPY ["MyPdfApp.csproj", "."]
RUN dotnet restore

COPY . .
RUN dotnet publish -c Release -o /app/publish

####### ---------- stage 2 ----------
FROM mcr.microsoft.com/dotnet/aspnet:8.0-jammy
######## Install two native libs required by Chromium
RUN apt-get update && \
    apt-get install -y --no-install-recommends libnss3 libatk1.0-0 && \
    rm -rf /var/lib/apt/lists/*

WORKDIR /app
COPY --from=build /app/publish .
ENTRYPOINT ["dotnet", "MyPdfApp.dll"]

####### ---------- stage 1 ----------
FROM mcr.microsoft.com/dotnet/sdk:8.0 AS build
WORKDIR /src
COPY ["MyPdfApp.csproj", "."]
RUN dotnet restore

COPY . .
RUN dotnet publish -c Release -o /app/publish

####### ---------- stage 2 ----------
FROM mcr.microsoft.com/dotnet/aspnet:8.0-jammy
######## Install two native libs required by Chromium
RUN apt-get update && \
    apt-get install -y --no-install-recommends libnss3 libatk1.0-0 && \
    rm -rf /var/lib/apt/lists/*

WORKDIR /app
COPY --from=build /app/publish .
ENTRYPOINT ["dotnet", "MyPdfApp.dll"]

Script de validação de ponta a ponta

docker build -t pdf-demo .
docker run --rm -p 8080:80 pdf-demo
######### ↳ Navigate to http://localhost:8080/api/pdf?url=https://example.com

docker build -t pdf-demo .
docker run --rm -p 8080:80 pdf-demo
######### ↳ Navigate to http://localhost:8080/api/pdf?url=https://example.com

• A ação da API chama internamente ChromePdfRenderer.RenderUrlAsPdf assim como na Seção 2. O IronPDF inicia seu processo Chromium em sandbox dentro do contêiner - nenhum servidor X é necessário porque ele renderiza sem interface gráfica.
• O consumo de memória permanece abaixo de 200 MB mesmo durante renderizações grandes.

Recursos internos

• Tutorial – Implantar IronPDF em contêineres Docker
• Como fazer – Rodar IronPDF no Azure App Service Linux
• Referência da API – ChromePdfRenderer class

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 posso abrir, mesclar, adicionar marcas d'água e extrair conteúdo de PDFs existentes no .NET Core?

IronPDF trata cada PDF - seja gerado pelo IronPDF, Adobe® Acrobat ou ferramentas de terceiros - como um objeto PdfDocument de primeira classe que pode ser aberto, editado, seguro e salvo novamente sem perda de qualidade. A mesma superfície de API funciona no .NET 8 LTS atualmente e compila sem alterações no .NET 9 Preview e na futura versão do .NET 10.

Amostra unificada - abrir → mesclar → marca d'água → extrair

[HttpPost]
public ActionResult TicketView(TicketModel model)
{
    IronPdf.Installation.TempFolderPath = $@"{Directory.GetParent}/irontemp/";
    IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = true;
    var html = this.RenderViewAsync("_TicketPdf", model);
    var renderer = new IronPdf.ChromePdfRenderer();
    using var pdf = renderer.RenderHtmlAsPdf(html.Result, @"wwwroot/css");
    return File(pdf.Stream.ToArray(), "application/pdf");
}

[HttpPost]
public ActionResult TicketView(TicketModel model)
{
    IronPdf.Installation.TempFolderPath = $@"{Directory.GetParent}/irontemp/";
    IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = true;
    var html = this.RenderViewAsync("_TicketPdf", model);
    var renderer = new IronPdf.ChromePdfRenderer();
    using var pdf = renderer.RenderHtmlAsPdf(html.Result, @"wwwroot/css");
    return File(pdf.Stream.ToArray(), "application/pdf");
}

<HttpPost>
Public Function TicketView(ByVal model As TicketModel) As ActionResult
	IronPdf.Installation.TempFolderPath = $"{AddressOf Directory.GetParent}/irontemp/"
	IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = True
	Dim html = Me.RenderViewAsync("_TicketPdf", model)
	Dim renderer = New IronPdf.ChromePdfRenderer()
	Dim pdf = renderer.RenderHtmlAsPdf(html.Result, "wwwroot/css")
	Return File(pdf.Stream.ToArray(), "application/pdf")
End Function

<HttpPost>
Public Function TicketView(ByVal model As TicketModel) As ActionResult
	IronPdf.Installation.TempFolderPath = $"{AddressOf Directory.GetParent}/irontemp/"
	IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = True
	Dim html = Me.RenderViewAsync("_TicketPdf", model)
	Dim renderer = New IronPdf.ChromePdfRenderer()
	Dim pdf = renderer.RenderHtmlAsPdf(html.Result, "wwwroot/css")
	Return File(pdf.Stream.ToArray(), "application/pdf")
End Function

Por que isso é importante?

• Abrir & combinar – PdfDocument.FromFile carrega qualquer PDF compatível com os padrões, incluindo arquivos criptografados, enquanto PdfDocument.Merge concatena um número arbitrário de documentos em uma única chamada.
• Marca d'água – ApplyStamp (alias HtmlStamp) incorpora sobreposições HTML/CSS totalmente estilizadas - logo, código QR, ou texto diagonal - em páginas selecionadas sem rasterização.
• Extração de conteúdo – ExtractAllText e ExtractAllImages extraem texto UTF-8 bruto ou streams de imagem binários para arquivamento ou pipelines de IA posteriores.
• Pronto para assinaturas digitais – a mesma instância PdfDocument pode ser selada com SignAndStamp, produzindo hashes compatíveis com RFC 3161 alinhados com requisitos de assinatura digital ISO 32000-2.
• Conformidade com padrões abertos – O IronPDF preserva a estrutura original do PDF (fontes, camadas, metadados XMP), de modo que a saída permaneça compatível com o Adobe® Reader e outros visualizadores ISO 32000-1 .
• Preparada para o futuro – A API evita assemblies de interoperabilidade e chamadas GDI do Win32, portanto o código é executado sem alterações no Windows, Linux, Docker e nas futuras versões serverless do .NET 10.

Precisa dividir, girar ou excluir páginas? Consulte o tutorial de edição em nível de página para obter informações sobre operações detalhadas.

Como os PDFs podem ser criptografados e assinados digitalmente no .NET Core?

O IronPDF protege um documento em duas etapas: criptografia baseada em AES (senhas de usuário/proprietário + permissões granulares) e assinaturas digitais X.509 que selam o arquivo com um hash criptográfico. Ambas as APIs vivem no mesmo objeto PdfDocument, portanto, o fluxo de trabalho é idêntico no .NET 8 LTS hoje e compila sem alterações no .NET 9 preview e na próxima versão do .NET 10.

Exemplo - aplicar AES de 256 bits, bloquear direitos de impressão e adicionar uma assinatura visível.

using System.IO;
using System.Threading.Tasks;

public static class ControllerExtensions
{
    public static async Task<string> RenderViewAsync<TModel>(this Controller controller, string viewName, TModel model, bool partial = false)
    {
        if (string.IsNullOrEmpty(viewName))
        {
            viewName = controller.ControllerContext.ActionDescriptor.ActionName;
        }
        controller.ViewData.Model = model;
        using (var writer = new StringWriter())
        {
            IViewEngine viewEngine = controller.HttpContext.RequestServices.GetService(typeof(ICompositeViewEngine)) as ICompositeViewEngine;
            ViewEngineResult viewResult = viewEngine.FindView(controller.ControllerContext, viewName, !partial);
            if (viewResult.Success == false)
            {
                return $"A view with the name {viewName} could not be found";
            }
            ViewContext viewContext = new ViewContext(controller.ControllerContext, viewResult.View, controller.ViewData, controller.TempData, writer, new HtmlHelperOptions());
            await viewResult.View.RenderAsync(viewContext);
            return writer.GetStringBuilder().ToString();
        }
    }
}

using System.IO;
using System.Threading.Tasks;

public static class ControllerExtensions
{
    public static async Task<string> RenderViewAsync<TModel>(this Controller controller, string viewName, TModel model, bool partial = false)
    {
        if (string.IsNullOrEmpty(viewName))
        {
            viewName = controller.ControllerContext.ActionDescriptor.ActionName;
        }
        controller.ViewData.Model = model;
        using (var writer = new StringWriter())
        {
            IViewEngine viewEngine = controller.HttpContext.RequestServices.GetService(typeof(ICompositeViewEngine)) as ICompositeViewEngine;
            ViewEngineResult viewResult = viewEngine.FindView(controller.ControllerContext, viewName, !partial);
            if (viewResult.Success == false)
            {
                return $"A view with the name {viewName} could not be found";
            }
            ViewContext viewContext = new ViewContext(controller.ControllerContext, viewResult.View, controller.ViewData, controller.TempData, writer, new HtmlHelperOptions());
            await viewResult.View.RenderAsync(viewContext);
            return writer.GetStringBuilder().ToString();
        }
    }
}

Imports System.IO
Imports System.Threading.Tasks

Public Module ControllerExtensions
	<System.Runtime.CompilerServices.Extension> _
	Public Async Function RenderViewAsync(Of TModel)(ByVal controller As Controller, ByVal viewName As String, ByVal model As TModel, Optional ByVal As Boolean = False) As Task(Of String)
		If String.IsNullOrEmpty(viewName) Then
			viewName = controller.ControllerContext.ActionDescriptor.ActionName
		End If
		controller.ViewData.Model = model
		Using writer = New StringWriter()
			Dim viewEngine As IViewEngine = TryCast(controller.HttpContext.RequestServices.GetService(GetType(ICompositeViewEngine)), ICompositeViewEngine)
			Dim viewResult As ViewEngineResult = viewEngine.FindView(controller.ControllerContext, viewName, Not partial)
			If viewResult.Success = False Then
				Return $"A view with the name {viewName} could not be found"
			End If
			Dim viewContext As New ViewContext(controller.ControllerContext, viewResult.View, controller.ViewData, controller.TempData, writer, New HtmlHelperOptions())
			Await viewResult.View.RenderAsync(viewContext)
			Return writer.GetStringBuilder().ToString()
		End Using
	End Function
End Module

Imports System.IO
Imports System.Threading.Tasks

Public Module ControllerExtensions
	<System.Runtime.CompilerServices.Extension> _
	Public Async Function RenderViewAsync(Of TModel)(ByVal controller As Controller, ByVal viewName As String, ByVal model As TModel, Optional ByVal As Boolean = False) As Task(Of String)
		If String.IsNullOrEmpty(viewName) Then
			viewName = controller.ControllerContext.ActionDescriptor.ActionName
		End If
		controller.ViewData.Model = model
		Using writer = New StringWriter()
			Dim viewEngine As IViewEngine = TryCast(controller.HttpContext.RequestServices.GetService(GetType(ICompositeViewEngine)), ICompositeViewEngine)
			Dim viewResult As ViewEngineResult = viewEngine.FindView(controller.ControllerContext, viewName, Not partial)
			If viewResult.Success = False Then
				Return $"A view with the name {viewName} could not be found"
			End If
			Dim viewContext As New ViewContext(controller.ControllerContext, viewResult.View, controller.ViewData, controller.TempData, writer, New HtmlHelperOptions())
			Await viewResult.View.RenderAsync(viewContext)
			Return writer.GetStringBuilder().ToString()
		End Using
	End Function
End Module

Nos bastidores

• Criptografia AES-256 - IronPDF envolve a carga com chaves AES aprovadas pelo NIST, bloqueando a abertura, impressão ou cópia não autorizadas.
• Granularidade de permissões - propriedades como AllowUserPrinting e AllowUserFormData alternam direitos por ação; É necessária uma senha de proprietário para que qualquer restrição entre em vigor.
• Assinaturas digitais - SignAndStamp incorpora um carimbo de data/hora RFC 3161 e cadeia de certificados, criando hashes que exibem evidência de adulteração reconhecida pelo Adobe® Acrobat e outros visualizadores ISO 32000-2.
• API única - tanto criptografia quanto assinatura modificam a mesma instância PdfDocument, evitando várias passagens de arquivo e preservando fontes internas, camadas e metadados.

Configurações básicas de segurança

Recursos internos para análises mais aprofundadas

• Tutorial – Proteger um PDF com senha
• Exemplo – Assinar digitalmente um PDF
• API reference – PdfSecuritySettings

Como otimizar e escalar o desempenho da conversão de HTML para PDF no .NET Core?

O motor Chromium do IronPDF já renderiza a maioria das páginas em < 1 s em hardware moderno, mas o throughput pode ser multiplicado por acumular renderizações, habilitar multithreading e reduzir a sobrecarga do Headless Chrome. As dicas abaixo se aplicam igualmente a todas as versões do .NET .

1. Renderizações em lote em um pool de threads em segundo plano

IronPdf.License.LicenseKey = "YourLicenseKey";
ChromePdfRenderer renderer = new ChromePdfRenderer();

// Set rendering options
renderer.RenderingOptions.PaperSize = IronPdf.Rendering.PdfPaperSize.A4;
renderer.RenderingOptions.PaperOrientation = IronPdf.Rendering.PdfPaperOrientation.Portrait;

renderer.RenderHtmlFileAsPdf(@"testFile.html").SaveAs("GeneratedFile.pdf");

IronPdf.License.LicenseKey = "YourLicenseKey";
ChromePdfRenderer renderer = new ChromePdfRenderer();

// Set rendering options
renderer.RenderingOptions.PaperSize = IronPdf.Rendering.PdfPaperSize.A4;
renderer.RenderingOptions.PaperOrientation = IronPdf.Rendering.PdfPaperOrientation.Portrait;

renderer.RenderHtmlFileAsPdf(@"testFile.html").SaveAs("GeneratedFile.pdf");

Imports IronPdf

License.LicenseKey = "YourLicenseKey"
Dim renderer As New ChromePdfRenderer()

' Set rendering options
renderer.RenderingOptions.PaperSize = Rendering.PdfPaperSize.A4
renderer.RenderingOptions.PaperOrientation = Rendering.PdfPaperOrientation.Portrait

renderer.RenderHtmlFileAsPdf("testFile.html").SaveAs("GeneratedFile.pdf")

Imports IronPdf

License.LicenseKey = "YourLicenseKey"
Dim renderer As New ChromePdfRenderer()

' Set rendering options
renderer.RenderingOptions.PaperSize = Rendering.PdfPaperSize.A4
renderer.RenderingOptions.PaperOrientation = Rendering.PdfPaperOrientation.Portrait

renderer.RenderHtmlFileAsPdf("testFile.html").SaveAs("GeneratedFile.pdf")

• ChromePdfRenderer is thread-safe; Uma única instância pode atender dezenas de tarefas simultâneas sem impasses.
• Parallel.ForEach satura cada núcleo da CPU; servidores típicos veem aumentos de throughput de 4-6× em comparação com um loop de thread único.
• Se as solicitações do ASP.NET ficarem em fila, mova as renderizações pesadas para um serviço em segundo plano hospedado ou para uma fila de mensagens para manter os tempos de resposta baixos.

2. Reduzir o custo de inicialização do Headless Chrome

O IronPDF inclui sua própria versão do Chromium, mas cada renderização acarreta uma pequena taxa de inicialização. O agrupamento de recursos ajuda, e os contêineres Linux devem incluir duas bibliotecas nativas:

RUN apt-get update && \
    apt-get install -y --no-install-recommends libnss3 libatk1.0-0

RUN apt-get update && \
    apt-get install -y --no-install-recommends libnss3 libatk1.0-0

A falta de qualquer biblioteca manifesta um erro libnss3.so not found nos logs do Docker.

Recomendadas flags do Chrome (aplicadas automaticamente pelo IronPDF) incluem --disable-gpu e --no-sandbox para reduzir a memória e problemas de usuário root em contêineres.

3. Aguarde o JavaScript tardio com RenderDelay ou WaitFor

Páginas que animam contadores ou buscam dados após DOMContentLoaded podem precisar de um pequeno atraso:

renderer.RenderingOptions.RenderDelay = 200;        // ms
// OR: renderer.RenderingOptions.JavaScript = "WaitFor('window.doneLoading')";

renderer.RenderingOptions.RenderDelay = 200;        // ms
// OR: renderer.RenderingOptions.JavaScript = "WaitFor('window.doneLoading')";

renderer.RenderingOptions.RenderDelay = 200 ' ms
' OR: renderer.RenderingOptions.JavaScript = "WaitFor('window.doneLoading')";

renderer.RenderingOptions.RenderDelay = 200 ' ms
' OR: renderer.RenderingOptions.JavaScript = "WaitFor('window.doneLoading')";

Consulte o tutorial dedicado ao WaitFor para obter informações sobre promessas personalizadas e sondagem do DOM.

4. Ative o registro de depuração para uma solicitação.

IronPdf.License.LicenseKey = "YourLicenseKey";
PdfDocument pdf = PdfDocument.FromFile("1.pdf");
PdfDocument pdf2 = PdfDocument.FromFile("2.pdf");
pdf.AppendPdf(pdf2);
pdf.SaveAs("appendedFile.pdf");

IronPdf.License.LicenseKey = "YourLicenseKey";
PdfDocument pdf = PdfDocument.FromFile("1.pdf");
PdfDocument pdf2 = PdfDocument.FromFile("2.pdf");
pdf.AppendPdf(pdf2);
pdf.SaveAs("appendedFile.pdf");

IronPdf.License.LicenseKey = "YourLicenseKey"
Dim pdf As PdfDocument = PdfDocument.FromFile("1.pdf")
Dim pdf2 As PdfDocument = PdfDocument.FromFile("2.pdf")
pdf.AppendPdf(pdf2)
pdf.SaveAs("appendedFile.pdf")

IronPdf.License.LicenseKey = "YourLicenseKey"
Dim pdf As PdfDocument = PdfDocument.FromFile("1.pdf")
Dim pdf2 As PdfDocument = PdfDocument.FromFile("2.pdf")
pdf.AppendPdf(pdf2)
pdf.SaveAs("appendedFile.pdf")

O recurso Live DevTools permite rastrear fontes ausentes, imagens com erro 404 e eventos de temporização sem a necessidade de recompilar o código.

5. Reutilize PDFs de modelos em vez de renderizá-los novamente.

Para execuções de fatura, crie um PDF modelo com marcadores como [[name]] e realize uma substituição de texto em vez de reconstruir HTML complexo. É 10 vezes mais rápido e consome pouca memória.

Lista de verificação para ajuste rápido

Leitura complementar

• Como fazer – Gerar PDFs com async / multithreading
• Solução de problemas – Centro de assistência de desempenho
• Exemplo – Demonstração de renderização em thread

Onde posso baixar uma versão de avaliação gratuita, escolher uma licença e encontrar suporte especializado?

Uma chave de avaliação de 30 dias é emitida instantaneamente através do formulário Iniciar Avaliação Gratuita e desbloqueia todos os recursos - incluindo conversão de HTML para PDF, assinaturas digitais e criptografia - sem marca d'água.

Após avaliar a biblioteca, escolha uma licença perpétua para desenvolvedores , para implantação ou corporativa ; Cada plano inclui atualizações menores gratuitas, direitos de uso para desenvolvimento/teste/produção e uma garantia de reembolso de 30 dias. Aplicar a chave é uma linha única de código (IronPdf.License.LicenseKey = "YOUR-KEY";) e pode ser automatizada em pipelines CI/CD.

A documentação completa - incluindo guias de início rápido , referência da API e vídeos tutoriais - está disponível no portal de documentação e é atualizada a cada nova versão do .NET .

Questões técnicas recebem respostas em um dia útil via chat ao vivo , e-mail ou telefone da equipe de suporte sediada em Chicago.

As perguntas frequentes sobre otimização de desempenho e implementação estão reunidas no Centro de Assistência de Desempenho.

Links rápidos

Próximos passos

1. Clone o repositório de exemplo que demonstra todos os principais recursos - desde a renderização de visualização MVC até a criptografia AES-256.
2. Insira a chave de avaliação em uma solução existente e execute os testes unitários para validar a compatibilidade entre plataformas.
3. Agende uma demonstração ao vivo com a equipe de engenharia para obter recomendações específicas para o seu projeto.

Com esses recursos em mãos, qualquer equipe .NET pode enviar PDFs perfeitos em nível de pixel para produção - localmente, em Docker ou sem servidor - em um único sprint.

Jacob Mellor

Diretor de Tecnologia

Converse agora mesmo com a equipe de engenharia.

Jacob Mellor é Diretor de Tecnologia da Iron Software e um engenheiro visionário pioneiro na tecnologia C# PDF. Como desenvolvedor original do código-fonte principal da Iron Software, ele moldou a arquitetura de produtos da empresa desde sua criação, transformando-a, juntamente com o CEO Cameron Rimington, em uma empresa com mais de 50 funcionários que atende à NASA, Tesla e agências governamentais globais.

Leia mais