HttpClientBuilderExtensions.AddHttpMessageHandler Method
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
| AddHttpMessageHandler(IHttpClientBuilder, Func<IServiceProvider,DelegatingHandler>) |
Adds a delegate that will be used to create an additional message handler for a named HttpClient. |
| AddHttpMessageHandler(IHttpClientBuilder, Func<DelegatingHandler>) |
Adds a delegate that will be used to create an additional message handler for a named HttpClient. |
| AddHttpMessageHandler<THandler>(IHttpClientBuilder) |
Adds an additional message handler from the dependency injection container for a named HttpClient. |
Adds a delegate that will be used to create an additional message handler for a named HttpClient.
public:
[System::Runtime::CompilerServices::Extension]
static Microsoft::Extensions::DependencyInjection::IHttpClientBuilder ^ AddHttpMessageHandler(Microsoft::Extensions::DependencyInjection::IHttpClientBuilder ^ builder, Func<IServiceProvider ^, System::Net::Http::DelegatingHandler ^> ^ configureHandler);public static Microsoft.Extensions.DependencyInjection.IHttpClientBuilder AddHttpMessageHandler(this Microsoft.Extensions.DependencyInjection.IHttpClientBuilder builder, Func<IServiceProvider,System.Net.Http.DelegatingHandler> configureHandler);static member AddHttpMessageHandler : Microsoft.Extensions.DependencyInjection.IHttpClientBuilder * Func<IServiceProvider, System.Net.Http.DelegatingHandler> -> Microsoft.Extensions.DependencyInjection.IHttpClientBuilder<Extension()>
Public Function AddHttpMessageHandler (builder As IHttpClientBuilder, configureHandler As Func(Of IServiceProvider, DelegatingHandler)) As IHttpClientBuilderParameters
- builder
- IHttpClientBuilder
The IHttpClientBuilder.
- configureHandler
- Func<IServiceProvider,DelegatingHandler>
A delegate that is used to create a DelegatingHandler.
Returns
An IHttpClientBuilder that can be used to configure the client.
Remarks
The configureHandler delegate should return a new instance of the message handler each time it is invoked.
The IServiceProvider argument provided to configureHandler will be a reference to a scoped service provider that shares the lifetime of the handler being constructed.
Applies to
.NET 10 (package-provided) and other versions
| Product | Versions |
|---|---|
| .NET | 8 (package-provided), 9 (package-provided), 10 (package-provided) |
| .NET Standard | 2.0 (package-provided) |
Adds a delegate that will be used to create an additional message handler for a named HttpClient.
public:
[System::Runtime::CompilerServices::Extension]
static Microsoft::Extensions::DependencyInjection::IHttpClientBuilder ^ AddHttpMessageHandler(Microsoft::Extensions::DependencyInjection::IHttpClientBuilder ^ builder, Func<System::Net::Http::DelegatingHandler ^> ^ configureHandler);public static Microsoft.Extensions.DependencyInjection.IHttpClientBuilder AddHttpMessageHandler(this Microsoft.Extensions.DependencyInjection.IHttpClientBuilder builder, Func<System.Net.Http.DelegatingHandler> configureHandler);static member AddHttpMessageHandler : Microsoft.Extensions.DependencyInjection.IHttpClientBuilder * Func<System.Net.Http.DelegatingHandler> -> Microsoft.Extensions.DependencyInjection.IHttpClientBuilder<Extension()>
Public Function AddHttpMessageHandler (builder As IHttpClientBuilder, configureHandler As Func(Of DelegatingHandler)) As IHttpClientBuilderParameters
- builder
- IHttpClientBuilder
The IHttpClientBuilder.
- configureHandler
- Func<DelegatingHandler>
A delegate that is used to create a DelegatingHandler.
Returns
An IHttpClientBuilder that can be used to configure the client.
Remarks
The configureHandler delegate should return a new instance of the message handler each time it is invoked.
Applies to
.NET 10 (package-provided) and other versions
| Product | Versions |
|---|---|
| .NET | 8 (package-provided), 9 (package-provided), 10 (package-provided) |
| .NET Standard | 2.0 (package-provided) |
Adds an additional message handler from the dependency injection container for a named HttpClient.
public:
generic <typename THandler>
where THandler : System::Net::Http::DelegatingHandler[System::Runtime::CompilerServices::Extension]
static Microsoft::Extensions::DependencyInjection::IHttpClientBuilder ^ AddHttpMessageHandler(Microsoft::Extensions::DependencyInjection::IHttpClientBuilder ^ builder);public static Microsoft.Extensions.DependencyInjection.IHttpClientBuilder AddHttpMessageHandler<THandler>(this Microsoft.Extensions.DependencyInjection.IHttpClientBuilder builder) where THandler : System.Net.Http.DelegatingHandler;static member AddHttpMessageHandler : Microsoft.Extensions.DependencyInjection.IHttpClientBuilder -> Microsoft.Extensions.DependencyInjection.IHttpClientBuilder (requires 'Handler :> System.Net.Http.DelegatingHandler)<Extension()>
Public Function AddHttpMessageHandler(Of THandler As DelegatingHandler) (builder As IHttpClientBuilder) As IHttpClientBuilderType Parameters
- THandler
The type of the DelegatingHandler. The handler type must be registered as a transient service.
Parameters
- builder
- IHttpClientBuilder
The IHttpClientBuilder.
Returns
An IHttpClientBuilder that can be used to configure the client.
Remarks
The THandler will be resolved from a scoped service provider that shares the lifetime of the handler being constructed.
Applies to
.NET 10 (package-provided) and other versions
| Product | Versions |
|---|---|
| .NET | 8 (package-provided), 9 (package-provided), 10 (package-provided) |
| .NET Standard | 2.0 (package-provided) |
.NET feedback
.NET is an open source project. Select a link to provide feedback: