C#使用WebClient下载文件时进度条始终显示0%问题求助

嘿，刚上手C#和WPF遇到这种问题太正常了！别着急，我帮你捋清楚进度条不动的原因，再给你改好代码～

首先，你进度条始终0%的核心问题大概率是这两个：

1. 你用了同步下载方法（比如DownloadFile），它会直接卡住UI线程，不仅进度条更不了，整个界面都可能假死；
2. 没正确注册WebClient的进度变化事件，或者更新UI的时候没切换回UI线程。

下面是帮你调整后的完整解决方案，直接套进去就能用：

第一步：确保XAML里的进度条配置正确 #

先确认你的进度条是这样的（如果已经有了就跳过）：

<ProgressBar x:Name="downloadProgressBar" 
             Minimum="0" 
             Maximum="100" 
             Height="20" 
             Margin="10"/>

Maximum设为100是因为WebClient返回的进度百分比刚好是0-100的数值，匹配起来最方便。

第二步：修改C#代码，用异步下载+进度事件 #

using System;
using System.Net;
using System.Windows;

public partial class YourWindow : Window // 换成你实际的窗口类名
{
    private WebClient _downloadClient;

    public YourWindow()
    {
        InitializeComponent();
        StartDownload();
    }

    private void StartDownload()
    {
        _downloadClient = new WebClient();

        // 关键1：注册进度变化事件，每次下载进度更新都会触发这个方法
        _downloadClient.DownloadProgressChanged += OnDownloadProgressChanged;
        // 关键2：注册下载完成事件，处理结束后的逻辑（成功/失败/取消）
        _downloadClient.DownloadFileCompleted += OnDownloadCompleted;

        // 替换成你的目标文件URL和本地保存路径
        string targetUrl = "https://your-target-file-url.com/file.exe";
        string savePath = @"C:\Your\Save\Path\file.exe";

        // 关键3：用异步下载方法，不会阻塞UI线程，还能触发进度事件
        _downloadClient.DownloadFileAsync(new Uri(targetUrl), savePath);
    }

    private void OnDownloadProgressChanged(object sender, DownloadProgressChangedEventArgs e)
    {
        // 重点！WPF的UI控件只能在UI线程更新，所以用Dispatcher切回去
        Dispatcher.Invoke(() =>
        {
            downloadProgressBar.Value = e.ProgressPercentage;
            // 要是想显示具体字节数，可以加个TextBlock：
            // downloadStatus.Text = $"已下载 {e.BytesReceived / 1024:N0} KB / 总计 {e.TotalBytesToReceive / 1024:N0} KB";
        });
    }

    private void OnDownloadCompleted(object sender, AsyncCompletedEventArgs e)
    {
        Dispatcher.Invoke(() =>
        {
            if (e.Error != null)
            {
                MessageBox.Show($"下载出错啦：{e.Error.Message}");
            }
            else if (e.Cancelled)
            {
                MessageBox.Show("下载被取消了");
            }
            else
            {
                MessageBox.Show("文件下载完成！");
                downloadProgressBar.Value = 100; // 确保进度条拉满
            }

            // 用完记得释放资源，避免内存泄漏
            _downloadClient.Dispose();
        });
    }
}

几个要注意的关键点： #

• 别再用DownloadFile同步方法了！它会把UI线程卡死，进度事件根本触发不了；
• 一定要用Dispatcher.Invoke更新UI：WebClient的后台线程不能直接操作UI控件，必须通过Dispatcher切换到UI线程；
• 记得处理下载完成/出错的情况，不然用户根本不知道下载到底成没成。

按这个改完，你的进度条应该就能正常跳了～要是还有问题，随时说！

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