Como converter Razor Views em PDFs sem interface gráfica em C

Por que preciso do Razor em vez do IronPDF ?

O Razor oferece renderização verdadeiramente headless — convertendo Views do Razor em HTML sem um contexto web ou janela do navegador. Isso é adequado para serviços em segundo plano, aplicativos de console ou ambientes sem interface gráfica. IronPdf.Extensions. O Razor requer um contexto web para funcionar.

Qual o tipo de projeto mais adequado para geração de PDFs sem interface gráfica?

Os projetos de aplicativos Web ASP.NET Core (Model-View-Controller) fornecem a infraestrutura Razor View necessária com opções de implantação flexíveis. Utilize essa abordagem em serviços em segundo plano, Funções do Azure ou aplicativos de console. Consulte a seção sobre como implantar o IronPDF no Azure para geração baseada em nuvem.

Como faço para instalar os pacotes NuGet necessários?

Instale pacotes usando o Gerenciador de Pacotes NuGet . Você precisa do IronPDF e do Razor.Templating.Core:

// Install via Package Manager Console
Install-Package IronPdf
Install-Package Razor.Templating.Core

// Or add to your .csproj file
// <PackageReference Include="IronPdf" Version="2024.x.x" />
// <PackageReference Include="Razor.Templating.Core" Version="1.x.x" />

// Install via Package Manager Console
Install-Package IronPdf
Install-Package Razor.Templating.Core

// Or add to your .csproj file
// <PackageReference Include="IronPdf" Version="2024.x.x" />
// <PackageReference Include="Razor.Templating.Core" Version="1.x.x" />

' Install via Package Manager Console
' Install-Package IronPdf
' Install-Package Razor.Templating.Core

' Or add to your .vbproj file
' <PackageReference Include="IronPdf" Version="2024.x.x" />
' <PackageReference Include="Razor.Templating.Core" Version="1.x.x" />

Que conteúdo HTML devo adicionar à minha view Razor ?

Adicione o HTML que você deseja renderizar como PDF:

<table class="table">
    <tr>
        <th>Name</th>
        <th>Title</th>
        <th>Description</th>
    </tr>
    <tr>
        <td>John Doe</td>
        <td>Software Engineer</td>
        <td>Experienced software engineer specializing in web development.</td>
    </tr>
    <tr>
        <td>Alice Smith</td>
        <td>Project Manager</td>
        <td>Seasoned project manager with expertise in agile methodologies.</td>
    </tr>
    <tr>
        <td>Michael Johnson</td>
        <td>Data Analyst</td>
        <td>Skilled data analyst proficient in statistical analysis and data visualization.</td>
    </tr>
</table>

<table class="table">
    <tr>
        <th>Name</th>
        <th>Title</th>
        <th>Description</th>
    </tr>
    <tr>
        <td>John Doe</td>
        <td>Software Engineer</td>
        <td>Experienced software engineer specializing in web development.</td>
    </tr>
    <tr>
        <td>Alice Smith</td>
        <td>Project Manager</td>
        <td>Seasoned project manager with expertise in agile methodologies.</td>
    </tr>
    <tr>
        <td>Michael Johnson</td>
        <td>Data Analyst</td>
        <td>Skilled data analyst proficient in statistical analysis and data visualization.</td>
    </tr>
</table>

Para layouts complexos, utilize CSS e estilos de impressão para garantir uma renderização perfeita em PDF. O IronPDF oferece suporte a recursos modernos de CSS3 para layouts de documentos sofisticados.

Por que usar tabelas para exibir dados em PDF?

As tabelas fornecem informações estruturadas e organizadas que se traduzem bem em documentos impressos. Mantêm uma formatação consistente em todas as plataformas e são legíveis em formato PDF. O mecanismo de renderização do IronPDF lida bem com layouts de tabelas, preservando bordas, espaçamento e alinhamento. Para formatação avançada, explore as margens personalizadas para otimizar o layout.

Quais são as considerações de estilo comuns para a saída em PDF?

Para saída em PDF, utilize consultas de mídia CSS específicas para impressão, valores de pixel fixos em vez de unidades relativas e fontes incorporadas para uma renderização consistente. O IronPDF suporta fontes da web e fontes de ícones para garantir a consistência da marca. Considere quebras de página para documentos com várias páginas e margens adequadas para uma aparência profissional.

Quais opções de renderização posso aplicar aos meus PDFs?

O IronPDF oferece diversas opções de renderização. Adicione cabeçalhos e rodapés , defina tamanhos de papel personalizados , controle a orientação da página e adicione marcas d'água . ChromePdfRenderer oferece mais de 50 propriedades para personalizar a geração de PDFs.

Como lidar com erros durante a geração de PDFs?

Implementar tratamento de erros para geração robusta de PDFs:

