rustedf.cloud
Menú

Guardar un PDF en C#: en disco, como descarga o en blob storage

Publicado el 2 min de lectura

Una vez renderizado un PDF, “guardar como PDF” es una pregunta sobre adónde van los bytes: un archivo en disco, una descarga en el navegador, una cuenta de storage o un enlace que entregas a un cliente. Con la API de rustedf.cloud, la respuesta a una petición de renderizado es el propio archivo, así que cada una de estas opciones lleva pocas líneas. Esta guía las muestra con el cliente tipado de la guía de C# y ASP.NET Core.

En un archivo en disco

byte[] pdf = await client.RenderAsync(templateId, data, "es-ES", cancellationToken);
await File.WriteAllBytesAsync("factura-2026-0042.pdf", pdf, cancellationToken);

Para un documento grande, pasa la respuesta al archivo en streaming en lugar de tenerla en memoria, y escribe antes en un nombre temporal, para que una ejecución fallida nunca deje medio archivo con el nombre 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 descarga en ASP.NET Core

Dale un nombre al archivo y el navegador lo descarga; omite el nombre y el navegador lo muestra en una pestaña.

app.MapGet("/facturas/{number}.pdf", async (string number, PdfClient pdf) =>
{
var file = await pdf.RenderAsync(invoiceTemplate, DataFor(number), "es-ES");
return Results.File(file, "application/pdf", fileDownloadName: $"factura-{number}.pdf");
});

Si alguna parte del nombre viene de un usuario, límpiala antes. Un nombre con una ruta o un salto de línea es, en el mejor de los casos, un error.

Deja que el servicio lo conserve

Cuando solo necesitas entregar un enlace a alguien, pide output: "url". El servicio guarda el PDF y responde con una dirección firmada:

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);

El enlace funciona sin clave de API hasta expires_at y después deja de funcionar; cuánto tiempo se conservan los archivos depende de tu plan. Es una forma de entregar un documento, no un archivo histórico: para conservarlo, descárgalo una vez y guárdalo tú.

En blob storage

Los bytes pueden ir a cualquier almacén. Con Azure Blob Storage:

var blob = container.GetBlobClient($"facturas/{number}.pdf");
await blob.UploadAsync(
new BinaryData(pdf),
new BlobUploadOptions
{
HttpHeaders = new BlobHttpHeaders { ContentType = "application/pdf" },
},
cancellationToken);

Define el tipo de contenido, para que el navegador sepa qué abre cuando entregues la dirección del blob.

No guardes un error como PDF

Un renderizado que falla responde con JSON, no con un PDF. Un código que escribe el cuerpo de la respuesta en un .pdf sin mirar el estado deja un archivo que ningún lector abre. Comprueba antes, como hace el cliente tipado, y lee el code:

Estado Qué hacer
401 La clave falta, es incorrecta o está revocada. Corrige la configuración.
402 Sin créditos. No se renderizó nada.
422 La plantilla o los datos fallaron. Lee message.
429, 503 Espera la cabecera Retry-After y envía la petición de nuevo.
504 El documento tardó más de lo que permite tu plan.

Un renderizado fallido no consume crédito, así que reintentar 429, 503 y 5xx es seguro.

Lee Generar un PDF para la petición y la respuesta, y Errores y límites para todos los códigos.

← Todos los artículos