在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线程

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

相关推荐
禹凕4 小时前
Python编程——进阶知识(多线程)
开发语言·爬虫·python
蜡笔小马4 小时前
10.Boost.Geometry R-tree 空间索引详解
开发语言·c++·算法·r-tree
IOsetting4 小时前
金山云主机添加开机路由
运维·服务器·开发语言·网络·php
唐梓航-求职中4 小时前
编程-技术-算法-leetcode-288. 单词的唯一缩写
算法·leetcode·c#
林开落L5 小时前
从零开始学习Protobuf(C++实战版)
开发语言·c++·学习·protobuffer·结构化数据序列化机制
牛奔5 小时前
Go 是如何做抢占式调度的?
开发语言·后端·golang
符哥20085 小时前
C++ 进阶知识点整理
java·开发语言·jvm
小猪咪piggy5 小时前
【Python】(4) 列表和元组
开发语言·python
難釋懷5 小时前
Lua脚本解决多条命令原子性问题
开发语言·lua
CoderCodingNo5 小时前
【GESP】C++ 二级真题解析,[2025年12月]第一题环保能量球
开发语言·c++·算法