Microsoft.Extensions.Http 10.0.7

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
138
Mpesa.Gate
Package Description
181
Mpesa.Gate
Package Description
445
Sentry.Extensions.Logging
Official Microsoft.Extensions.Logging integration for Sentry - Open-source error tracking that helps developers monitor and fix crashes in real time.
135
Sentry.Extensions.Logging
Official Microsoft.Extensions.Logging integration for Sentry - Open-source error tracking that helps developers monitor and fix crashes in real time.
136
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.
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.
141
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.
143
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.
159
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
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.
170

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.3.26207.106 5 04/14/2026
11.0.0-preview.2.26159.112 13 03/12/2026
11.0.0-preview.1.26104.118 21 02/11/2026
10.0.7 2 04/21/2026
10.0.6 5 04/14/2026
10.0.5 14 03/12/2026
10.0.4 12 03/12/2026
10.0.3 16 02/11/2026
10.0.2 23 01/13/2026
10.0.1 55 12/12/2025
10.0.0 72 11/12/2025
10.0.0-rc.2.25502.107 53 10/15/2025
10.0.0-rc.1.25451.107 85 09/11/2025
10.0.0-preview.7.25380.108 81 08/13/2025
10.0.0-preview.6.25358.103 67 07/17/2025
10.0.0-preview.5.25277.114 79 06/09/2025
10.0.0-preview.4.25258.110 107 05/15/2025
10.0.0-preview.3.25171.5 92 04/14/2025
10.0.0-preview.2.25163.2 111 04/01/2025
10.0.0-preview.1.25080.5 100 04/02/2025
9.0.15 5 04/14/2026
9.0.14 13 03/12/2026
9.0.13 18 02/11/2026
9.0.12 22 01/14/2026
9.0.11 50 11/12/2025
9.0.10 73 10/15/2025
9.0.9 83 09/11/2025
9.0.8 90 08/05/2025
9.0.7 95 07/08/2025
9.0.6 82 06/12/2025
9.0.5 121 05/16/2025
9.0.4 98 04/10/2025
9.0.3 105 03/31/2025
9.0.2 99 03/15/2025
9.0.1 111 03/31/2025
9.0.0 175 11/14/2024
9.0.0-rc.2.24473.5 96 10/21/2024
9.0.0-rc.1.24431.7 103 10/23/2024
9.0.0-preview.7.24405.7 90 08/20/2024
9.0.0-preview.6.24327.7 120 07/23/2024
9.0.0-preview.5.24306.7 149 07/23/2024
9.0.0-preview.4.24266.19 138 07/23/2024
9.0.0-preview.3.24172.9 143 07/23/2024
9.0.0-preview.2.24128.5 134 07/23/2024
9.0.0-preview.1.24080.9 134 07/23/2024
8.0.1 120 10/21/2024
8.0.0 143 02/13/2024
8.0.0-rc.2.23479.6 145 07/21/2024
8.0.0-rc.1.23419.4 142 07/23/2024
8.0.0-preview.7.23375.6 143 07/23/2024
8.0.0-preview.6.23329.7 125 07/23/2024
8.0.0-preview.5.23280.8 113 07/23/2024
8.0.0-preview.4.23259.5 135 07/23/2024
8.0.0-preview.3.23174.8 146 07/23/2024
8.0.0-preview.2.23128.3 124 07/23/2024
8.0.0-preview.1.23110.8 118 07/23/2024
7.0.0 113 07/23/2024
7.0.0-rc.2.22472.3 114 07/23/2024
7.0.0-rc.1.22426.10 128 07/23/2024
7.0.0-preview.7.22375.6 123 07/23/2024
7.0.0-preview.6.22324.4 114 07/22/2024
7.0.0-preview.5.22301.12 105 07/23/2024
7.0.0-preview.4.22229.4 114 07/23/2024
7.0.0-preview.3.22175.4 129 07/23/2024
7.0.0-preview.2.22152.2 129 07/23/2024
7.0.0-preview.1.22076.8 132 07/23/2024
6.0.2-mauipre.1.22054.8 107 04/08/2025
6.0.1 107 11/14/2024
6.0.0 208 02/04/2024
6.0.0-rc.2.21480.5 115 07/23/2024
6.0.0-rc.1.21451.13 117 07/23/2024
6.0.0-preview.7.21377.19 128 07/23/2024
6.0.0-preview.6.21352.12 111 07/23/2024
6.0.0-preview.5.21301.5 111 07/23/2024
6.0.0-preview.4.21253.7 110 07/23/2024
6.0.0-preview.3.21201.4 104 07/23/2024
6.0.0-preview.2.21154.6 118 07/23/2024
6.0.0-preview.1.21102.12 130 07/23/2024
5.0.0 128 07/23/2024
5.0.0-rc.2.20475.5 132 07/18/2024
5.0.0-rc.1.20451.14 123 07/23/2024
5.0.0-preview.8.20407.11 133 07/23/2024
5.0.0-preview.7.20364.11 113 07/23/2024
5.0.0-preview.6.20305.6 126 07/19/2024
5.0.0-preview.5.20278.1 116 07/23/2024
5.0.0-preview.4.20251.6 121 07/23/2024
5.0.0-preview.3.20215.2 146 07/23/2024
5.0.0-preview.2.20160.3 124 07/23/2024
5.0.0-preview.1.20120.4 120 07/23/2024
3.1.32 138 07/23/2024
3.1.31 137 07/23/2024
3.1.30 129 07/23/2024
3.1.29 129 07/23/2024
3.1.28 129 07/23/2024
3.1.27 114 07/23/2024
3.1.26 134 07/23/2024
3.1.25 125 07/23/2024
3.1.24 134 07/23/2024
3.1.23 124 07/22/2024
3.1.22 129 07/23/2024
3.1.21 131 07/19/2024
3.1.20 132 07/23/2024
3.1.19 107 07/23/2024
3.1.18 127 07/20/2024
3.1.17 130 07/23/2024
3.1.16 114 07/23/2024
3.1.15 146 07/23/2024
3.1.14 123 07/23/2024
3.1.13 126 07/23/2024
3.1.12 134 07/20/2024
3.1.11 125 07/23/2024
3.1.10 117 07/23/2024
3.1.9 127 07/23/2024
3.1.8 125 07/23/2024
3.1.7 126 07/23/2024
3.1.6 146 07/23/2024
3.1.5 131 07/23/2024
3.1.4 119 07/23/2024
3.1.3 126 07/23/2024
3.1.2 123 07/23/2024
3.1.1 121 07/23/2024
3.1.0 128 07/23/2024
3.1.0-preview3.19553.2 109 07/23/2024
3.1.0-preview2.19525.4 122 07/23/2024
3.1.0-preview1.19506.1 132 07/23/2024
3.0.3 129 07/23/2024
3.0.2 136 07/23/2024
3.0.1 120 07/23/2024
3.0.0 129 07/23/2024
3.0.0-rc1.19456.10 120 07/23/2024
3.0.0-preview9.19423.4 123 07/23/2024
3.0.0-preview8.19405.4 119 07/23/2024
3.0.0-preview7.19362.4 119 07/23/2024
3.0.0-preview6.19304.6 129 07/23/2024
3.0.0-preview5.19227.9 127 07/23/2024
3.0.0-preview4.19216.2 136 07/23/2024
3.0.0-preview3.19153.1 138 07/23/2024
3.0.0-preview.19074.2 127 07/23/2024
3.0.0-preview.18572.1 114 07/23/2024
2.2.0 128 07/23/2024
2.2.0-preview3-35497 112 07/20/2024
2.2.0-preview2-35157 126 07/23/2024
2.2.0-preview1-35029 132 07/23/2024
2.1.1 122 07/21/2024
2.1.0 147 07/23/2024
2.1.0-rc1-final 127 07/23/2024
2.1.0-preview2-final 113 07/23/2024
2.1.0-preview1-final 116 07/23/2024