rustedf.cloud
Menu

Gerar PDF no Blazor: Server e WebAssembly

Publicado em 3 min de leitura

O Blazor executa C# em dois lugares: no servidor, ou no navegador do visitante como WebAssembly. Essa diferença decide como um PDF é feito. A API do rustedf.cloud é chamada com uma chave secreta, e a chave precisa ficar em um servidor. Então, qualquer que seja o tipo de Blazor, a chamada à API é feita por código que roda no seu servidor, e o navegador só recebe o arquivo pronto.

Este guia usa o cliente tipado do guia de C# e ASP.NET Core e mostra três formas de entregar o arquivo ao usuário.

A regra: a chave nunca chega ao navegador

Um app Blazor WebAssembly é baixado e executado por cada visitante. Tudo que há nele, inclusive wwwroot/appsettings.json, pode ser lido por qualquer pessoa. Uma chave colocada ali é pública, e quem tem uma chave pode gastar os seus créditos. O serviço também recusa requisições vindas de uma página web.

Mantenha a chave no projeto do servidor, na configuração ou em um cofre de segredos:

// Projeto do servidor, Program.cs
builder.Services.AddHttpClient<PdfClient>(client =>
{
client.BaseAddress = new Uri("https://api.rustedf.com/");
client.DefaultRequestHeaders.Authorization =
new AuthenticationHeaderValue("Bearer", builder.Configuration["Rustedf:Key"]);
client.Timeout = TimeSpan.FromSeconds(40);
});

Um endpoint para o arquivo

Para o Blazor WebAssembly, e também para o Blazor Server, o desenho mais simples é um endpoint no projeto ASP.NET Core que devolve o PDF:

app.MapGet("/faturas/{number}.pdf", async (string number, PdfClient pdf, ClaimsPrincipal user) =>
{
// Confira aqui se este usuário pode ver esta fatura.
var data = await LoadInvoiceDataAsync(number);
var file = await pdf.RenderAsync(invoiceTemplateId, data, "pt-BR");
return Results.File(file, "application/pdf", fileDownloadName: $"fatura-{number}.pdf");
})
.RequireAuthorization();

A conferência importa: um endpoint que recebe um número e devolve um documento é um jeito de ler documentos de outras pessoas se não perguntar quem está pedindo. Como a página e o endpoint têm a mesma origem, o cookie de login vai junto com a requisição.

Um botão de download

Em um componente, envie o navegador ao endpoint. Uma resposta com nome de arquivo é baixada, e a página continua onde está:

@inject NavigationManager Navigation
<button @onclick="Download">Baixar PDF</button>
@code {
[Parameter] public string Number { get; set; } = "";
private void Download() =>
Navigation.NavigateTo($"/faturas/{Number}.pdf", forceLoad: true);
}

Uma pré-visualização na página

Deixe o nome do arquivo fora da resposta, e o navegador mostra o PDF em vez de baixá-lo. Aí um iframe serve de pré-visualização:

<iframe src="/faturas/@Number/previa.pdf" title="Fatura @Number"
style="width:100%; height:80vh; border:0"></iframe>

com um endpoint como o acima que chama Results.File(file, "application/pdf") sem o terceiro argumento.

Blazor Server: baixar a partir de um componente

No Blazor Server um componente roda no servidor, então pode injetar o PdfClient diretamente e pedir o PDF sem um endpoint. Para entregar o arquivo ao navegador, faça streaming por JavaScript interop:

@inject PdfClient Pdf
@inject IJSRuntime JS
<button @onclick="DownloadAsync">Baixar PDF</button>
@code {
private async Task DownloadAsync()
{
var file = await Pdf.RenderAsync(invoiceTemplateId, data, "pt-BR");
using var stream = new MemoryStream(file);
using var reference = new DotNetStreamReference(stream);
await JS.InvokeVoidAsync("downloadFileFromStream", "fatura.pdf", reference);
}
}
<!-- App.razor ou wwwroot/index.html -->
<script>
window.downloadFileFromStream = async (fileName, contentStreamReference) => {
const buffer = await contentStreamReference.arrayBuffer();
const url = URL.createObjectURL(new Blob([buffer]));
const anchor = document.createElement('a');
anchor.href = url;
anchor.download = fileName ?? '';
anchor.click();
anchor.remove();
URL.revokeObjectURL(url);
};
</script>

Uma referência de stream envia o arquivo em pedaços. Passar um PDF grande como um único byte[] ou como string base64 pelo interop esbarra no limite de tamanho da conexão entre o navegador e o servidor.

Erros a evitar

  • A chave em um projeto WebAssembly. Nem no appsettings.json, nem em uma constante, nem em uma requisição feita pelo navegador.
  • Um endpoint sem autorização. O número no endereço precisa ser conferido com o usuário.
  • Texto de usuário no HTML. Se você envia HTML em vez de um template salvo, o campo html é um template, então um texto com {{ seria lido como marcador. Envie o que os usuários digitam em data.
  • Sem tempo limite. Defina o tempo limite do HttpClient acima do limite de tempo do seu plano e mostre ao usuário uma mensagem quando a chamada falhar.

Leia Gerar um PDF, Autenticação e Erros e limites.

  • Código e integrações

    Gerar PDF no ASP.NET Core: MVC, Razor Pages e minimal APIs

    Transforme uma view Razor em PDF no ASP.NET Core com uma chamada de API: renderizador de views, view pronta para impressão, action MVC e handler do Razor Pages.

    3 min de leitura

  • Código e integrações

    Converter página web em PDF em C# sem navegador headless

    Busque uma página com HttpClient e transforme o HTML em PDF com uma chamada de API em C#. Quais páginas isso atende, quais não e como conferir antes de depender.

    3 min de leitura

  • Código e integrações

    Gerador de relatório PDF em C#: tabela paginada com totais

    Monte um relatório em PDF em C# a partir de uma lista de objetos: tabela com cabeçalho repetido em cada página, total, número de página e contagem de páginas.

    3 min de leitura

← Todos os posts