Microsoft.Extensions.Http 10.0.4

About

Microsoft.Extensions.Http package provides AddHttpClient extension methods for IServiceCollection, IHttpClientFactory interface and its default implementation. This provides the ability to set up named HttpClient configurations in a DI container and later retrieve them via an injected IHttpClientFactory instance.

Key Features

  • The package allows to fluently set up multiple HttpClient configurations for applications that use DI via AddHttpClient extension method.
  • HttpClientFactory caches HttpMessageHandler instances per configuration name, which allows to reuse resources between HttpClient instances to avoid port exhaustion.
  • HttpClientFactory manages lifetime of HttpMessageHandler instances and recycles connections to track DNS changes.

How to Use

Note that lifetime management of HttpClient instances created by HttpClientFactory is completely different from instances created manually. The strategies are to use either short-lived clients created by HttpClientFactory or long-lived clients with PooledConnectionLifetime set up. For more information, see the HttpClient lifetime management section in the conceptual docs and Guidelines for using HTTP clients.

Configuring HttpClient

builder.Services.AddHttpClient("foo"); // adding an HttpClient named "foo" with a default configuration

builder.Services.AddHttpClient("example", c => c.BaseAddress = new Uri("https://www.example.com")) // configuring HttpClient itself
    .AddHttpMessageHandler<MyAuthHandler>() // adding additional delegating handlers to form a message handler chain
    .ConfigurePrimaryHttpMessageHandler(b => new HttpClientHandler() { AllowAutoRedirect = false }) // configuring primary handler
    .SetHandlerLifetime(TimeSpan.FromMinutes(30)); // changing the handler recycling interval

Using the configured HttpClient

public class MyService
{
    public MyService(IHttpClientFactory httpClientFactory)
    {
        _httpClientFactory = httpClientFactory; // injecting the factory
    }

    private Task<string> GetExampleAsync(Uri uri, CancellationToken ct)
    {
        HttpClient exampleClient = _httpClientFactory.CreateClient("example"); // creating the client for the specified name
        return exampleClient.GetStringAsync(uri, ct); // using the client
    }
}

Main Types

The main types provided by this library are:

  • IHttpClientFactory
  • IHttpMessageHandlerFactory
  • HttpClientFactoryServiceCollectionExtensions

Additional Documentation

Feedback & Contributing

Microsoft.Extensions.Http is released as open source under the MIT license. Bug reports and contributions are welcome at the GitHub repository.

Showing the top 20 packages that depend on Microsoft.Extensions.Http.

Packages Downloads
Mpesa.Gate
Package Description
 134
Mpesa.Gate
Package Description
 175
Mpesa.Gate
Package Description
 424
Sentry.Extensions.Logging
Official Microsoft.Extensions.Logging integration for Sentry - Open-source error tracking that helps developers monitor and fix crashes in real time.
 132
Sentry.Extensions.Logging
Official Microsoft.Extensions.Logging integration for Sentry - Open-source error tracking that helps developers monitor and fix crashes in real time.
 133
Sentry.Extensions.Logging
Official Microsoft.Extensions.Logging integration for Sentry - Open-source error tracking that helps developers monitor and fix crashes in real time.
 134
Sentry.Extensions.Logging
Official Microsoft.Extensions.Logging integration for Sentry - Open-source error tracking that helps developers monitor and fix crashes in real time.
 137
Sentry.Extensions.Logging
Official Microsoft.Extensions.Logging integration for Sentry - Open-source error tracking that helps developers monitor and fix crashes in real time.
 138
Sentry.Extensions.Logging
Official Microsoft.Extensions.Logging integration for Sentry - Open-source error tracking that helps developers monitor and fix crashes in real time.
 140
Sentry.Extensions.Logging
Official Microsoft.Extensions.Logging integration for Sentry - Open-source error tracking that helps developers monitor and fix crashes in real time.
 142
Sentry.Extensions.Logging
Official Microsoft.Extensions.Logging integration for Sentry - Open-source error tracking that helps developers monitor and fix crashes in real time.
 147
