Microsoft.Extensions.Http 11.0.0-preview.5.26302.115

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
Microsoft.AspNetCore.All
Provides a default set of APIs for building an ASP.NET Core application, and also includes API for third-party integrations with ASP.NET Core. This package requires the ASP.NET Core runtime. This runtime is installed by the .NET Core SDK, or can be acquired separately using installers available at https://aka.ms/dotnet-download.
149
Mpesa.Gate
Package Description
150
Mpesa.Gate
Package Description
193
Mpesa.Gate
Package Description
501
Sentry.Extensions.Logging
Official Microsoft.Extensions.Logging integration for Sentry - Open-source error tracking that helps developers monitor and fix crashes in real time.
148
Sentry.Extensions.Logging
Official Microsoft.Extensions.Logging integration for Sentry - Open-source error tracking that helps developers monitor and fix crashes in real time.
149
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.
153
Sentry.Extensions.Logging
Official Microsoft.Extensions.Logging integration for Sentry - Open-source error tracking that helps developers monitor and fix crashes in real time.
154
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.
157
Sentry.Extensions.Logging
Official Microsoft.Extensions.Logging integration for Sentry - Open-source error tracking that helps developers monitor and fix crashes in real time.
158
Sentry.Extensions.Logging
Official Microsoft.Extensions.Logging integration for Sentry - Open-source error tracking that helps developers monitor and fix crashes in real time.
168
Sentry.Extensions.Logging
Official Microsoft.Extensions.Logging integration for Sentry - Open-source error tracking that helps developers monitor and fix crashes in real time.
169
Sentry.Extensions.Logging
Official Microsoft.Extensions.Logging integration for Sentry - Open-source error tracking that helps developers monitor and fix crashes in real time.
176
Sentry.Extensions.Logging
Official Microsoft.Extensions.Logging integration for Sentry - Open-source error tracking that helps developers monitor and fix crashes in real time.
179
Sentry.Extensions.Logging
Official Microsoft.Extensions.Logging integration for Sentry - Open-source error tracking that helps developers monitor and fix crashes in real time.
182

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

.NET 10.0

.NET Standard 2.0

.NET Framework 4.6.2

.NET 11.0

