如何使用VB.NET结合WebClient实现ListBox多文件下载及状态展示

架构老林

2026-8-27

解答

完全可以通过WebClient实现你提到的批量下载需求，不需要编写冗余的逐文件串行等待逻辑，借助WebClient自带的异步方法和事件回调，就能很方便地实现下载速度、单文件大小、整体进度的实时展示，核心实现逻辑如下：

前置准备
遍历ListBox控件的所有项提取全部待下载链接，先通过HEAD请求逐个获取文件的Content-Length，累加得到所有文件的总大小，作为整体进度计算的基准值。同时定义几个全局变量：累计已下载总字节数、上一次速度统计的时间戳、上一次统计时的已接收字节数，用于后续数据计算。
避免串行繁琐逻辑的实现方式
不要用同步的DownloadFile方法写嵌套的串行下载流程，直接调用异步方法DownloadFileTaskAsync即可，单文件下载完成后自动调度下一个文件的下载任务，全程不会阻塞UI线程，也不需要手写线程同步、等待的冗余代码。注意每个文件下载时都新建独立的WebClient实例，不要复用同一个实例，避免状态冲突。
实时指标统计方案
- 当前文件大小/单文件进度：为WebClient绑定DownloadProgressChanged事件，事件参数会直接返回当前文件的已接收字节数、当前文件总字节数，直接读取即可更新对应UI展示。
- 实时下载速度：在DownloadProgressChanged事件触发时累计字节增量，每隔1秒做一次计算：用统计周期内的字节增量除以周期时长，就能得到稳定的实时下载速度，计算完成后重置统计标记即可，避免数值频繁跳变。
- 整体任务进度：每次收到字节增量时，把增量累加到全局的已下载总字节数中，用「累计已下载总字节数 / 所有文件总大小」计算得到整体进度百分比。
跨线程UI注意事项
因为异步下载的事件回调不在UI线程上，更新控件前记得检查跨线程调用要求，避免触发窗体线程访问异常。

核心参考代码（C# WinForm场景）：

// 全局统计变量
private long _totalDownloaded = 0;
private long _allFileTotalSize = 0;
private long _lastRecordBytes = 0;
private DateTime _lastRecordTime = DateTime.Now;

// 批量下载启动逻辑
private async void StartBtn_Click(object sender, EventArgs e)
{
    // 先遍历获取所有文件总大小
    foreach (string url in listBox1.Items)
    {
        var headReq = WebRequest.CreateHttp(url);
        headReq.Method = "HEAD";
        using var resp = headReq.GetResponse();
        _allFileTotalSize += resp.ContentLength;
    }

    // 逐个调度下载任务
    foreach (string url in listBox1.Items)
    {
        using var client = new WebClient();
        var fileName = Path.GetFileName(new Uri(url).LocalPath);
        var savePath = Path.Combine(Application.StartupPath, fileName);
        
        // 绑定进度事件
        client.DownloadProgressChanged += Client_DownloadProgressChanged;
        // 异步下载文件
        await client.DownloadFileTaskAsync(url, savePath);
        // 单文件下载完成后重置单文件统计标记
        _lastRecordBytes = 0;
        _lastRecordTime = DateTime.Now;
    }
    MessageBox.Show("全部下载完成");
}

private void Client_DownloadProgressChanged(object sender, DownloadProgressChangedEventArgs e)
{
    // 计算字节增量
    var byteInc = e.BytesReceived - _lastRecordBytes;
    _totalDownloaded += byteInc;
    _lastRecordBytes = e.BytesReceived;

    // 每秒刷新一次速度
    var timeSpan = (DateTime.Now - _lastRecordTime).TotalSeconds;
    if (timeSpan >= 1)
    {
        var speed = byteInc / timeSpan / 1024 / 1024;
        lblSpeed.Text = $"下载速度：{speed:0.00} MB/s";
        _lastRecordTime = DateTime.Now;
        _lastRecordBytes = 0;
    }

    // 更新当前文件大小展示
    lblCurrentFile.Text = $"当前文件：{e.BytesReceived/1024/1024:0.00}MB / {e.TotalBytesToReceive/1024/1024:0.00}MB";
    // 更新整体进度
    progressBarTotal.Value = (int)(_totalDownloaded * 100 / _allFileTotalSize);
}

注：如果使用的是.NET Core/.NET 5+版本，WebClient已被标记为过时，也可以换用HttpClient实现相同逻辑，事件绑定、进度计算的思路完全一致。

内容的提问来源于stack exchange，提问作者Marzouk