try
{
    var html = await RazorTemplateEngine.RenderAsync("Views/Home/Data.cshtml");
    var renderer = new ChromePdfRenderer();
    var pdf = renderer.RenderHtmlAsPdf(html, "./wwwroot");
    return Results.File(pdf.BinaryData, "application/pdf", "razorViewToPdf.pdf");
}
catch (Exception ex)
{
    // Log the error details
    IronPdf.Logging.Logger.Log($"PDF generation failed: {ex.Message}");
    return Results.Problem("Failed to generate PDF", statusCode: 500);
}

try
{
    var html = await RazorTemplateEngine.RenderAsync("Views/Home/Data.cshtml");
    var renderer = new ChromePdfRenderer();
    var pdf = renderer.RenderHtmlAsPdf(html, "./wwwroot");
    return Results.File(pdf.BinaryData, "application/pdf", "razorViewToPdf.pdf");
}
catch (Exception ex)
{
    // Log the error details
    IronPdf.Logging.Logger.Log($"PDF generation failed: {ex.Message}");
    return Results.Problem("Failed to generate PDF", statusCode: 500);
}

Imports IronPdf
Imports System.Threading.Tasks

Public Class PdfGenerator
    Public Shared Async Function GeneratePdfAsync() As Task(Of IResult)
        Try
            Dim html = Await RazorTemplateEngine.RenderAsync("Views/Home/Data.cshtml")
            Dim renderer = New ChromePdfRenderer()
            Dim pdf = renderer.RenderHtmlAsPdf(html, "./wwwroot")
            Return Results.File(pdf.BinaryData, "application/pdf", "razorViewToPdf.pdf")
        Catch ex As Exception
            ' Log the error details
            IronPdf.Logging.Logger.Log($"PDF generation failed: {ex.Message}")
            Return Results.Problem("Failed to generate PDF", statusCode:=500)
        End Try
    End Function
End Class

Quando devo ativar o registro detalhado?

Ative o registro detalhado durante o desenvolvimento e a resolução de problemas. O sistema de registro de logs do IronPDF fornece informações sobre a renderização, ajudando a identificar problemas de análise HTML, carregamento de recursos ou configuração. Para produção, utilize o registro personalizado para integrar com a infraestrutura de registro do seu aplicativo.

Que outros problemas relacionados ao percurso devo observar?

Além da questão do caminho com til (~), certifique-se de que as fontes de imagem usem caminhos absolutos ou referências relativas adequadas. Para recursos externos, utilize URLs base para garantir que os arquivos sejam carregados corretamente. Para imagens do Armazenamento de Blobs do Azure, consulte Incorporando imagens do Armazenamento de Blobs do Azure .

Como os recursos estáticos afetam a geração de PDFs?

Os recursos estáticos (CSS, JavaScript, imagens) afetam o desempenho e a qualidade da geração de PDFs. Garanta que os recursos estejam acessíveis durante a renderização, use imagens otimizadas e considere incorporar o CSS crítico diretamente no código para uma renderização mais rápida. Saiba mais sobre atrasos e tempos limite de renderização para conteúdo com uso intensivo de JavaScript.

Execute o projeto para gerar um documento PDF.

PDF de saída

Qual deve ser o formato do meu PDF final?

Seu PDF deve manter toda a formatação do Razor View — estruturas de tabelas, fontes, cores e layout. Deve ter o tamanho adequado, margens limpas e aparência profissional. Para verificar a qualidade da saída, use os recursos de rasterização do IronPDF para visualizar as páginas como imagens.

Como posso solucionar problemas comuns de renderização de PDF?

Problemas comuns incluem estilos ausentes, layouts quebrados ou conteúdo incompleto. Ative o registro detalhado de logs, verifique os caminhos dos recursos e assegure-se de que o HTML seja validado corretamente. Para layouts complexos, use as ferramentas de depuração do Chrome para visualizar o HTML antes da conversão. Para problemas específicos de renderização, use atrasos WaitFor para garantir que o conteúdo seja carregado antes da renderização.

Quais são os pré-requisitos para executar o projeto de exemplo?

Você precisa do Visual Studio 2019 ou posterior com o SDK do .NET 6.0 ou superior. O projeto requer conexão com a internet para a restauração de pacotes NuGet . Atualize sua chave de licença do IronPDF no arquivo Program.cs antes de executar o programa. Para a implementação, consulte o guia de instalação do Windows para obter requisitos adicionais.

Como faço para personalizar o exemplo para o meu caso de uso?

A amostra fornece uma base para suas necessidades específicas. Adicione modelos de dados dinâmicos, implemente o armazenamento em cache para PDFs gerados com frequência ou integre-se com a autenticação existente. Para cenários avançados, explore a geração assíncrona de PDFs para obter melhor desempenho ou implemente a compressão de PDFs para reduzir o tamanho dos arquivos. Adicione assinaturas digitais para autenticidade de documentos ou proteção por senha para documentos confidenciais.