HttpClientHandler

As explained in ASP.NET Core in Action, 3e

HttpClientHandler is the .NET HttpMessageHandler that establishes network connections and sends HTTP requests for HttpClient.

HttpClientHandler is the final handler in HttpClient’s outbound pipeline. It opens the network connection and sends the HTTP request, while earlier HttpMessageHandlers can adjust the request or inspect the response. section 33.2.1 section 33.5

Its lifetime matters. Disposing handlers repeatedly can contribute to socket exhaustion, while keeping one handler forever can miss DNS changes. IHttpClientFactory separates HttpClient lifetime from handler lifetime, pools handlers, and periodically replaces them. section 33.2.1 section 33.5

Use the handler through IHttpClientFactory rather than managing its lifetime directly:

• Register the factory with AddHttpClient(). section 33.2.1
• Create an HttpClient with factory.CreateClient(); the factory supplies a managed HttpClientHandler. section 33.2.1
• Configure named or typed clients when different APIs need centralized settings or an abstraction over HTTP mechanics. section 33.5

A factory-managed request

builder.Services.AddHttpClient(); app.MapGet("/", async (IHttpClientFactory factory) => { HttpClient client = factory.CreateClient(); client.BaseAddress = new Uri("https://example.com/rates/"); var response = await client.GetAsync("latest"); response.EnsureSuccessStatusCode(); return await response.Content.ReadAsStringAsync(); }); The application configures and uses HttpClient, while IHttpClientFactory manages the underlying handler pipeline. section 33.2.1

Figure 33.4 Each HttpClient contains a pipeline of HttpMessageHandlers. The final handler is an HttpClientHandler, which makes the connection to the remote server and sends the HTTP request. This configuration is similar to the ASP.NET Core middleware pipeline, and it allows you to make cross-cutting adjustments to outgoing requests.

The pipeline diagram shows how HttpClient passes requests through multiple handlers before HttpClientHandler connects to the remote server. section 33.2.1

How ASP.NET Core in Action, 3e covers it

How deep it goes

Explains pipeline placement and lifetime problems, but defers detailed connection-management internals.

Examples

Uses AddHttpClient, factory.CreateClient, BaseAddress configuration, and an asynchronous GetAsync request.

What it assumes

Assumes HttpClient and HTTP request basics while establishing the handler pipeline from its network responsibility.

What you can do after

Apply it via IHttpClientFactory to make HTTP requests while avoiding common handler-lifetime problems.

How it connects

Connects HttpClientHandler with HttpClient, HttpMessageHandler, IHttpClientFactory, middleware pipelines, named clients, and typed clients.

liveBookmanning.com

Read ASP.NET Core in Action, 3e on liveBook Get the book at manning.com

Related concepts

• pipelinepart of · A pipeline is an ordered or coordinated sequence of connected processing stages or tasks that passes data, work, or results toward an outcome.
• IHttpClientFactoryconfigured by · IHttpClientFactory is a .NET dependency-injection abstraction for creating configured HttpClient instances while managing their underlying handlers.
• HttpMessageHandlerkind of · HttpMessageHandler is an abstract .NET component that processes HTTP request and response messages within an HttpClient handler chain.
• HTTP clienthas part · An HTTP client is software or an API component that sends HTTP requests and receives and processes HTTP responses.

This explainer was generated by Manning's knowledge graph from the text of ASP.NET Core in Action, 3e. The section links point to the parts of the book it draws on.