这段代码的功能是声明一个公共静态异步方法,用于下载指定URL的文件并保存到指定路径中。
代码还支持传入一个进度回调函数和一个取消令牌,用于显示下载进度和取消下载任务。
----------
// 声明一个公共静态异步方法,用于下载指定URL的文件并保存到指定路径中
public static async Task<bool> DownloadFileAsync(string url, string fileName, Action<double> progress = default, System.Threading.CancellationToken cancelationToken = default)
{
try
{
// 使用HttpClient类创建一个HTTP客户端,指定不使用代理,并设置一个 CookieContainer
using (var httpClient = new System.Net.Http.HttpClient(new System.Net.Http.HttpClientHandler() {CookieContainer = new System.Net.CookieContainer(), UseProxy = false}))
using (var httpClient = new System.Net.Http.HttpClient(new System.Net.Http.HttpClientHandler() { Proxy = null, CookieContainer = new System.Net.CookieContainer() }))
{
// 发送GET请求,并等待响应
var response = await httpClient.GetAsync(new Uri(url), System.Net.Http.HttpCompletionOption.ResponseHeadersRead);
// 判断请求是否成功,如果失败则返回 false
if (!response.IsSuccessStatusCode)
{
return (false);
}
// 获取响应内容长度
long contentLength = response.Content.Headers.ContentLength ?? 0;
// 创建一个文件流,并将响应内容写入文件流
using (var fs = System.IO.File.Open(fileName, System.IO.FileMode.Create, System.IO.FileAccess.ReadWrite, System.IO.FileShare.Read))
{
// 创建一个缓冲区,大小为64KB
byte[] buffer = new byte[65536];
// 获取响应流
var httpStream = await response.Content.ReadAsStreamAsync();
// 定义变量,用于记录每次读取的字节数
int readLength = 0;
// 循环异步读取响应流的内容,直到读取完毕
while ((readLength = await httpStream.ReadAsync(buffer, 0, buffer.Length, cancelationToken)) > 0)
{
// 检查是否已经取消了任务
if (cancelationToken.IsCancellationRequested)
{
// 如果任务已经取消,关闭文件流,并删除已经下载的文件
fs.Close();
System.IO.File.Delete(fileName);
return (false);
}
// 将读取到的内容写入文件流,并调用进度回调函数
await fs.WriteAsync(buffer, 0, readLength, cancelationToken);
progress?.Invoke(Math.Round((double)fs.Length / contentLength * 100, 2));
}
}
}
// 返回true表示文件下载成功
return (true);
}
catch (Exception)
{
// 返回false表示文件下载失败
return (false);
}
}