在C#中根据URL下载文件并保存到本地,可以使用以下方法(推荐使用现代异步方式)

方法1:使用 HttpClient(异步,推荐)

csharp

复制代码
using System;
using System.IO;
using System.Net.Http;
using System.Threading.Tasks;

class FileDownloader
{
    public static async Task DownloadFileAsync(string url, string localFilePath)
    {
        using (HttpClient httpClient = new HttpClient())
        {
            try
            {
                // 发送GET请求
                HttpResponseMessage response = await httpClient.GetAsync(url, HttpCompletionOption.ResponseHeadersRead);
                response.EnsureSuccessStatusCode(); // 确保响应成功

                // 创建文件流
                using (FileStream fileStream = new FileStream(localFilePath, FileMode.Create, FileAccess.Write, FileShare.None))
                {
                    // 将网络流复制到文件流
                    await response.Content.CopyToAsync(fileStream);
                }
            }
            catch (Exception ex)
            {
                Console.WriteLine($"下载失败: {ex.Message}");
                throw;
            }
        }
    }
}

// 使用示例
await FileDownloader.DownloadFileAsync(
    "https://example.com/files/document.pdf",
    @"C:\Downloads\document.pdf"
);

方法2:使用 WebClient(同步/异步,旧版方法)

csharp

复制代码
using System.Net;

// 异步版本
public static async Task DownloadWithWebClientAsync(string url, string savePath)
{
    using (WebClient client = new WebClient())
    {
        await client.DownloadFileTaskAsync(new Uri(url), savePath);
    }
}

// 同步版本(不推荐,会阻塞线程)
public static void DownloadWithWebClient(string url, string savePath)
{
    using (WebClient client = new WebClient())
    {
        client.DownloadFile(url, savePath);
    }
}

方法3:高级 HttpClient(支持进度报告)

csharp

复制代码
public static async Task DownloadWithProgressAsync(string url, string savePath, IProgress<float> progress = null)
{
    using (HttpClient httpClient = new HttpClient())
    {
        HttpResponseMessage response = await httpClient.GetAsync(url, HttpCompletionOption.ResponseHeadersRead);
        response.EnsureSuccessStatusCode();

        using (Stream contentStream = await response.Content.ReadAsStreamAsync())
        using (FileStream fileStream = new FileStream(savePath, FileMode.Create))
        {
            var totalBytes = response.Content.Headers.ContentLength.GetValueOrDefault();
            var buffer = new byte[8192];
            long bytesRead = 0;
            int bytesReceived;

            while ((bytesReceived = await contentStream.ReadAsync(buffer, 0, buffer.Length)) > 0)
            {
                await fileStream.WriteAsync(buffer, 0, bytesReceived);
                bytesRead += bytesReceived;
                
                // 报告进度(如果有)
                progress?.Report((float)bytesRead / totalBytes);
            }
        }
    }
}

// 使用带进度条的示例
var progress = new Progress<float>(p => Console.WriteLine($"下载进度: {p:P}"));
await DownloadWithProgressAsync(
    "https://example.com/largefile.zip",
    @"C:\Downloads\largefile.zip",
    progress
);

注意事项:

  1. 异常处理:务必添加 try-catch 处理网络异常、文件权限问题等

  2. 路径安全:检查本地路径是否合法,目录是否存在

    csharp

    复制代码
    var directory = Path.GetDirectoryName(savePath);
    if (!Directory.Exists(directory)) Directory.CreateDirectory(directory);
  3. 文件名提取:从URL自动获取文件名

    csharp

    复制代码
    string GetFileNameFromUrl(string url)
    {
        Uri uri = new Uri(url);
        return Path.GetFileName(uri.LocalPath);
    }
  4. 超时设置

    csharp

    复制代码
    httpClient.Timeout = TimeSpan.FromMinutes(30); // 设置超时时间
  5. 取消支持:可添加 CancellationToken 支持取消操作

推荐方案:

  • 现代应用使用 HttpClient + 异步流复制(方法1或方法3)

  • 需要进度报告时使用带缓冲读取的方法3

  • 简单脚本可使用 WebClient 简化代码

  • 始终使用异步方法避免阻塞UI线程

根据实际需求选择合适的方法,并添加必要的错误处理和资源清理逻辑。

相关推荐
茉莉玫瑰花茶8 分钟前
C++ 17 详细特性解析(4)
开发语言·c++·算法
rosmis18 分钟前
地铁病害检测系统软件改进记录-2-02
开发语言·前端·javascript
欧阳x天30 分钟前
STL详解(九)—— stack和queue的模拟实现
开发语言·c++
xqqxqxxq31 分钟前
洛谷算法1-1 模拟与高精度(NOIP经典真题解析)java(持续更新)
java·开发语言·算法
沐知全栈开发36 分钟前
Rust 函数
开发语言
zhougl9961 小时前
Java 枚举类(enum)详解
java·开发语言·python
yong99901 小时前
基于势能原理的圆柱齿轮啮合刚度计算MATLAB程序实现
开发语言·matlab
lsx2024061 小时前
R 数组:深入探索与高效使用
开发语言
星火开发设计1 小时前
格式化输入输出:控制输出精度与对齐方式
开发语言·c++·学习·算法·函数·知识
1104.北光c°2 小时前
【黑马点评项目笔记 | 登录篇】Redis实现共享Session登录
java·开发语言·数据库·redis·笔记·spring·java-ee