Sentry.Extensions.Logging
Official Microsoft.Extensions.Logging integration for Sentry - Open-source error tracking that helps developers monitor and fix crashes in real time.
 152
Sentry.Extensions.Logging
Official Microsoft.Extensions.Logging integration for Sentry - Open-source error tracking that helps developers monitor and fix crashes in real time.
 156
Sentry.Extensions.Logging
Official Microsoft.Extensions.Logging integration for Sentry - Open-source error tracking that helps developers monitor and fix crashes in real time.
 160
Sentry.Extensions.Logging
Official Microsoft.Extensions.Logging integration for Sentry - Open-source error tracking that helps developers monitor and fix crashes in real time.
 163

https://go.microsoft.com/fwlink/?LinkID=799421

.NET Framework 4.6.2

.NET Standard 2.0

.NET 10.0

.NET 9.0

.NET 8.0

Version Downloads Last updated
11.0.0-preview.2.26159.112 9 03/12/2026
11.0.0-preview.1.26104.118 14 02/11/2026
10.0.5 7 03/12/2026
10.0.4 5 03/12/2026
10.0.3 11 02/11/2026
10.0.2 16 01/13/2026
10.0.1 49 12/12/2025
10.0.0 63 11/12/2025
10.0.0-rc.2.25502.107 48 10/15/2025
10.0.0-rc.1.25451.107 77 09/11/2025
10.0.0-preview.7.25380.108 69 08/13/2025
10.0.0-preview.6.25358.103 63 07/17/2025
10.0.0-preview.5.25277.114 71 06/09/2025
10.0.0-preview.4.25258.110 102 05/15/2025
10.0.0-preview.3.25171.5 88 04/14/2025
10.0.0-preview.2.25163.2 106 04/01/2025
10.0.0-preview.1.25080.5 93 04/02/2025
9.0.14 4 03/12/2026
9.0.13 10 02/11/2026
9.0.12 16 01/14/2026
9.0.11 42 11/12/2025
9.0.10 68 10/15/2025
9.0.9 75 09/11/2025
9.0.8 83 08/05/2025
9.0.7 87 07/08/2025
9.0.6 76 06/12/2025
9.0.5 115 05/16/2025
9.0.4 91 04/10/2025
9.0.3 98 03/31/2025
9.0.2 94 03/15/2025
9.0.1 101 03/31/2025
9.0.0 166 11/14/2024
9.0.0-rc.2.24473.5 90 10/21/2024
9.0.0-rc.1.24431.7 96 10/23/2024
9.0.0-preview.7.24405.7 88 08/20/2024
9.0.0-preview.6.24327.7 114 07/23/2024
9.0.0-preview.5.24306.7 143 07/23/2024
9.0.0-preview.4.24266.19 134 07/23/2024
9.0.0-preview.3.24172.9 137 07/23/2024
9.0.0-preview.2.24128.5 129 07/23/2024
9.0.0-preview.1.24080.9 127 07/23/2024
8.0.1 108 10/21/2024
8.0.0 138 02/13/2024
8.0.0-rc.2.23479.6 137 07/21/2024
8.0.0-rc.1.23419.4 134 07/23/2024
8.0.0-preview.7.23375.6 139 07/23/2024
8.0.0-preview.6.23329.7 118 07/23/2024
8.0.0-preview.5.23280.8 110 07/23/2024
8.0.0-preview.4.23259.5 131 07/23/2024
8.0.0-preview.3.23174.8 138 07/23/2024
8.0.0-preview.2.23128.3 118 07/23/2024
8.0.0-preview.1.23110.8 114 07/23/2024
7.0.0 108 07/23/2024
7.0.0-rc.2.22472.3 111 07/23/2024
7.0.0-rc.1.22426.10 123 07/23/2024
7.0.0-preview.7.22375.6 118 07/23/2024
7.0.0-preview.6.22324.4 107 07/22/2024
7.0.0-preview.5.22301.12 102 07/23/2024
7.0.0-preview.4.22229.4 108 07/23/2024
7.0.0-preview.3.22175.4 123 07/23/2024
7.0.0-preview.2.22152.2 125 07/23/2024
7.0.0-preview.1.22076.8 127 07/23/2024
6.0.2-mauipre.1.22054.8 99 04/08/2025
6.0.1 104 11/14/2024
6.0.0 197 02/04/2024
6.0.0-rc.2.21480.5 111 07/23/2024
6.0.0-rc.1.21451.13 109 07/23/2024
6.0.0-preview.7.21377.19 116 07/23/2024
6.0.0-preview.6.21352.12 108 07/23/2024
6.0.0-preview.5.21301.5 107 07/23/2024
6.0.0-preview.4.21253.7 106 07/23/2024
6.0.0-preview.3.21201.4 97 07/23/2024
6.0.0-preview.2.21154.6 110 07/23/2024
6.0.0-preview.1.21102.12 120 07/23/2024
5.0.0 121 07/23/2024
5.0.0-rc.2.20475.5 125 07/18/2024
5.0.0-rc.1.20451.14 120 07/23/2024
5.0.0-preview.8.20407.11 128 07/23/2024
5.0.0-preview.7.20364.11 105 07/23/2024
5.0.0-preview.6.20305.6 110 07/19/2024
5.0.0-preview.5.20278.1 105 07/23/2024
5.0.0-preview.4.20251.6 117 07/23/2024
5.0.0-preview.3.20215.2 139 07/23/2024
5.0.0-preview.2.20160.3 119 07/23/2024
5.0.0-preview.1.20120.4 115 07/23/2024
3.1.32 133 07/23/2024
3.1.31 129 07/23/2024
3.1.30 124 07/23/2024
3.1.29 123 07/23/2024
3.1.28 123 07/23/2024
3.1.27 109 07/23/2024
3.1.26 130 07/23/2024
3.1.25 119 07/23/2024
3.1.24 126 07/23/2024
3.1.23 117 07/22/2024
3.1.22 125 07/23/2024
3.1.21 127 07/19/2024
3.1.20 127 07/23/2024
3.1.19 103 07/23/2024
3.1.18 123 07/20/2024
3.1.17 125 07/23/2024
3.1.16 108 07/23/2024
3.1.15 133 07/23/2024
3.1.14 116 07/23/2024
3.1.13 120 07/23/2024
3.1.12 129 07/20/2024
3.1.11 120 07/23/2024
3.1.10 113 07/23/2024
3.1.9 121 07/23/2024
3.1.8 118 07/23/2024
3.1.7 117 07/23/2024
3.1.6 140 07/23/2024
3.1.5 127 07/23/2024
3.1.4 113 07/23/2024
3.1.3 117 07/23/2024
3.1.2 119 07/23/2024
3.1.1 115 07/23/2024
3.1.0 120 07/23/2024
3.1.0-preview3.19553.2 104 07/23/2024
3.1.0-preview2.19525.4 114 07/23/2024
3.1.0-preview1.19506.1 126 07/23/2024
3.0.3 123 07/23/2024
3.0.2 131 07/23/2024
3.0.1 114 07/23/2024
3.0.0 122 07/23/2024
3.0.0-rc1.19456.10 116 07/23/2024
3.0.0-preview9.19423.4 118 07/23/2024
3.0.0-preview8.19405.4 111 07/23/2024
3.0.0-preview7.19362.4 115 07/23/2024
3.0.0-preview6.19304.6 122 07/23/2024
3.0.0-preview5.19227.9 122 07/23/2024
3.0.0-preview4.19216.2 133 07/23/2024
3.0.0-preview3.19153.1 133 07/23/2024
3.0.0-preview.19074.2 124 07/23/2024
3.0.0-preview.18572.1 111 07/23/2024
2.2.0 122 07/23/2024
2.2.0-preview3-35497 108 07/20/2024
2.2.0-preview2-35157 120 07/23/2024
2.2.0-preview1-35029 127 07/23/2024
2.1.1 117 07/21/2024
2.1.0 140 07/23/2024
2.1.0-rc1-final 115 07/23/2024
2.1.0-preview2-final 109 07/23/2024
2.1.0-preview1-final 110 07/23/2024