Salvar PDF em C#: em disco, como download ou em blob storage
Publicado em 2 min de leitura
Depois que um PDF é renderizado, “salvar como PDF” é uma pergunta sobre para onde os bytes vão: um arquivo em disco, um download no navegador, uma conta de storage ou um link que você entrega a um cliente. Com a API do rustedf.cloud, a resposta de uma requisição de renderização é o próprio arquivo, então cada uma dessas opções leva poucas linhas. Este guia mostra todas elas com o cliente tipado do guia de C# e ASP.NET Core.
Em um arquivo em disco
byte[] pdf = await client.RenderAsync(templateId, data, "pt-BR", cancellationToken);await File.WriteAllBytesAsync("fatura-2026-0042.pdf", pdf, cancellationToken);Para um documento grande, faça streaming da resposta para o arquivo em vez de mantê-la na memória, e grave antes em um nome temporário, para que uma execução que falhe nunca deixe meio arquivo com o nome definitivo:
using var request = new HttpRequestMessage(HttpMethod.Post, "v1/render"){ Content = JsonContent.Create(new { template_id = templateId, data }),};using var response = await http.SendAsync( request, HttpCompletionOption.ResponseHeadersRead, cancellationToken);response.EnsureSuccessStatusCode();
var temporary = path + ".part";await using (var file = File.Create(temporary)){ await response.Content.CopyToAsync(file, cancellationToken);}File.Move(temporary, path, overwrite: true);Como download no ASP.NET Core
Dê um nome ao arquivo e o navegador faz o download; deixe o nome de fora e o navegador o mostra em uma aba.
app.MapGet("/faturas/{number}.pdf", async (string number, PdfClient pdf) =>{ var file = await pdf.RenderAsync(invoiceTemplate, DataFor(number), "pt-BR"); return Results.File(file, "application/pdf", fileDownloadName: $"fatura-{number}.pdf");});Se qualquer parte do nome vem de um usuário, limpe-o antes. Um nome com um caminho ou uma quebra de linha é, na melhor das hipóteses, um bug.
Deixe o serviço guardar
Quando você só precisa entregar um link a alguém, peça output: "url". O serviço guarda o PDF
e responde com um endereço assinado:
using System.Text.Json.Serialization;
using var response = await http.PostAsJsonAsync( "v1/render", new { template_id = templateId, data, output = "url" }, cancellationToken);response.EnsureSuccessStatusCode();var link = await response.Content.ReadFromJsonAsync<RenderLink>(cancellationToken);
public sealed record RenderLink( string Url, [property: JsonPropertyName("expires_at")] long ExpiresAt, int Pages);O link funciona sem chave de API até expires_at, e depois deixa de funcionar; por quanto
tempo os arquivos ficam guardados depende do seu plano. É uma forma de entregar um documento,
não um arquivo morto: para guardá-lo, baixe-o uma vez e armazene você mesmo.
Em blob storage
Os bytes vão para qualquer armazenamento. Com o Azure Blob Storage:
var blob = container.GetBlobClient($"faturas/{number}.pdf");await blob.UploadAsync( new BinaryData(pdf), new BlobUploadOptions { HttpHeaders = new BlobHttpHeaders { ContentType = "application/pdf" }, }, cancellationToken);Defina o tipo de conteúdo, para que o navegador saiba o que abre quando você entregar o endereço do blob.
Não salve um erro como PDF
Uma renderização que falha responde com JSON, não com um PDF. Um código que grava o corpo da
resposta em um .pdf sem olhar o status deixa um arquivo que nenhum leitor abre. Confira
antes, como faz o cliente tipado, e leia o code:
| Status | O que fazer |
|---|---|
| 401 | A chave está ausente, errada ou revogada. Corrija a configuração. |
| 402 | Sem créditos. Nada foi renderizado. |
| 422 | O template ou os dados falharam. Leia message. |
| 429, 503 | Espere o cabeçalho Retry-After e envie a requisição de novo. |
| 504 | O documento levou mais tempo do que o seu plano permite. |
Uma renderização que falha não consome crédito, então tentar de novo em 429, 503 e 5xx é
seguro.
Leia Gerar um PDF para a requisição e a resposta, e Erros e limites para todos os códigos.
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
Gerar milhares de PDFs em C#: ritmo, 429 e novas tentativas seguras
Gere um lote de PDFs em C# sem enxurrada de erros 429: controle o ritmo, repita só o que é seguro, retome uma execução parada e pare quando os créditos acabarem.
3 min de leitura