在ASP.NET中支持断点续传下载大文件(ZT)源码

在ASP.NET中实现大文件的断点续传下载功能已经成为许多开发者的需求。本文将为你揭示如何在IE的自带下载功能基础上，利用HTTP协议中的特定响应头和请求头实现断点续传功能。

一、理解两个关键响应头：Aept-Ranges和ETag。

在客户端发起下载请求时，服务端必须添加这两个响应头，以确保客户端和服务端识别此下载为可断点续传的类型。Aept-Ranges响应头告知下载客户端这是一个可以恢复续传的下载，并包含本次下载的开始字节位置和文件的总字节大小。而ETag则保存文件的唯一标识，通常结合文件名和文件修改时间使用，以便于续传时对文件进行验证。Last-Modified是一个可选的响应头，存放服务端的文件修改时间，用于验证文件是否有所变动。

二、掌握一个重要的请求头：Range。

在进行初次下载时，Range请求头为null，此时服务端必须回应Aept-Ranges和ETag响应头。当进行续传请求时，Range头的值表示客户端已经接收到的字节数，即本次下载的开始位置。服务端依据这个值从相应位置读取数据并发送到客户端，从而实现断点续传。

三、了解验证请求头：If-Range和Unless-Modified-Since。

当响应头包含Aept-Ranges和ETag时，续传请求将包含这些请求头。If-Range对应响应头ETag的值，Unless-Modified-Since对应响应头Last-Modified的值。为了保证客户端与服务端文件的一致性和正确性，需要进行文件验证。这需要开发者自行编写验证代码，通过这两个请求头的值，将客户端已下载的部分与服务端文件进行对比。

四、速度限制功能。

程序中加入了速度限制功能，用于对客户端进行流量控制，实现权限管理。

除此之外，还需注意其他事项，如文件名乱码问题、文件名中空格变加号以及强制客户端显示下载对话框等。这些问题的解决方案在源码注释中有详细说明。

在网络的浩瀚海洋中，文件的下载是再常见不过的操作。有时候一个小小的空格，都可能引发大问题。当文件名中的空格在URL编码后变成"+"，浏览器却并不能理解这种转换。这就导致了一个现象：在浏览器下载的文件，原本文件名中的空格都变成了加号。

为了解决这个问题，我们需要对文件名进行UrlEncode编码后的特殊处理。将"+"替换成"%20"，因为浏览器会将%20识别为空格。这样，我们就能确保文件的原名能够准确无误地传送到用户的设备上。

在这个过程中，有一个重要的方法值得我们关注——DownloadFile。这个方法负责处理文件的下载请求，它的任务重大且复杂。下面，我们就来一起看看它的工作原理。

DownloadFile方法接收三个参数：当前请求的HttpContext、下载文件的物理路径（包含路径和文件名），以及下载速度的限制。这个方法的目标是尝试下载文件并返回下载是否成功的结果。

它会验证HTTP请求的方法，确保只接受GET和HEAD方法。如果请求的方法不是这两种，它会返回501的服务不可用状态码，表示不支持的HTTP方法。

接下来，它会检查文件是否存在。如果文件不存在，它会返回404的状态码，表示资源未找到。如果一切顺利，它会继续处理下载的逻辑。

在这个过程中，它会定义一些局部变量，包括文件流的起始位置、分块读取的大小（每块10K bytes）、文件名、文件流对象等。然后，它会进行一些重要的验证和处理，包括验证文件是否过大、是否是续传请求以及在上次被请求的日期之后文件是否被修改过。

它会设置一些重要的响应头，请求头并进行相关验证。它会清除响应内容、关闭缓冲、添加Content-MD5头用于验证文件的完整性、添加Aept-Ranges头以支持续传等。它还会设置MIME类型、内容编码等。如果请求头中包含Range头，表示是续传请求，它会获取续传的起始位置，即已经下载到客户端的字节数。这样，DownloadFile方法就完成了它的主要工作。

在初始下载时，我们从HTTP请求的头部获取范围信息，将其拆分为字符串数组。例如，范围值可能是"bytes=1474560-"这样的格式。我们从该字符串中出起始字节数，即已下载的字节数，也是本次下载的开始位置。

如果起始字节数小于0或大于等于文件总长度，那么这是一个无效的起始位置，我们应当返回失败。

如果起始字节数大于0，说明这是续传请求。在这种情况下，我们需要告诉客户端本次的开始字节数以及总长度，这样客户端就可以将续传的数据追加到正确的位置。我们通过添加HTTP响应头"Content-Range"来实现这一点，其格式如"bytes {0}-{1}/{2}"，其中{0}是起始字节数，{1}是文件总长度减1，{2}是文件总长度。

接下来，我们处理向客户端发送数据块的逻辑。我们将文件流指针移动到起始字节的位置。然后，我们计算剩余部分可以分成多少块，以便进行分块下载。在循环中，我们每次读取一块数据并写入HTTP响应流，直到所有块都被发送或者客户端断开连接。如果设置了暂停时间，我们将在每次循环后休眠一段时间。

如果在处理过程中遇到任何异常，我们将结果设置为false以表示失败。无论是否发生异常，我们都要确保关闭文件流和二进制阅读器。