Generar un PDF en Blazor: Server y WebAssembly
Publicado el 3 min de lectura
Blazor ejecuta C# en dos lugares: en el servidor, o en el navegador del visitante como WebAssembly. Esa diferencia decide cómo se hace un PDF. La API de rustedf.cloud se llama con una clave secreta, y la clave debe quedarse en un servidor. Así que, sea cual sea el tipo de Blazor, la llamada a la API la hace código que se ejecuta en tu servidor, y el navegador solo recibe el archivo terminado.
Esta guía usa el cliente tipado de la guía de C# y ASP.NET Core y muestra tres formas de entregar el archivo al usuario.
La regla: la clave nunca llega al navegador
Una app Blazor WebAssembly la descarga y la ejecuta cada visitante. Todo lo que hay en ella,
incluido wwwroot/appsettings.json, lo puede leer cualquiera. Una clave puesta ahí es pública, y
quien tiene una clave puede gastar tus créditos. El servicio también rechaza las peticiones que
vienen de una página web.
Guarda la clave en el proyecto del servidor, en la configuración o en un almacén de secretos:
// Proyecto del 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);});Un endpoint para el archivo
Para Blazor WebAssembly, y también para Blazor Server, el diseño más sencillo es un endpoint en el proyecto ASP.NET Core que devuelve el PDF:
app.MapGet("/facturas/{number}.pdf", async (string number, PdfClient pdf, ClaimsPrincipal user) =>{ // Comprueba aquí que este usuario puede ver esta factura. var data = await LoadInvoiceDataAsync(number); var file = await pdf.RenderAsync(invoiceTemplateId, data, "es-ES"); return Results.File(file, "application/pdf", fileDownloadName: $"factura-{number}.pdf");}).RequireAuthorization();La comprobación importa: un endpoint que recibe un número y devuelve un documento es una forma de leer los documentos de otras personas si no pregunta quién lo pide. Como la página y el endpoint comparten origen, la cookie de inicio de sesión viaja con la petición.
Un botón de descarga
En un componente, envía el navegador al endpoint. Una respuesta con nombre de archivo se descarga, y la página se queda donde está:
@inject NavigationManager Navigation
<button @onclick="Download">Descargar PDF</button>
@code { [Parameter] public string Number { get; set; } = "";
private void Download() => Navigation.NavigateTo($"/facturas/{Number}.pdf", forceLoad: true);}Una vista previa en la página
Deja el nombre de archivo fuera de la respuesta, y el navegador muestra el PDF en lugar de
descargarlo. Entonces un iframe sirve de vista previa:
<iframe src="/facturas/@Number/vista-previa.pdf" title="Factura @Number" style="width:100%; height:80vh; border:0"></iframe>con un endpoint como el anterior que llama a Results.File(file, "application/pdf") sin el tercer
argumento.
Blazor Server: descargar desde un componente
En Blazor Server un componente se ejecuta en el servidor, así que puede inyectar PdfClient
directamente y pedir el PDF sin un endpoint. Para entregar el archivo al navegador, haz streaming
mediante JavaScript interop:
@inject PdfClient Pdf@inject IJSRuntime JS
<button @onclick="DownloadAsync">Descargar PDF</button>
@code { private async Task DownloadAsync() { var file = await Pdf.RenderAsync(invoiceTemplateId, data, "es-ES"); using var stream = new MemoryStream(file); using var reference = new DotNetStreamReference(stream); await JS.InvokeVoidAsync("downloadFileFromStream", "factura.pdf", reference); }}<!-- App.razor o 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>Una referencia de stream envía el archivo por partes. Pasar un PDF grande como un único byte[] o
como una cadena base64 por el interop choca con el límite de tamaño de la conexión entre el
navegador y el servidor.
Errores que evitar
- La clave en un proyecto WebAssembly. Ni en
appsettings.json, ni en una constante, ni en una petición hecha desde el navegador. - Un endpoint sin autorización. El número de la dirección hay que comprobarlo contra el usuario.
- Texto de usuario en el HTML. Si envías HTML en lugar de una plantilla guardada, el campo
htmles una plantilla, así que un texto con{{se leería como un marcador. Envía lo que escriben los usuarios endata. - Sin tiempo límite. Fija el tiempo límite del
HttpClientpor encima del límite de tiempo de tu plan y muestra un mensaje al usuario cuando la llamada falle.
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
Guardar un PDF en C#: en disco, como descarga o en blob storage
Guarda el PDF que devuelve una llamada de renderizado en C#: escríbelo en disco, envíalo como descarga en ASP.NET Core, usa un enlace firmado o súbelo al storage.
2 min de lectura