C#使用HttpClient发起HTTP请求的完整指南
更新时间：2025年11月06日 10:16:26 作者：拾荒的小海螺
本文介绍了在.NET中使用HttpClient进行RESTful API调用的方法,HttpClient是.NET中处理HTTP请求的核心类,支持多种HTTP方法、异步请求和JSON序列化,文章强调要重用HttpClient实例以避免端口耗尽问题,需要的朋友可以参考下
1、简述
在现代应用中，调用 RESTful API 已成为日常开发中不可或缺的一部分。无论你在开发桌面程序、Web 服务还是后台任务，HttpClient 都是 .NET 提供的官方网络请求利器。
本文将带你深入了解 HttpClient 的使用方式，并通过多个实践样例帮助你快速掌握它。
2、HttpClient 是什么？
HttpClient 是 .NET 中用于发送 HTTP 请求和接收响应的核心类，属于命名空间：
using System.Net.Http;
它支持：
- GET / POST / PUT / DELETE 等 HTTP 方法
- 异步请求（基于 async/await）
- 自定义请求头与内容类型
- 连接复用与超时控制
- JSON 数据序列化与反序列化
创建 HttpClient 实例
最基础的创建方式如下：
var client = new HttpClient();
但是要注意：
不要在每次请求时 new HttpClient()！
因为它会导致连接未及时释放，引起端口耗尽问题。
正确的做法是：
- 在应用生命周期内 重用 HttpClient 实例；
- 或使用 HttpClientFactory（在 ASP.NET Core 中推荐）。
3、实践样例
下面我们从最常见的 GET 与 POST 请求 开始。
示例 1：GET 请求
using System;
using System.Net.Http;
using System.Threading.Tasks;
class Program
{
static async Task Main()
{
using var client = new HttpClient();
var url = "https://api.github.com/repos/dotnet/runtime";
// 设置 User-Agent，否则 GitHub API 会拒绝访问
client.DefaultRequestHeaders.Add("User-Agent", "CSharpHttpClientDemo");
var response = await client.GetAsync(url);
response.EnsureSuccessStatusCode(); // 确保状态码 200-299
var content = await response.Content.ReadAsStringAsync();
Console.WriteLine("返回内容：");
Console.WriteLine(content);
}
}
输出为 JSON 格式的仓库信息。
示例 2：POST 请求（发送 JSON 数据）
using System;
using System.Net.Http;
using System.Text;
using System.Threading.Tasks;
using System.Text.Json;
class Program
{
static async Task Main()
{
using var client = new HttpClient();
var url = "https://httpbin.org/post";
var data = new { Name = "Alice", Age = 25 };
var json = JsonSerializer.Serialize(data);
var content = new StringContent(json, Encoding.UTF8, "application/json");
var response = await client.PostAsync(url, content);
var result = await response.Content.ReadAsStringAsync();
Console.WriteLine("响应内容：");
Console.WriteLine(result);
}
}
该示例演示了如何：
- 将 C# 对象序列化为 JSON；
- 使用
StringContent设置请求体； - 指定
Content-Type为application/json。
4、其他常用操作
1、设置请求头
client.DefaultRequestHeaders.Add("Authorization", "Bearer your_token_here");
client.DefaultRequestHeaders.Add("Accept", "application/json");
2、PUT / DELETE 请求
// PUT 请求
var putContent = new StringContent("{\"name\":\"Bob\"}", Encoding.UTF8, "application/json");
var putResponse = await client.PutAsync("https://httpbin.org/put", putContent);
// DELETE 请求
var deleteResponse = await client.DeleteAsync("https://httpbin.org/delete");
3、超时与异常处理
client.Timeout = TimeSpan.FromSeconds(10);
try
{
var response = await client.GetAsync("https://slowwly.robertomurray.co.uk/delay/5000/url/http://example.com");
Console.WriteLine(await response.Content.ReadAsStringAsync());
}
catch (TaskCanceledException)
{
Console.WriteLine("请求超时！");
}
4、反序列化 JSON 响应
using System.Text.Json;
var jsonStr = await response.Content.ReadAsStringAsync();
var repoInfo = JsonSerializer.Deserialize<Repo>(jsonStr);
Console.WriteLine($"项目名称：{repoInfo.name}");
Console.WriteLine($"Star 数：{repoInfo.stargazers_count}");
class Repo
{
public string name { get; set; }
public int stargazers_count { get; set; }
}
5、天气查询程序
这是一个实际的 API 调用案例，使用 Open-Meteo API 查询天气：
using System;
using System.Net.Http;
using System.Text.Json;
using System.Threading.Tasks;
class Program
{
static async Task Main()
{
using var client = new HttpClient();
string url = "https://api.open-meteo.com/v1/forecast?latitude=35&longitude=139¤t_weather=true";
var response = await client.GetAsync(url);
response.EnsureSuccessStatusCode();
var json = await response.Content.ReadAsStringAsync();
var weather = JsonSerializer.Deserialize<WeatherResponse>(json);
Console.WriteLine($"当前温度：{weather.current_weather.temperature} °C");
Console.WriteLine($"风速：{weather.current_weather.windspeed} km/h");
}
}
class WeatherResponse
{
public CurrentWeather current_weather { get; set; }
}
class CurrentWeather
{
public double temperature { get; set; }
public double windspeed { get; set; }
}
运行结果示例：
当前温度：21.3 °C 风速：5.2 km/h
6、HttpClientFactory（进阶用法）
在 ASP.NET Core 中，推荐使用 IHttpClientFactory 管理 HttpClient 实例：
// Startup.cs
services.AddHttpClient("GitHub", client =>
{
client.BaseAddress = new Uri("https://api.github.com/");
client.DefaultRequestHeaders.Add("User-Agent", "MyApp");
});
使用时：
public class GitHubService
{
private readonly HttpClient _client;
public GitHubService(IHttpClientFactory factory)
{
_client = factory.CreateClient("GitHub");
}
public async Task<string> GetRepoAsync(string name)
{
var response = await _client.GetAsync($"repos/{name}");
return await response.Content.ReadAsStringAsync();
}
}
优点：
- 自动管理连接生命周期；
- 支持命名客户端；
- 避免 Socket 耗尽；
- 更易于测试与扩展。
| 功能 | 方法 |
|---|---|
| GET 请求 | GetAsync() |
| POST 请求 | PostAsync() |
| PUT 请求 | PutAsync() |
| DELETE 请求 | DeleteAsync() |
| 添加头部 | DefaultRequestHeaders.Add() |
| 设置超时 | client.Timeout |
| 反序列化 JSON | JsonSerializer.Deserialize<T>() |
7、结语
通过本文你学到了：
- 如何在 C# 中使用 HttpClient 发起各种 HTTP 请求；
- 如何发送 JSON、处理响应与异常；
- 如何在实际项目中使用 HttpClientFactory 优化性能。
建议：在生产环境中，始终重用 HttpClient 或使用 IHttpClientFactory，并注意请求超时与重试机制。
以上就是C#使用HttpClient发起HTTP请求的完整指南的详细内容，更多关于C# HttpClient发起HTTP请求的资料请关注脚本之家其它相关文章！
相关文章
这篇文章主要介绍了C#中Equals和GetHashCode使用及区别，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧2020-02-02
这篇文章介绍了c# 图片加密解密的实例代码，有需要的朋友可以参考一下2013-08-08
本文介绍利用C#中内置的系统函数判断一个集合是否是一个集合的子集的方法，此方法代码量极少，分享给大家。2016-04-04
C# DataTable.Select()根据条件筛选数据问题
这篇文章主要介绍了C# DataTable.Select()根据条件筛选数据问题，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教2023-01-01
在C#中,将UTC时间转换为JST（日本标准时间,即UTC+9）时间可以通过使用 DateTime 和 TimeZoneInfo 类来实现,JST比UTC快9小时,因此可以直接进行转换,本文将通过代码示例给大家介绍C#中将UTC时间转换为JST时间,需要的朋友可以参考下2025-01-01
这篇文章主要介绍了C#使用foreach语句遍历二维数组的方法,实例分析了C#遍历数组的技巧,具有一定参考借鉴价值,需要的朋友可以参考下2015-04-04
C# 使用multipart form-data方式post数据到服务器
这篇文章主要介绍了C# 使用multipart form-data方式post数据到服务器，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧2020-08-08
这篇文章主要介绍了c#递归生成XML的方法,以实例形式较为详细的介绍了C#的递归算法与XML操作技巧,非常具有实用价值,需要的朋友可以参考下2014-11-11
本文给大家介绍了在C#中，事件(event)的概念和使用方法，文章适合一些初学者学习，主要讲解了一些概念和一些代码案例。2018-01-01
这篇文章主要为大家详细介绍了Unity调取移动端的麦克风进行录音并播放，文中示例代码介绍的非常详细，具有一定的参考价值，感兴趣的小伙伴们可以参考一下2019-06-06
最新评论