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
Creare gruppi di client per Event Grid MQTT
Filtrare e rimuovere gli elementi dalla cache del browser tramite le API JavaScript
Come EF 8 ha ottimizzato le query che usano il metodo Contains
Code scanning e advanced security con Azure DevOps
Usare le variabili per personalizzare gli stili CSS
Utilizzare politiche di resiliency con Azure Container App
Routing statico e PreRendering in una Blazor Web App
Creare un'applicazione React e configurare Tailwind CSS
Utilizzare Azure AI Studio per testare i modelli AI
Ottenere il contenuto di una cartella FTP con la libreria FluentFTP
Evitare la script injection nelle GitHub Actions
Hosting di componenti WebAssembly in un'applicazione Blazor static