3.82HttpRequestBuilder Unified Configurator

Created on Aug 17, 2026~2 min read

When constructing HttpRequestMessage objects through the HttpRequestBuilder class, if you need to globally configure all requests, the framework provides a unified configuration mechanism.

Developers can implement the IHttpRequestBuilderConfigurator interface to apply unified settings to HttpRequestBuilder instances. For example, the following RequestBuilderConfigurator class adds a common request header to all requests in its Configure method:

cs
public class HttpRequestBuilderConfigurator : IHttpRequestBuilderConfigurator{    /// <inheritdoc />    public void Configure(HttpRequestBuilder httpRequestBuilder)    {        httpRequestBuilder.WithHeader("global", "form_furion");    }}

After implementing a custom configurator, you need to assign it to the RequestBuilderConfigurator property when configuring HttpRemoteOptions:

cs
services.AddHttpRemote(builder => {})    .ConfigureOptions(options =>    {        options.RequestBuilderConfigurator = new HttpRequestBuilderConfigurator();    });

Once the configuration takes effect, all HttpRequestBuilder instances will execute this unified configuration logic before calling the Build() method to construct an HttpRequestMessage.