Version Downloads Last updated
11.0.0-preview.5.26302.115 5 06/10/2026
11.0.0-preview.4.26230.115 11 05/13/2026
11.0.0-preview.3.26207.106 22 04/14/2026
11.0.0-preview.2.26159.112 28 03/12/2026
11.0.0-preview.1.26104.118 32 02/11/2026
10.0.9 5 06/10/2026
10.0.8 13 05/13/2026
10.0.7 27 04/21/2026
10.0.6 21 04/14/2026
10.0.5 31 03/12/2026
10.0.4 27 03/12/2026
10.0.3 26 02/11/2026
10.0.2 38 01/13/2026
10.0.1 70 12/12/2025
10.0.0 86 11/12/2025
10.0.0-rc.2.25502.107 71 10/15/2025
10.0.0-rc.1.25451.107 103 09/11/2025
10.0.0-preview.7.25380.108 97 08/13/2025
10.0.0-preview.6.25358.103 81 07/17/2025
10.0.0-preview.5.25277.114 89 06/09/2025
10.0.0-preview.4.25258.110 123 05/15/2025
10.0.0-preview.3.25171.5 103 04/14/2025
10.0.0-preview.2.25163.2 124 04/01/2025
10.0.0-preview.1.25080.5 120 04/02/2025
9.0.17 7 06/10/2026
9.0.16 8 05/13/2026
9.0.15 23 04/14/2026
9.0.14 24 03/12/2026
9.0.13 32 02/11/2026
9.0.12 37 01/14/2026
9.0.11 64 11/12/2025
9.0.10 90 10/15/2025
9.0.9 97 09/11/2025
9.0.8 103 08/05/2025
9.0.7 110 07/08/2025
9.0.6 97 06/12/2025
9.0.5 135 05/16/2025
9.0.4 115 04/10/2025
9.0.3 120 03/31/2025
9.0.2 112 03/15/2025
9.0.1 126 03/31/2025
9.0.0 192 11/14/2024
9.0.0-rc.2.24473.5 110 10/21/2024
9.0.0-rc.1.24431.7 114 10/23/2024
9.0.0-preview.7.24405.7 103 08/20/2024
9.0.0-preview.6.24327.7 132 07/23/2024
9.0.0-preview.5.24306.7 166 07/23/2024
9.0.0-preview.4.24266.19 154 07/23/2024
9.0.0-preview.3.24172.9 156 07/23/2024
9.0.0-preview.2.24128.5 146 07/23/2024
9.0.0-preview.1.24080.9 150 07/23/2024
8.0.1 137 10/21/2024
8.0.0 161 02/13/2024
8.0.0-rc.2.23479.6 157 07/21/2024
8.0.0-rc.1.23419.4 159 07/23/2024
8.0.0-preview.7.23375.6 160 07/23/2024
8.0.0-preview.6.23329.7 137 07/23/2024
8.0.0-preview.5.23280.8 131 07/23/2024
8.0.0-preview.4.23259.5 153 07/23/2024
8.0.0-preview.3.23174.8 159 07/23/2024
8.0.0-preview.2.23128.3 138 07/23/2024
8.0.0-preview.1.23110.8 135 07/23/2024
7.0.0 127 07/23/2024
7.0.0-rc.2.22472.3 124 07/23/2024
7.0.0-rc.1.22426.10 138 07/23/2024
7.0.0-preview.7.22375.6 135 07/23/2024
7.0.0-preview.6.22324.4 125 07/22/2024
7.0.0-preview.5.22301.12 120 07/23/2024
7.0.0-preview.4.22229.4 126 07/23/2024
7.0.0-preview.3.22175.4 138 07/23/2024
7.0.0-preview.2.22152.2 147 07/23/2024
7.0.0-preview.1.22076.8 147 07/23/2024
6.0.2-mauipre.1.22054.8 121 04/08/2025
6.0.1 123 11/14/2024
6.0.0 221 02/04/2024
6.0.0-rc.2.21480.5 128 07/23/2024
6.0.0-rc.1.21451.13 128 07/23/2024
6.0.0-preview.7.21377.19 147 07/23/2024
6.0.0-preview.6.21352.12 122 07/23/2024
6.0.0-preview.5.21301.5 123 07/23/2024
6.0.0-preview.4.21253.7 122 07/23/2024
6.0.0-preview.3.21201.4 117 07/23/2024
6.0.0-preview.2.21154.6 133 07/23/2024
6.0.0-preview.1.21102.12 146 07/23/2024
5.0.0 146 07/23/2024
5.0.0-rc.2.20475.5 142 07/18/2024
5.0.0-rc.1.20451.14 135 07/23/2024
5.0.0-preview.8.20407.11 144 07/23/2024
5.0.0-preview.7.20364.11 125 07/23/2024
5.0.0-preview.6.20305.6 138 07/19/2024
5.0.0-preview.5.20278.1 125 07/23/2024
5.0.0-preview.4.20251.6 136 07/23/2024
5.0.0-preview.3.20215.2 161 07/23/2024
5.0.0-preview.2.20160.3 138 07/23/2024
5.0.0-preview.1.20120.4 132 07/23/2024
3.1.32 151 07/23/2024
3.1.31 153 07/23/2024
3.1.30 143 07/23/2024
3.1.29 141 07/23/2024
3.1.28 142 07/23/2024
3.1.27 132 07/23/2024
3.1.26 147 07/23/2024
3.1.25 137 07/23/2024
3.1.24 151 07/23/2024
3.1.23 139 07/22/2024
3.1.22 148 07/23/2024
3.1.21 147 07/19/2024
3.1.20 147 07/23/2024
3.1.19 120 07/23/2024
3.1.18 138 07/20/2024
3.1.17 145 07/23/2024
3.1.16 127 07/23/2024
3.1.15 163 07/23/2024
3.1.14 138 07/23/2024
3.1.13 141 07/23/2024
3.1.12 150 07/20/2024
3.1.11 137 07/23/2024
3.1.10 131 07/23/2024
3.1.9 140 07/23/2024
3.1.8 144 07/23/2024
3.1.7 139 07/23/2024
3.1.6 160 07/23/2024
3.1.5 143 07/23/2024
3.1.4 130 07/23/2024
3.1.3 140 07/23/2024
3.1.2 135 07/23/2024
3.1.1 134 07/23/2024
3.1.0 140 07/23/2024
3.1.0-preview3.19553.2 121 07/23/2024
3.1.0-preview2.19525.4 135 07/23/2024
3.1.0-preview1.19506.1 144 07/23/2024
3.0.3 146 07/23/2024
3.0.2 149 07/23/2024
3.0.1 134 07/23/2024
3.0.0 145 07/23/2024
3.0.0-rc1.19456.10 133 07/23/2024
3.0.0-preview9.19423.4 134 07/23/2024
3.0.0-preview8.19405.4 134 07/23/2024
3.0.0-preview7.19362.4 132 07/23/2024
3.0.0-preview6.19304.6 139 07/23/2024
3.0.0-preview5.19227.9 141 07/23/2024
3.0.0-preview4.19216.2 147 07/23/2024
3.0.0-preview3.19153.1 151 07/23/2024
3.0.0-preview.19074.2 141 07/23/2024
3.0.0-preview.18572.1 127 07/23/2024
2.2.0 143 07/23/2024
2.2.0-preview3-35497 123 07/20/2024
2.2.0-preview2-35157 139 07/23/2024
2.2.0-preview1-35029 144 07/23/2024
2.1.1 139 07/21/2024
2.1.0 162 07/23/2024
2.1.0-rc1-final 143 07/23/2024
2.1.0-preview2-final 128 07/23/2024
2.1.0-preview1-final 128 07/23/2024