脚本之家 服务器常用软件
快捷导航
您的位置：首页 → 软件编程 → C#教程 → C# HttpClient发起HTTP请求

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&current_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
反序列化 JSONJsonSerializer.Deserialize<T>()

7、结语

通过本文你学到了：

  • 如何在 C# 中使用 HttpClient 发起各种 HTTP 请求；
  • 如何发送 JSON、处理响应与异常；
  • 如何在实际项目中使用 HttpClientFactory 优化性能。

建议：在生产环境中，始终重用 HttpClient 或使用 IHttpClientFactory，并注意请求超时与重试机制。

以上就是C#使用HttpClient发起HTTP请求的完整指南的详细内容，更多关于C# HttpClient发起HTTP请求的资料请关注脚本之家其它相关文章！

您可能感兴趣的文章:

相关文章

  • 基于C#实现手机号码归属地接口调用

    基于C#实现手机号码归属地接口调用

    这篇文章主要介绍了基于C#实现手机号码归属地接口调用的相关资料,需要的朋友可以参考下
    2016-02-02
  • c#和javascript函数相互调用示例分享

    c#和javascript函数相互调用示例分享

    在webBrowser使用过程中为了C#和JS通讯，webBrowser必须设置ObjectForScripting的属性，它是一个object,这个object可以提供给webBrowser控件载入的网页上的script访问
    2014-01-01
  • C#制作简单的多人在线即时交流聊天室

    C#制作简单的多人在线即时交流聊天室

    这篇文章主要介绍了C#制作简单的多人在线即时交流聊天室的相关资料,需要的朋友可以参考下
    2015-11-11
  • C#如何实现图片的剪裁并保存

    C#如何实现图片的剪裁并保存

    基于c#实现图片的裁剪并保存功能，实现方法非常简单的，前端采用的cropper插件，但是在本文中没有给大家多介绍，需要的朋友可以到脚本之家去查找这个插件。好了，如果大家对c#实现图片裁剪并保存功能感兴趣的朋友一起看看吧
    2016-11-11
  • C#生成设置范围内的Double类型随机数的方法

    C#生成设置范围内的Double类型随机数的方法

    这篇文章主要介绍了C#生成设置范围内的Double类型随机数的方法,对于C#的初学者有很好的借鉴价值,需要的朋友可以参考下
    2014-08-08
  • C#二分查找算法

    C#二分查找算法

    这篇文章介绍了C#中的二分查找算法，文中通过示例代码介绍的非常详细。对大家的学习或工作具有一定的参考借鉴价值，需要的朋友可以参考下
    2022-05-05
  • C# 可空值类型的具体使用

    C# 可空值类型的具体使用

    在C#编程中,可空值类型是一个非常有用的特性,它允许我们将值类型表示为可空,这在处理一些可能没有值的情况时非常方便,具有一定的参考价值,感兴趣的可以了解一下
    2025-07-07
  • C#.NET采用HTML模板发送电子邮件完整实例

    C#.NET采用HTML模板发送电子邮件完整实例

    这篇文章主要介绍了C#.NET采用HTML模板发送电子邮件的方法,主要包括了HTML模板、替换函数与邮件函数三部分,是非常实用的功能,需要的朋友可以参考下
    2014-09-09
  • C# 拼图游戏的实战(附demo)

    C# 拼图游戏的实战(附demo)

    拼图游戏是常见的一种游戏，本文详细的介绍了C#实现拼图游戏，文中通过示例代码介绍的非常详细，具有一定的参考价值，感兴趣的小伙伴们可以参考一下
    2021-11-11
  • MessageBox的Buttons和三级联动效果

    MessageBox的Buttons和三级联动效果

    这篇文章主要介绍了MessageBox的Buttons和三级联动的相关资料,非常不错，具有参考借鉴价值，需要的朋友可以参考下
    2016-11-11

最新评论