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.
Sigue leyendo
Código e integraciones
Generar un PDF en ASP.NET Core: MVC, Razor Pages y minimal APIs
Convierte una vista Razor en PDF en ASP.NET Core con una llamada a la API: renderizador de vistas, vista lista para imprimir, acción MVC y handler de Razor Pages.
3 min de lectura
Código e integraciones
Convertir una página web a PDF en C# sin navegador headless
Descarga una página con HttpClient y convierte su HTML en PDF con una llamada a la API en C#. Qué páginas admite, cuáles no y cómo comprobarlo de antemano.
3 min de lectura
Código e integraciones
Generador de informes PDF en C#: tabla paginada con totales
Crea un informe PDF en C# a partir de una lista de objetos: tabla con la cabecera repetida en cada página, total, números de página y recuento de páginas.
3 min de lectura
Código e integraciones
Generar miles de PDF en C#: ritmo, 429 y reintentos seguros
Genera un lote de PDF en C# sin avalancha de errores 429: controla el ritmo, repite solo lo seguro, reanuda una ejecución parada y para si se acaban los créditos.
3 min de lectura