//In questo esempio, l'action ha lo scopo di inviare un file binario 
//al client, in streaming. Il valore di ritorno di questa action è, per 
//l'appunto, un HttpResponseMessage
public HttpResponseMessage GetDocumento(int idDocumento)
{
  //Creo una risposta con lo status code OK (200)
  HttpResponseMessage risposta = Request.CreateResponse(HttpStatusCode.OK);
  
  //Imposto il content type del file binario
  risposta.Content.Headers.ContentType = 
    new MediaTypeHeaderValue("application/octect-stream");
  
  //Invoco il metodo che restituisce il percorso fisico di un file a partire 
  //dal suo Id
  string percorsoFile = OttieniPercorsoFileDaIdDocumento(idDocumento);
  
  //Apro uno FileStream in lettura indicando il percorso fisico del file
  FileStream stream = File.OpenRead(percorsoFile);
  //Lo assegno al contenuto della risposta, incapsulandolo 
  //in uno StreamContent
  risposta.Content = new StreamContent(stream);
  
  //Restituisco l'HttpResponseMessage, che attraverserà la pipeline 
  //di ASP.NET Web API prima di giungere al client
  return risposta;
}

//In questo esempio, l'action ha lo scopo di tenere il client in attesa
//finché non avrà sufficienti dati da scrivere sullo stream
public HttpResponseMessage GetDati()
{
  //Creo una risposta impostando lo status code 200 (OK)
  var risposta = Request.CreateResponse(HttpStatusCode.OK);
  //Imposto il content type
  risposta.Content.Headers.ContentType = 
    new MediaTypeHeaderValue("application/octect-stream");
  
  //Creo un PushStreamContent, che mi lascia decidere cosa
  //e quando scrivere sullo Stream. Essendo un'operazione di lunga
  //durata, la rendo asincrona con la parola chiave async
  risposta.Content = new PushStreamContent(async (stream, content, context) =>
  {
    //Continuo ad attendere finché non arrivano dei dati 
    //(attenzione a non incappare in un timeout)
    while(!DatiDisponibili())
    {
      await Task.Delay(5000);
    }

    //Finalmente ottengo i dati e li scrivo sullo Stream
    byte[] dati = OttieniDati();
    await stream.WriteAsync(dati, 0, dati.Length);
    stream.Dispose();
  });
  
  return risposta;
}