Returning a file, accept-ranges headers, and browser behaviors #6780
Description
In ASPNET Core 2, any time you return a file from actual binary data (Either byte[] or Stream from my testing, haven't tried others yet), it automatically opts you into it sending headers to the browser of accept-ranges, and content-length. But the problem is that if the browser tries to take advantage of this, and your action may end up getting pinged multiple times, even though you likely have provided the entire file on the first request/response cycle. This results in repeat requests that you may not expect, or have planned for. In some cases can prevent the file from loading correctly on consumption because you're returning the same bytes no matter what range was asked for, simply by upgrading to ASPNET Core 2. There is no documentation about how to support this from what I can tell, and no details warning people about the change.
Ideally, the developer should be able to opt out of this behavior, or be required to explicitly opt in.
There should be some sort of documentation on how to support range requests.
Steps to reproduce
Create a new ASPNET Core 2 MVC app
Add a new action on the Home controller with the following
public IActionResult FileExample([FromServices]IHostingEnvironment hostingEnvironment)
{
//Using https://www.iso.org/files/live/sites/isoorg/files/archive/pdf/en/annual_report_2009.pdf copied to the project folder as my example PDF
//I just googled for a random PDF, my real world example pulls its files from a SQL DB
var buffer = System.IO.File.ReadAllBytes(Path.Combine(hostingEnvironment.ContentRootPath, "annual_report_2009.pdf"));
var contentDisposition = new System.Net.Mime.ContentDisposition() { FileName = "annual_report_2009.pdf.pdf", Inline = true };
Response.Headers.Add("Content-Disposition", contentDisposition.ToString());
return File(buffer, "application/pdf");
}In this example, I saw Chrome request this action 5 times for one request in the browser, and IE requests it 8.