rustedf.cloud
Menú

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.cs
builder.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 html es una plantilla, así que un texto con {{ se leería como un marcador. Envía lo que escriben los usuarios en data.
  • Sin tiempo límite. Fija el tiempo límite del HttpClient por encima del límite de tiempo de tu plan y muestra un mensaje al usuario cuando la llamada falle.

Lee Generar un PDF, Autenticación y Errores y límites.

← Todos los artículos