0

0

C# WebClient下载文件方法 C#如何使用WebClient下载文件

月夜之吻

月夜之吻

发布时间:2026-03-12 12:39:32

|

277人浏览过

|

来源于php中文网

原创

webclient.downloadfile 会阻塞线程,ui 线程调用将导致界面卡死;应改用 downloadfileasync 或 task.run 包裹,认证需手动设 credentials 或 authorization header,大文件下载需节流进度更新,新项目应优先使用 httpclient。

c# webclient下载文件方法 c#如何使用webclient下载文件

WebClient.DownloadFile 会阻塞线程,别在 UI 线程直接调用

直接在 WinForms 或 WPF 的按钮点击事件里写 webClient.DownloadFile(url, path),界面会卡死。这不是 bug,是同步下载的必然行为。它会一直等到文件写完才返回,期间整个线程挂起。

实操建议:

  • DownloadFileAsync 替代 —— 它不阻塞,但需监听 DownloadProgressChangedDownloadFileCompleted 事件来更新进度和处理完成逻辑
  • 如果必须同步(比如控制台工具),至少用 Task.Run(() => webClient.DownloadFile(...)) 包一层,避免污染主线程
  • 注意:DownloadFileAsync 不支持取消,如需取消请改用 HttpClient + GetStreamAsync

WebClient.DownloadFile 报“远程服务器返回错误: (401) 未授权”

常见于需要认证的接口或私有 CDN 资源。WebClient 默认不带任何凭据,服务端直接拒掉。

实操建议:

  • 设置 webClient.Credentials = CredentialCache.DefaultCredentials(适用于 Windows 集成认证)
  • 对 Basic Auth,手动加 Header:webClient.Headers[HttpRequestHeader.Authorization] = "Basic " + Convert.ToBase64String(Encoding.ASCII.GetBytes("user:pass"))
  • 对 Bearer Token:webClient.Headers[HttpRequestHeader.Authorization] = "Bearer your-token-here"
  • 某些服务(如 GitHub API)还要求 User-Agent,漏掉也会 403:webClient.Headers[HttpRequestHeader.UserAgent] = "MyApp/1.0"

大文件下载时进度不准、回调频率高、内存暴涨

DownloadProgressChanged 事件默认每 1KB 触发一次,下载 1GB 文件就会触发百万次事件,UI 更新压力大,且内部缓冲策略可能导致 reported progress 跳变(比如从 23% 直跳到 57%)。

6款图片鼠标悬停效果JS代码
6款图片鼠标悬停效果JS代码

6款图片鼠标悬停效果JS代码,鼠标悬停在图片上后,文字标题以6种不同的动画形式出现,兼容主流浏览器,php中文网推荐下载! 使用方法: 1、head区域引用css文件,modernizr.custom.js 2、在文件中加入!-- 代码 开始 --!-- 代码 结束 --区域代码 3、复制images文件夹里的图片到相应的路径

下载

实操建议:

  • Threading.TimerDispatcherTimer 做节流,在 UI 线程中每 200–500ms 更新一次进度条,而不是每次事件都更新
  • 检查 e.ProgressPercentage 是否为 -1(表示无法获取总大小),此时应改用 e.BytesReceived 和预估总长做计算,别硬绑进度条 Value
  • 避免在事件里做耗时操作(如写日志到磁盘、JSON 序列化),否则拖慢整个下载流程

WebClient 已过时,新项目优先用 HttpClient

.NET Core 2.1+ 和 .NET 5+ 中,WebClient 被标记为“遗留类型”,官方文档明确建议迁移到 HttpClient。它更轻量、支持取消、可复用、配合 async/await 更自然。

实操建议:

  • httpClient.GetAsync(url, HttpCompletionOption.ResponseHeadersRead) 获取响应头,再用 response.Content.ReadAsStreamAsync() 流式读取,边下边写到 FileStream
  • 务必使用 using var stream = await response.Content.ReadAsStreamAsync(),防止连接泄漏
  • 取消下载只需传入 cancellationTokenGetAsync 和后续读取中,无需自己管理状态

WebClient 看似简单,但异常处理、超时控制、重试、Cookie 管理这些实际需求一上来,代码很快变得臃肿。HttpClient 虽然初看多几行,但边界清晰、可控性强——尤其当你需要支持断点续传或自定义 DNS 解析时,WebClient 几乎没法扩展。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

455

2023.08.07

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

546

2023.08.23

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

334

2023.10.13

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

82

2025.09.10

cookie
cookie

Cookie 是一种在用户计算机上存储小型文本文件的技术,用于在用户与网站进行交互时收集和存储有关用户的信息。当用户访问一个网站时,网站会将一个包含特定信息的 Cookie 文件发送到用户的浏览器,浏览器会将该 Cookie 存储在用户的计算机上。之后,当用户再次访问该网站时,浏览器会向服务器发送 Cookie,服务器可以根据 Cookie 中的信息来识别用户、跟踪用户行为等。

6500

2023.06.30

document.cookie获取不到怎么解决
document.cookie获取不到怎么解决

document.cookie获取不到的解决办法:1、浏览器的隐私设置;2、Same-origin policy;3、HTTPOnly Cookie;4、JavaScript代码错误;5、Cookie不存在或过期等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

368

2023.11.23

阻止所有cookie什么意思
阻止所有cookie什么意思

阻止所有cookie意味着在浏览器中禁止接受和存储网站发送的cookie。阻止所有cookie可能会影响许多网站的使用体验,因为许多网站使用cookie来提供个性化服务、存储用户信息或跟踪用户行为。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

446

2024.02.23

cookie与session的区别
cookie与session的区别

本专题整合了cookie与session的区别和使用方法等相关内容,阅读专题下面的文章了解更详细的内容。

97

2025.08.19

C# ASP.NET Core微服务架构与API网关实践
C# ASP.NET Core微服务架构与API网关实践

本专题围绕 C# 在现代后端架构中的微服务实践展开,系统讲解基于 ASP.NET Core 构建可扩展服务体系的核心方法。内容涵盖服务拆分策略、RESTful API 设计、服务间通信、API 网关统一入口管理以及服务治理机制。通过真实项目案例,帮助开发者掌握构建高可用微服务系统的关键技术,提高系统的可扩展性与维护效率。

76

2026.03.11

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
C# 教程
C# 教程

共94课时 | 11.1万人学习

C 教程
C 教程

共75课时 | 5.4万人学习

C++教程
C++教程

共115课时 | 21.5万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号