C# HttpClient 分片下载、断点续传、暂停取消（完整项目知识点）

一、基础概念必考1. 客户端与服务端客户端请求数据的一端本机程序服务端提供资源、响应请求的一端云端服务器2. HTTP 协议与工具类HttpClient.NET 官方 HTTP 请求客户端专门用于网络上传、下载、接口请求URL资源网络地址完整访问地址URIURL 转换后的统一资源唯一标识程序请求必须使用 URI 对象3. 三种 HTTP 请求方式本案例核心HEAD只请求响应头只获取文件信息大小、类型不下载内容、速度极快GET请求服务器资源正文用于真正下载文件数据POST向服务器提交数据本案例未使用二、核心功能介绍本项目实现完整工业级下载功能自定义保存路径文件夹选择器分片下载大文件分块分批下载避免一次性加载内存溢出断点续传暂停/关闭程序后再次下载自动从已下载位置接续不重复下载任务取消基于 CancellationTokenSource 安全终止下载实时进度更新进度条 百分比文本实时刷新按钮状态锁定防止重复点击冲突三、核心技术原理详解1. 断点续传原理下载前判断本地文件是否存在存在读取本地文件现有长度作为下次下载的起始位置通过Range 请求头告诉服务器从指定字节位置继续返回数据文件流使用Append 追加模式保留已有数据续写新数据2. 分片下载原理将超大文件切分为 1000 字节小分片循环请求每一段分片数据、逐段写入本地解决一次性读取超大文件导致的内存溢出、卡顿问题3. RangeHeaderValue 核心RangeHeaderValue(start,end)限定本次请求的文件字节范围是分片/断点下载的核心请求头4. 取消机制使用CancellationTokenSource令牌安全终止 HttpClient 请求与循环杜绝强行终止导致的文件损坏、线程卡死。四、完整代码分层解析1. 全局对象定义// 全局唯一HTTP请求客户端推荐全局静态避免频繁创建销毁 public static readonly HttpClient httpClient new HttpClient(); // 取消令牌控制下载终止 public CancellationTokenSource cts;2. 选择保存路径通过 FolderBrowserDialog 选择文件夹赋值给文本框作为文件保存根目录。3. 下载按钮核心逻辑非空校验必须设置保存路径、资源URL锁定界面按钮防止重复点击新建取消令牌Task.Run 开启后台下载不卡死UIContinueWith 回调下载完成解锁界面、提示完成4. 核心 Download 下载方法重点第一步HEAD 请求获取文件总大小使用 HEAD 方式请求只读取响应头 ContentLength获取服务器文件真实大小不下载内容高效快速。第二步判断本地文件实现断点续传文件不存在startPosition0从头创建下载文件存在读取已有长度从当前位置续写已下载完整直接抛出异常“文件已下载完成”第三步分片循环下载固定分片大小 1000 字节设置 Range 分段请求头GetAsync 获取分段数据文件流追加写入更新下载位置、刷新UI进度5. 取消下载逻辑cts.Cancel()触发取消信号循环检测IsCancellationRequested终止下载重置所有界面状态。6. 简单 Get 接口请求演示通过 GetAsync 直接请求网页接口读取字符串返回结果适用于普通接口调用。五、必考知识点总结HEAD 与 GET 区别HEAD拿文件信息GET拿文件内容断点续传核心判断本地文件长度 Range请求头 文件追加模式分片下载核心切割字节范围循环分段请求防止内存溢出异步不卡UITask.Run 后台执行耗时下载Invoke 更新界面安全取消任务CancellationToken 优雅终止杜绝暴力终止报错URI 作用将URL字符串转为程序可识别的统一资源对象HttpClient 规范全局静态单例使用不重复 new避免端口耗尽六、代码易错点下载属于耗时操作必须放子线程直接主线程下载会卡死UI更新进度条、文本必须 Invoke子线程不能直接操作UI每次下载必须new 新的 CancellationTokenSource令牌不可复用文件结尾分片需要判断边界防止 end 超出总文件大小断点续传必须使用 FileMode.Append 追加模式