.NET 6 网络编程重大变更：WebRequest、WebClient 和 ServicePoint 已过时

.NET 6 网络编程重大变更：WebRequest、WebClient 和 ServicePoint 已过时

docs This repository contains .NET Documentation. 项目地址: https://gitcode.com/gh_mirrors/docs2/docs

前言

在 .NET 6 中，微软对网络编程相关类库做出了一项重要调整：将 WebRequest、WebClient 和 ServicePoint 类标记为过时（obsolete）。这一变更反映了 .NET 平台向现代化网络编程模型的演进方向，也意味着开发者需要调整现有的网络请求实现方式。

变更概述

受影响类

以下核心网络类已被标记为过时：

• System.Net.WebRequest 及其派生类（HttpWebRequest、FtpWebRequest）
• System.Net.WebClient
• System.Net.ServicePoint

编译器警告

当代码中使用这些类的构造函数时，编译器将生成 SYSLIB0014 警告。

历史背景

这些类最初是在 .NET Core 2.0 中为了向后兼容性而引入的。然而，它们存在一些设计上的缺陷和性能问题：

1. WebRequest.GetRequestStream 会为整个响应分配内存，这在处理大文件时会导致内存压力
2. WebClient.CancelAsync 并不能保证立即取消操作
3. 整体设计不符合现代异步编程的最佳实践

替代方案

推荐使用 HttpClient

HttpClient 类已成为 .NET 中执行 HTTP 请求的标准方式，具有以下优势：

• 更好的性能表现
• 更清晰的异步编程模型
• 内置连接池管理
• 更灵活的扩展点

FTP 解决方案

由于 HttpClient 不支持 FTP 协议，建议：

• 使用专门的第三方 FTP 库
• 考虑将 FTP 服务迁移到 HTTP/HTTPS 协议

迁移指南

基础 HTTP 请求示例

旧方式 (WebRequest):

WebRequest request = WebRequest.Create("https://example.com");
using WebResponse response = request.GetResponse();
using Stream stream = response.GetResponseStream();
// 处理响应流

新方式 (HttpClient):

using HttpClient client = new HttpClient();
using HttpResponseMessage response = await client.GetAsync("https://example.com");
using Stream stream = await response.Content.ReadAsStreamAsync();
// 处理响应流

文件下载示例

旧方式 (WebClient):

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

新方式 (HttpClient):

using HttpClient client = new HttpClient();
using Stream stream = await client.GetStreamAsync("https://example.com/file.zip");
using FileStream fs = File.Create("local.zip");
await stream.CopyToAsync(fs);

注意事项

1. 单例模式：HttpClient 设计为可重用，应避免频繁创建和销毁实例
2. 超时控制：通过 HttpClient.Timeout 属性设置请求超时
3. 头部设置：使用 DefaultRequestHeaders 属性配置默认请求头

总结

.NET 6 对网络编程模型的这一调整，标志着平台向更现代化、高性能的网络编程方式演进。虽然现有代码仍能工作，但新项目应优先使用 HttpClient。对于必须维护的旧代码，可以考虑逐步迁移，或使用 #pragma warning disable SYSLIB0014 暂时抑制警告。

这一变更最终将带来更可靠、更高效的网络编程体验，符合现代应用程序对网络操作的需求。

docs This repository contains .NET Documentation. 项目地址: https://gitcode.com/gh_mirrors/docs2/docs