如何让ASP.NET控制器下载前弹出‘Save As’对话框？

Let’s fix this so your users can choose their own filename and download path! The core issue right now is that your response headers aren’t set up correctly to tell the browser to show the "Save As" dialog instead of auto-downloading the file.

First, here’s your original code for reference:

public FileStreamResult SaveData() 
{ 
    var toJson = JsonConvert.SerializeObject(this.GetData()); 
    var byteArray = System.Text.Encoding.ASCII.GetBytes(toJson); 
    var stream = new MemoryStream(byteArray); 
    string fileName = "Configuration.json"; 
    this.GetData().Save = false; 
    return new FileStreamResult(stream, "text/html") { FileDownloadName = fName }; 
}

The Fix: Adjust Response Headers and Content Type #

Browsers decide whether to auto-open or show "Save As" based on the Content-Type and Content-Disposition headers. Here’s the revised code that will trigger the dialog:

public FileStreamResult SaveData() 
{ 
    var data = this.GetData();
    var jsonContent = JsonConvert.SerializeObject(data); 
    // Use UTF-8 instead of ASCII to avoid garbled special characters/non-English text
    var byteArray = System.Text.Encoding.UTF8.GetBytes(jsonContent); 
    var stream = new MemoryStream(byteArray); 
    string defaultFileName = "Configuration.json"; 
    data.Save = false; 

    // Set correct MIME type for JSON files
    var result = new FileStreamResult(stream, "application/json") 
    { 
        FileDownloadName = defaultFileName 
    };
    
    // Explicitly set Content-Disposition to force the "Save As" dialog
    Response.Headers.Add("Content-Disposition", $"attachment; filename=\"{defaultFileName}\"");
    
    return result;
}

What Changed & Why: #

• Corrected Content-Type: Swapped text/html (which tells the browser to render the content as a webpage) for application/json—the standard MIME type for JSON files. This helps the browser recognize the file type correctly.
• UTF-8 Encoding: ASCII doesn’t support non-English characters or special symbols, so switching to UTF-8 ensures your config file’s content stays intact.
• Content-Disposition Header: Setting this to attachment tells the browser "this is a file to download, not display". The filename parameter provides a default name, but users can edit it in the "Save As" dialog.

Bonus: Let Users Pick a Filename First (Optional) #

If you want users to input a custom filename before downloading, add a frontend input field, send that filename to your controller via a query parameter or form data, then use it in the code:

// Update the action to accept a custom filename parameter
public FileStreamResult SaveData(string? customFileName = null) 
{ 
    var data = this.GetData();
    var jsonContent = JsonConvert.SerializeObject(data); 
    var byteArray = System.Text.Encoding.UTF8.GetBytes(jsonContent); 
    var stream = new MemoryStream(byteArray); 
    // Use the custom filename if provided, else fall back to the default
    string fileName = customFileName ?? "Configuration.json"; 
    data.Save = false; 

    var result = new FileStreamResult(stream, "application/json") 
    { 
        FileDownloadName = fileName 
    };
    
    Response.Headers.Add("Content-Disposition", $"attachment; filename=\"{fileName}\"");
    
    return result;
}

Note: You can’t control the download path from the backend—that’s entirely up to the user’s browser settings, which is a security feature to prevent unauthorized access to the user’s local file system.

内容的提问来源于stack exchange，提问作者tolik