HttpMessageHandlerBuilder Class

Reference

Definition

Namespace:: Microsoft.Extensions.Http

Assembly:: Microsoft.Extensions.Http.dll

Package:: Microsoft.Extensions.Http v9.0.0

Source:: HttpMessageHandlerBuilder.cs

Source:: HttpMessageHandlerBuilder.cs

Source:: HttpMessageHandlerBuilder.cs

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.

A builder abstraction for configuring HttpMessageHandler instances.

public ref class HttpMessageHandlerBuilder abstract

public abstract class HttpMessageHandlerBuilder

type HttpMessageHandlerBuilder = class

Public MustInherit Class HttpMessageHandlerBuilder

Inheritance: Object
HttpMessageHandlerBuilder

Remarks

The HttpMessageHandlerBuilder is registered in the service collection as a transient service. Callers should retrieve a new instance for each HttpMessageHandler to be created. Implementors should expect each instance to be used a single time.

Constructors

HttpMessageHandlerBuilder()

Initializes a new instance of the HttpMessageHandlerBuilder class.

Properties

AdditionalHandlers	Gets a list of additional DelegatingHandler instances used to configure an HttpClient pipeline.
Name	Gets or sets the name of the HttpClient being created.
PrimaryHandler	Gets or sets the primary HttpMessageHandler.
Services	Gets an IServiceProvider which can be used to resolve services from the dependency injection container.

Methods

Build()	Creates an HttpMessageHandler.
CreateHandlerPipeline(HttpMessageHandler, IEnumerable<DelegatingHandler>)	Constructs an instance of HttpMessageHandler by chaining `additionalHandlers` one after another with `primaryHandler` in the end of the chain. The resulting pipeline is used by IHttpClientFactory infrastructure to create HttpClient instances with customized message handlers. The resulting pipeline can also be accessed by using IHttpMessageHandlerFactory instead of IHttpClientFactory.
Equals(Object)	Determines whether the specified object is equal to the current object. (Inherited from Object)
GetHashCode()	Serves as the default hash function. (Inherited from Object)
GetType()	Gets the Type of the current instance. (Inherited from Object)
MemberwiseClone()	Creates a shallow copy of the current Object. (Inherited from Object)
ToString()	Returns a string that represents the current object. (Inherited from Object)

Applies to

Dela via