C#怎么发起HTTP请求 C# HttpClient使用方法详解

来源:这里教程网 时间:2026-02-21 17:33:24 作者:

在C#中发起HTTP请求,推荐且现代的方式是使用

HttpClient
。它线程安全、支持异步、可复用,是.NET Core/.NET 5+ 中的首选HTTP客户端。别再用已过时的
WebClient
或难管理的
HttpWebRequest

创建和复用 HttpClient 实例

HttpClient
设计上**不是一次性对象**,频繁 new 会导致端口耗尽(Socket Exhaustion)。正确做法是全局复用一个实例(如用
static
字段或依赖注入):

在控制台或简单场景中:声明为
static readonly HttpClient
在ASP.NET Core中:通过
services.AddHttpClient()
注册,由DI容器管理生命周期
避免在方法内
using var client = new HttpClient()
(除非明确短时、低频调用)

发起 GET 请求(字符串响应)

最常用场景:获取API返回的JSON或文本:

GetStringAsync(url)
直接得到字符串(自动处理UTF-8解码)
GetAsync(url)
获取
HttpResponseMessage
,可检查状态码、读取内容流、自定义头等

示例:

var json = await client.GetStringAsync("https://api.example.com/users");

发送 POST 请求(JSON数据)

向API提交结构化数据,通常用JSON:

JsonSerializer.Serialize()
(.NET Core 3.0+)或
System.Text.Json
序列化对象
包装成
StringContent
,指定
"application/json"
类型
调用
PostAsync(url, content)

示例:

var data = new { Name = "张三", Age = 25 };
var json = JsonSerializer.Serialize(data);
var content = new StringContent(json, Encoding.UTF8, "application/json");
var response = await client.PostAsync("https://api.example.com/users", content);

设置请求头、超时与错误处理

实际项目中需关注健壮性:

通过
client.DefaultRequestHeaders
添加通用头,如
Authorization
User-Agent
超时用
client.Timeout = TimeSpan.FromSeconds(10);
(注意:不能设为无限,也不能在请求中动态改)
务必检查
response.IsSuccessStatusCode
;非2xx响应不会自动抛异常,需手动处理
try/catch
捕获
HttpRequestException
(网络失败、DNS错误等)

基本上就这些。掌握这四点,就能覆盖95%的HTTP调用需求。不复杂但容易忽略复用和异常细节。

相关推荐