A differenza di quanto accade in ASP.NET MVC, la classe ApiController di ASP.NET Web API non possiede un metodo diretto per restituire nella response lo stream di un file. Quando abbiamo questa necessità, tuttavia, possiamo creare una action che restituisca un HttpResponseMessage:
public HttpResponseMessage GetFile(string fileName) { var root = HttpContext.Current.Server.MapPath("~/App_Data"); var path = Path.Combine(root, fileName); var response = new HttpResponseMessage(HttpStatusCode.OK); // apro uno stream in lettura sul file var stream = new FileStream(path, FileMode.Open); response.Content = new StreamContent(stream); // imposto il mime type e le informazioni di download sull'header response.Content.Headers.ContentType = new MediaTypeHeaderValue("application/octet-stream"); response.Content.Headers.ContentDisposition = new ContentDispositionHeaderValue("attachment"); response.Content.Headers.ContentDisposition.FileName = fileName; return response; }
Come prima cosa calcoliamo il percorso assoluto del file; in questo esempio abbiamo supposto che si trovi all'interno della cartella App_Data. Il vantaggio di questa scelta è che tale cartella non è esposta da IIS e, quindi, l'accesso al file non potrà mai avvenire da direct link, ma sempre e solo in maniera controllata tramite la nostra action. Questo ci dà la possibilità, per esempio, di gestire policy di accesso, come il fatto che l'utente debba essere autenticato per effettuare il download.
Il passo successivo è quello di valorizzare come contenuto della response un oggetto di tipo StreamContent, popolato con uno stream sul file. Infine, per istruire il client sul modo corretto per gestire la response (nella fattispecie consigliandone il download), è buona norma impostare la content disposition come tipo attachment e suggerire il nome del file corretto.
Un'ultima nota riguarda il fatto che apriamo lo stream senza chiuderlo, cosa che potrebbe sollevare qualche dubbio: in realtà il disposing dell'oggetto FileStream è gestito internamente dall'oggetto StreamContent, quindi non dobbiamo preoccuparci di questo aspetto.
Commenti
Per inserire un commento, devi avere un account.
Fai il login e torna a questa pagina, oppure registrati alla nostra community.
Approfondimenti
Sfruttare i KeyedService in un'applicazione Blazor in .NET 8
Mascherare l'output di un valore all'interno dei log di un workflow di GitHub
Personalizzare l'errore del rate limiting middleware in ASP.NET Core
Usare il versioning con i controller di ASP.NET Core Web API
Specificare il versioning nel path degli URL in ASP.NET Web API
Registrare servizi multipli tramite chiavi in ASP.NET Core 8
Effettuare lo stream della risposta in ASP.NET Core tramite IAsyncEnumerable
Utilizzare Tailwind CSS all'interno di React: primi componenti
Eseguire operazioni sui blob con Azure Storage Actions
Visualizzare le change sul plan di Terraform tramite le GitHub Actions
Trasformare qualsiasi backend in un servizio GraphQL con Azure API Management