Content-Disposition 的使用和注意事项

作者:Qihangnet 来源:Qihangnet的博客 日期:2010-1-12

最近不少 Web 技术圈内的朋友在讨论协议方面的事情,有的说 web 开发者应该熟悉 web 相关的协议,有的则说不用很了解。个人认为这要分层次来看待这个问题,对于一个新手或者刚入门的 web 开发人员而言,研究协议方面的东西可能会使得 web 开发失去趣味性、抹煞学习积极性,这类人应该更多的了解基本的 Web 技术使用。而对于在该行业工作多年的老鸟来说,协议相关的内容、标准相关内容应该尽量多些的了解,因为只有这样才能使得经手的 web 系统更加优秀(安全、漂亮、快速、兼容性好、体验好……)。本文我们来说一下 MIME 协议的一个扩展 Content-disposition。

我们在开发 web 系统时有时会有以下需求:

  • 希望某类或者某已知 MIME 类型的文件(比如:*.gif;*.txt;*.htm)能够在访问时弹出“文件下载”对话框
  • 希望以原始文件名(上传时的文件名 , 例如:山东省政府 1024 号文件 .doc)提供下载,但服务器上保存的地址却是其他文件名(如:12519810948091234_asdf.doc)
  • 希望某文件直接在浏览器上显示而不是弹出文件下载对话框
  • ……………………

要解决上述需求就可以使用 Content-disposition 来解决。第一个需求的解决办法是

Response.AddHeader "content-disposition","attachment; filename=fname.ext"

将上述需求进行归我给出如下例子代码:

public static void ToDownload(string serverfilpath,string filename)
{
    FileStream fileStream = new FileStream(serverfilpath, FileMode.Open);
    long fileSize = fileStream.Length;
    HttpContext.Current.Response.ContentType = "application/octet-stream";
    HttpContext.Current.Response.AddHeader("Content-Disposition", "attachment; filename=\"" + UTF_FileName(filename) + "\";");
    ////attachment --- 作为附件下载
    ////inline --- 在线打开
    HttpContext.Current.Response.AddHeader("Content-Length", fileSize.ToString());
    byte[] fileBuffer = new byte[fileSize];
    fileStream.Read(fileBuffer, 0, (int)fileSize);
    HttpContext.Current.Response.BinaryWrite(fileBuffer);
    fileStream.Close();
    HttpContext.Current.Response.End();
}
 
public static void ToOpen(string serverfilpath, string filename)
{
    FileStream fileStream = new FileStream(serverfilpath, FileMode.Open);
    long fileSize = fileStream.Length;
    HttpContext.Current.Response.ContentType = "application/octet-stream";
    HttpContext.Current.Response.AddHeader("Content-Disposition", "inline; filename=\"" + UTF_FileName(filename) + "\";");
    HttpContext.Current.Response.AddHeader("Content-Length", fileSize.ToString());
    byte[] fileBuffer = new byte[fileSize];
    fileStream.Read(fileBuffer, 0, (int)fileSize);
    HttpContext.Current.Response.BinaryWrite(fileBuffer);
    fileStream.Close();
    HttpContext.Current.Response.End();
}
 
private static string UTF_FileName(string filename)
{
    return HttpUtility.UrlEncode(filename, System.Text.Encoding.UTF8);
}

简单的对上述代码做一下解析,ToDownload 方法为将一个服务器上的文件(ServerFilpath 为服务器上的物理地址),以某文件名(filename)在浏览器上弹出“文件下载”对话框,而 ToOpen 是将服务器上的某文件以某文件名在浏览器中显示/打开的。注意其中我使用了 UTF_FileName 方法,该方法很简单,主要为了解决包含非英文/数字名称的问题,比如说文件名为“衣明志 .doc”,使用该方法客户端就不会出现乱码了。

需要注意以下几个问题:

  • Content-disposition 是 MIME 协议的扩展,由于多方面的安全性考虑没有被标准化,所以可能某些浏览器不支持,比如说 IE 4.01。
  • 我们可以使用程序来使用它,也可以在 Web 服务器(比如 IIS)上使用它,只需要在 http header 上做相应的设置即可。
相关文章