rustedf.cloud
Menu

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.

← Todos os posts