轻松操控C#下载文件:WebClient与HttpClient实战详解

作者:微信公众号:【架构师老卢】
12-28 8:23
51

概述:C#中通过WebClient或HttpClient可以轻松实现从URL下载文件,包括处理下载进度和失败情况。这涉及网络请求、文件流处理等技术,可根据项目需求选择不同的方法。

在C#中,从URL下载文件是常见的网络操作之一。实现下载涉及到网络请求、文件流处理等方面的知识。

原理

文件下载的原理是通过HTTP请求从指定URL获取文件的字节流,并将字节流写入本地文件。下载进度通常通过监控字节流的接收情况来计算。

下载文件的方法

WebClient类

WebClient 是.NET Framework中用于处理Web请求的类,可以方便地下载文件。

HttpClient类

HttpClient 是较新的.NET类,用于发送HTTP请求。它提供更灵活的控制和异步操作。

处理下载进度

通过在下载过程中监听响应流的变化,可以实时计算并展示下载进度。

处理下载失败

在下载失败时,可以捕获异常并根据具体错误进行处理,例如重试或提示用户。

示例源代码

使用WebClient下载文件

using System.Net;

WebClient client = new WebClient();
client.DownloadFile("https://example.com/file.zip", "local/path/file.zip");

使用HttpClient下载文件(包含下载进度)

using System.Net.Http;
using System.IO;

async Task DownloadFileAsync(string url, string localPath)
{
    using (HttpClient client = new HttpClient())
    {
        using (HttpResponseMessage response = await client.GetAsync(url, HttpCompletionOption.ResponseHeadersRead))
        {
            using (Stream stream = await response.Content.ReadAsStreamAsync())
            {
                using (FileStream fileStream = new FileStream(localPath, FileMode.Create, FileAccess.Write, FileShare.None, 8192, true))
                {
                    byte[] buffer = new byte[8192];
                    int bytesRead;
                    long totalBytesRead = 0;
                    long totalBytes = response.Content.Headers.ContentLength ?? -1;

                    while ((bytesRead = await stream.ReadAsync(buffer, 0, buffer.Length)) > 0)
                    {
                        await fileStream.WriteAsync(buffer, 0, bytesRead);
                        totalBytesRead += bytesRead;
                        // 处理下载进度,例如更新UI
                        Console.WriteLine($"下载进度:{totalBytesRead}/{totalBytes}");
                    }
                }
            }
        }
    }
}

注意事项及建议

  • 使用HttpClient时,需要注意管理异步操作,确保下载进度的准确性。
  • 下载进度的更新通常需要在UI线程进行,可以使用DispatcherTask.Run等方法。
  • 对下载失败的情况进行适当的错误处理,例如捕获异常并记录日志。

从URL下载文件在C#中可通过WebClientHttpClient实现。处理下载进度可通过监控响应流来实现,而处理下载失败则需要适时捕获异常。选择合适的方法取决于项目需求和开发者的偏好。

阅读排行