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.csbuilder.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 emdata. - Sem tempo limite. Defina o tempo limite do
HttpClientacima 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.
Continue lendo
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
Código e integrações
Salvar PDF em C#: em disco, como download ou em blob storage
Salve o PDF devolvido por uma chamada de renderização em C#: grave em disco, envie como download no ASP.NET Core, guarde um link assinado ou suba para o storage.
2 min de leitura