Content-Disposition的使用和注意事项

最新推荐文章于 2024-09-14 21:00:00 发布

遛弯鱼

最新推荐文章于 2024-09-14 21:00:00 发布

阅读量1.5w

点赞数

分类专栏： asp.net 文章标签： string web开发浏览器服务器 byte token

asp.net 专栏收录该内容

9 篇文章 0 订阅

订阅专栏

转自 http://www.cnblogs.com/jzaileen/articles/1281025.html

Content-disposition是MIME协议的扩展MIME协议指示MIME用户代理如何显示附加的文件.当Internet Explorer接收到头时,它会激活文件下载对话框,它的文件名框自动填充了头中指定的文件名.(请注意,这是设计导致的;无法将此功能将文档保存到用户计算机上,而不向用户询问保存位置.)

Content-disposition就是当用户想把请求所得内容存为一个文件的提供一个默认的文件名.具体的定义如下:

content-disposition = "Content-Disposition" ":"

disposition-type * (";"disposition-parm)

disposition-type = "attachment' | disp-extension-token

disposition-parm = filename-parm | disp-extension-parm

filename-parm = "filename" "=" quoted-parm (quoted 引用的)

disp-extension-token = token

disp-extension-parm = token "=" (token | quoted-string)

那么可举例为 Content-Disposition:attachment;filename = "filename.xls"

当然filename中可以包含路径信息,但是User-Agent会自动忽略这些信息,只会将路径的最后一部分作为文件名.当你的响应类型为application/octet-stream情况下使用了这个头信息的话,那就意味着你不想直接显示内容,而是弹出一个文件下载的对话框,接下来就是你决定是"打开"还是"保存"了.

如Response.AppendHeader("Content-Disposition","attachment;filename=MyExcel.xls");

python使用了一个例子

print"Content-type:application/x-pcap"

print"Content-Disposition:attachment;filename=\"filename.pcap\"\n"

最近不少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”，使用该方法客户端就不会出现乱码了。

需要注意以下几个问题：