Microsoft.Extensions.Http.xml
|
<?xml version="1.0"?>
<doc> <assembly> <name>Microsoft.Extensions.Http</name> </assembly> <members> <member name="T:Microsoft.Extensions.Http.HttpClientFactoryOptions"> <summary> An options class for configuring the default <see cref="T:System.Net.Http.IHttpClientFactory"/>. </summary> </member> <member name="P:Microsoft.Extensions.Http.HttpClientFactoryOptions.HttpMessageHandlerBuilderActions"> <summary> Gets a list of operations used to configure an <see cref="T:Microsoft.Extensions.Http.HttpMessageHandlerBuilder"/>. </summary> </member> <member name="P:Microsoft.Extensions.Http.HttpClientFactoryOptions.HttpClientActions"> <summary> Gets a list of operations used to configure an <see cref="T:System.Net.Http.HttpClient"/>. </summary> </member> <member name="P:Microsoft.Extensions.Http.HttpClientFactoryOptions.HandlerLifetime"> <summary> Gets or sets the length of time that a <see cref="T:System.Net.Http.HttpMessageHandler"/> instance can be reused. Each named client can have its own configured handler lifetime value. The default value of this property is two minutes. Set the lifetime to <see cref="F:System.Threading.Timeout.InfiniteTimeSpan"/> to disable handler expiry. </summary> <remarks> <para> The default implementation of <see cref="T:System.Net.Http.IHttpClientFactory"/> will pool the <see cref="T:System.Net.Http.HttpMessageHandler"/> instances created by the factory to reduce resource consumption. This setting configures the amount of time a handler can be pooled before it is scheduled for removal from the pool and disposal. </para> <para> Pooling of handlers is desirable as each handler typially manages its own underlying HTTP connections; creating more handlers than necessary can result in connection delays. Some handlers also keep connections open indefinitly which can prevent the handler from reacting to DNS changes. The value of <see cref="P:Microsoft.Extensions.Http.HttpClientFactoryOptions.HandlerLifetime"/> should be chosen with an understanding of the application's requirement to respond to changes in the network environment. </para> <para> Expiry of a handler will not immediately dispose the handler. An expired handler is placed in a separate pool which is processed at intervals to dispose handlers only when they become unreachable. Using long-lived <see cref="T:System.Net.Http.HttpClient"/> instances will prevent the underlying <see cref="T:System.Net.Http.HttpMessageHandler"/> from being disposed until all references are garbage-collected. </para> </remarks> </member> <member name="T:Microsoft.Extensions.Http.HttpMessageHandlerBuilder"> <summary> A builder abstraction for configuring <see cref="T:System.Net.Http.HttpMessageHandler"/> instances. </summary> <remarks> The <see cref="T:Microsoft.Extensions.Http.HttpMessageHandlerBuilder"/> is registered in the service collection as a transient service. Callers should retrieve a new instance for each <see cref="T:System.Net.Http.HttpMessageHandler"/> to be created. Implementors should expect each instance to be used a single time. </remarks> </member> <member name="P:Microsoft.Extensions.Http.HttpMessageHandlerBuilder.Name"> <summary> Gets or sets the name of the <see cref="T:System.Net.Http.HttpClient"/> being created. </summary> <remarks> The <see cref="P:Microsoft.Extensions.Http.HttpMessageHandlerBuilder.Name"/> is set by the <see cref="T:System.Net.Http.IHttpClientFactory"/> instructure and is public for unit testing purposes only. Setting the <see cref="P:Microsoft.Extensions.Http.HttpMessageHandlerBuilder.Name"/> outside of testing scenarios may have unpredictable results. </remarks> </member> <member name="P:Microsoft.Extensions.Http.HttpMessageHandlerBuilder.PrimaryHandler"> <summary> Gets or sets the primary <see cref="T:System.Net.Http.HttpMessageHandler"/>. </summary> </member> <member name="P:Microsoft.Extensions.Http.HttpMessageHandlerBuilder.AdditionalHandlers"> <summary> Gets a list of additional <see cref="T:System.Net.Http.DelegatingHandler"/> instances used to configure an <see cref="T:System.Net.Http.HttpClient"/> pipeline. </summary> </member> <member name="M:Microsoft.Extensions.Http.HttpMessageHandlerBuilder.Build"> <summary> Creates an <see cref="T:System.Net.Http.HttpMessageHandler"/>. </summary> <returns> An <see cref="T:System.Net.Http.HttpMessageHandler"/> built from the <see cref="P:Microsoft.Extensions.Http.HttpMessageHandlerBuilder.PrimaryHandler"/> and <see cref="P:Microsoft.Extensions.Http.HttpMessageHandlerBuilder.AdditionalHandlers"/>. </returns> </member> <member name="T:Microsoft.Extensions.Http.IHttpMessageHandlerBuilderFilter"> <summary> Used by the <see cref="T:Microsoft.Extensions.Http.DefaultHttpClientFactory"/> to apply additional initialization to the configure the <see cref="T:Microsoft.Extensions.Http.HttpMessageHandlerBuilder"/> immediately before <see cref="M:Microsoft.Extensions.Http.HttpMessageHandlerBuilder.Build"/> is called. </summary> </member> <member name="M:Microsoft.Extensions.Http.IHttpMessageHandlerBuilderFilter.Configure(System.Action{Microsoft.Extensions.Http.HttpMessageHandlerBuilder})"> <summary> Applies additional initialization to the <see cref="T:Microsoft.Extensions.Http.HttpMessageHandlerBuilder"/> </summary> <param name="next">A delegate which will run the next <see cref="T:Microsoft.Extensions.Http.IHttpMessageHandlerBuilderFilter"/>.</param> </member> <member name="T:Microsoft.Extensions.Http.ITypedHttpClientFactory`1"> <summary> A factory abstraction for a component that can create typed client instances with custom configuration for a given logical name. </summary> <typeparam name="TClient">The type of typed client to create.</typeparam> <remarks> <para> The <see cref="T:Microsoft.Extensions.Http.ITypedHttpClientFactory`1"/> is infrastructure that supports the <see cref="M:Microsoft.Extensions.DependencyInjection.HttpClientFactoryServiceCollectionExtensions.AddHttpClient``1(Microsoft.Extensions.DependencyInjection.IServiceCollection,System.String)"/> and <see cref="M:Microsoft.Extensions.DependencyInjection.HttpClientBuilderExtensions.AddTypedClient``1(Microsoft.Extensions.DependencyInjection.IHttpClientBuilder)"/> functionality. This type should rarely be used directly in application code, use <see cref="M:System.IServiceProvider.GetService(System.Type)"/> instead to retrieve typed clients. </para> <para> A default <see cref="T:Microsoft.Extensions.Http.ITypedHttpClientFactory`1"/> can be registered in an <see cref="T:Microsoft.Extensions.DependencyInjection.IServiceCollection"/> by calling <see cref="M:Microsoft.Extensions.DependencyInjection.HttpClientFactoryServiceCollectionExtensions.AddHttpClient(Microsoft.Extensions.DependencyInjection.IServiceCollection)"/>. The default <see cref="T:Microsoft.Extensions.Http.ITypedHttpClientFactory`1"/> will be registered in the service collection as a singleton open-generic service. </para> <para> The default <see cref="T:Microsoft.Extensions.Http.ITypedHttpClientFactory`1"/> uses type activation to create typed client instances. Typed client types are not retrieved directly from the <see cref="T:System.IServiceProvider"/>. See <see cref="M:Microsoft.Extensions.DependencyInjection.ActivatorUtilities.CreateInstance(System.IServiceProvider,System.Type,System.Object[])" /> for details. </para> </remarks> <example> This sample shows the basic pattern for defining a typed client class. <code> class ExampleClient { private readonly HttpClient _httpClient; private readonly ILogger _logger; // typed clients can use constructor injection to access additional services public ExampleClient(HttpClient httpClient, ILogger<ExampleClient> logger) { _httpClient = httpClient; _logger = logger; } // typed clients can expose the HttpClient for application code to call directly public HttpClient HttpClient => _httpClient; // typed clients can also define methods that abstract usage of the HttpClient public async Task SendHelloRequest() { var response = await _httpClient.GetAsync("/helloworld"); response.EnsureSuccessStatusCode(); } } </code> </example> <example> This sample shows how to consume a typed client from an ASP.NET Core middleware. <code> // in Startup.cs public void Configure(IApplicationBuilder app, ExampleClient exampleClient) { app.Run(async (context) => { var response = await _exampleClient.GetAsync("/helloworld"); await context.Response.WriteAsync("Remote server said: "); await response.Content.CopyToAsync(context.Response.Body); }); } </code> </example> <example> This sample shows how to consume a typed client from an ASP.NET Core MVC Controller. <code> // in Controllers/HomeController.cs public class HomeController : ControllerBase(IApplicationBuilder app, ExampleClient exampleClient) { private readonly ExampleClient _exampleClient; public HomeController(ExampleClient exampleClient) { _exampleClient = exampleClient; } public async Task<IActionResult> Index() { var response = await _exampleClient.GetAsync("/helloworld"); var text = await response.Content.ReadAsStringAsync(); return Content("Remote server said: " + text, "text/plain"); }; } </code> </example> </member> <member name="M:Microsoft.Extensions.Http.ITypedHttpClientFactory`1.CreateClient(System.Net.Http.HttpClient)"> <summary> Creates a typed client given an associated <see cref="T:System.Net.Http.HttpClient"/>. </summary> <param name="httpClient"> An <see cref="T:System.Net.Http.HttpClient"/> created by the <see cref="T:System.Net.Http.IHttpClientFactory"/> for the named client associated with <typeparamref name="TClient"/>. </param> <returns>An instance of <typeparamref name="TClient"/>.</returns> </member> <member name="P:Microsoft.Extensions.Http.Resources.HttpMessageHandlerBuilder_AdditionalHandlerIsNull"> <summary> The '{0}' must not contain a null entry. </summary> </member> <member name="M:Microsoft.Extensions.Http.Resources.FormatHttpMessageHandlerBuilder_AdditionalHandlerIsNull(System.Object)"> <summary> The '{0}' must not contain a null entry. </summary> </member> <member name="P:Microsoft.Extensions.Http.Resources.HttpMessageHandlerBuilder_AdditionHandlerIsInvalid"> <summary> The '{0}' property must be null. '{1}' instances provided to '{2}' must not be reused or cached.{3}Handler: '{4}' </summary> </member> <member name="M:Microsoft.Extensions.Http.Resources.FormatHttpMessageHandlerBuilder_AdditionHandlerIsInvalid(System.Object,System.Object,System.Object,System.Object,System.Object)"> <summary> The '{0}' property must be null. '{1}' instances provided to '{2}' must not be reused or cached.{3}Handler: '{4}' </summary> </member> <member name="P:Microsoft.Extensions.Http.Resources.HttpMessageHandlerBuilder_PrimaryHandlerIsNull"> <summary> The '{0}' must not be null. </summary> </member> <member name="M:Microsoft.Extensions.Http.Resources.FormatHttpMessageHandlerBuilder_PrimaryHandlerIsNull(System.Object)"> <summary> The '{0}' must not be null. </summary> </member> <member name="P:Microsoft.Extensions.Http.Resources.HandlerLifetime_InvalidValue"> <summary> The handler lifetime must be at least 1 second. </summary> </member> <member name="M:Microsoft.Extensions.Http.Resources.FormatHandlerLifetime_InvalidValue"> <summary> The handler lifetime must be at least 1 second. </summary> </member> <member name="T:Microsoft.Extensions.DependencyInjection.HttpClientBuilderExtensions"> <summary> Extension methods for configuring an <see cref="T:Microsoft.Extensions.DependencyInjection.IHttpClientBuilder"/> </summary> </member> <member name="M:Microsoft.Extensions.DependencyInjection.HttpClientBuilderExtensions.ConfigureHttpClient(Microsoft.Extensions.DependencyInjection.IHttpClientBuilder,System.Action{System.Net.Http.HttpClient})"> <summary> Adds a delegate that will be used to configure a named <see cref="T:System.Net.Http.HttpClient"/>. </summary> <param name="builder">The <see cref="T:Microsoft.Extensions.DependencyInjection.IServiceCollection"/>.</param> <param name="configureClient">A delegate that is used to configure an <see cref="T:System.Net.Http.HttpClient"/>.</param> <returns>An <see cref="T:Microsoft.Extensions.DependencyInjection.IHttpClientBuilder"/> that can be used to configure the client.</returns> </member> <member name="M:Microsoft.Extensions.DependencyInjection.HttpClientBuilderExtensions.ConfigureHttpClient(Microsoft.Extensions.DependencyInjection.IHttpClientBuilder,System.Action{System.IServiceProvider,System.Net.Http.HttpClient})"> <summary> Adds a delegate that will be used to configure a named <see cref="T:System.Net.Http.HttpClient"/>. </summary> <param name="builder">The <see cref="T:Microsoft.Extensions.DependencyInjection.IServiceCollection"/>.</param> <param name="configureClient">A delegate that is used to configure an <see cref="T:System.Net.Http.HttpClient"/>.</param> <returns>An <see cref="T:Microsoft.Extensions.DependencyInjection.IHttpClientBuilder"/> that can be used to configure the client.</returns> </member> <member name="M:Microsoft.Extensions.DependencyInjection.HttpClientBuilderExtensions.AddHttpMessageHandler(Microsoft.Extensions.DependencyInjection.IHttpClientBuilder,System.Func{System.Net.Http.DelegatingHandler})"> <summary> Adds a delegate that will be used to create an additional message handler for a named <see cref="T:System.Net.Http.HttpClient"/>. </summary> <param name="builder">The <see cref="T:Microsoft.Extensions.DependencyInjection.IHttpClientBuilder"/>.</param> <param name="configureHandler">A delegate that is used to create a <see cref="T:System.Net.Http.DelegatingHandler"/>.</param> <returns>An <see cref="T:Microsoft.Extensions.DependencyInjection.IHttpClientBuilder"/> that can be used to configure the client.</returns> <remarks> The <see paramref="configureHandler"/> delegate should return a new instance of the message handler each time it is invoked. </remarks> </member> <member name="M:Microsoft.Extensions.DependencyInjection.HttpClientBuilderExtensions.AddHttpMessageHandler(Microsoft.Extensions.DependencyInjection.IHttpClientBuilder,System.Func{System.IServiceProvider,System.Net.Http.DelegatingHandler})"> <summary> Adds a delegate that will be used to create an additional message handler for a named <see cref="T:System.Net.Http.HttpClient"/>. </summary> <param name="builder">The <see cref="T:Microsoft.Extensions.DependencyInjection.IHttpClientBuilder"/>.</param> <param name="configureHandler">A delegate that is used to create a <see cref="T:System.Net.Http.DelegatingHandler"/>.</param> /// <returns>An <see cref="T:Microsoft.Extensions.DependencyInjection.IHttpClientBuilder"/> that can be used to configure the client.</returns> <remarks> The <see paramref="configureHandler"/> delegate should return a new instance of the message handler each time it is invoked. </remarks> </member> <member name="M:Microsoft.Extensions.DependencyInjection.HttpClientBuilderExtensions.AddHttpMessageHandler``1(Microsoft.Extensions.DependencyInjection.IHttpClientBuilder)"> <summary> Adds an additional message handler from the dependency injection container for a named <see cref="T:System.Net.Http.HttpClient"/>. </summary> <param name="builder">The <see cref="T:Microsoft.Extensions.DependencyInjection.IHttpClientBuilder"/>.</param> <returns>An <see cref="T:Microsoft.Extensions.DependencyInjection.IHttpClientBuilder"/> that can be used to configure the client.</returns> <typeparam name="THandler"> The type of the <see cref="T:System.Net.Http.DelegatingHandler"/>. The handler type must be registered as a transient service. </typeparam> </member> <member name="M:Microsoft.Extensions.DependencyInjection.HttpClientBuilderExtensions.ConfigurePrimaryHttpMessageHandler(Microsoft.Extensions.DependencyInjection.IHttpClientBuilder,System.Func{System.Net.Http.HttpMessageHandler})"> <summary> Adds a delegate that will be used to configure the primary <see cref="T:System.Net.Http.HttpMessageHandler"/> for a named <see cref="T:System.Net.Http.HttpClient"/>. </summary> <param name="builder">The <see cref="T:Microsoft.Extensions.DependencyInjection.IHttpClientBuilder"/>.</param> <param name="configureHandler">A delegate that is used to create an <see cref="T:System.Net.Http.HttpMessageHandler"/>.</param> <returns>An <see cref="T:Microsoft.Extensions.DependencyInjection.IHttpClientBuilder"/> that can be used to configure the client.</returns> <remarks> The <see paramref="configureHandler"/> delegate should return a new instance of the message handler each time it is invoked. </remarks> </member> <member name="M:Microsoft.Extensions.DependencyInjection.HttpClientBuilderExtensions.ConfigurePrimaryHttpMessageHandler(Microsoft.Extensions.DependencyInjection.IHttpClientBuilder,System.Func{System.IServiceProvider,System.Net.Http.HttpMessageHandler})"> <summary> Adds a delegate that will be used to configure the primary <see cref="T:System.Net.Http.HttpMessageHandler"/> for a named <see cref="T:System.Net.Http.HttpClient"/>. </summary> <param name="builder">The <see cref="T:Microsoft.Extensions.DependencyInjection.IHttpClientBuilder"/>.</param> <param name="configureHandler">A delegate that is used to create an <see cref="T:System.Net.Http.HttpMessageHandler"/>.</param> <returns>An <see cref="T:Microsoft.Extensions.DependencyInjection.IHttpClientBuilder"/> that can be used to configure the client.</returns> <remarks> The <see paramref="configureHandler"/> delegate should return a new instance of the message handler each time it is invoked. </remarks> </member> <member name="M:Microsoft.Extensions.DependencyInjection.HttpClientBuilderExtensions.ConfigurePrimaryHttpMessageHandler``1(Microsoft.Extensions.DependencyInjection.IHttpClientBuilder)"> <summary> Configures the primary <see cref="T:System.Net.Http.HttpMessageHandler"/> from the dependency inection container for a named <see cref="T:System.Net.Http.HttpClient"/>. </summary> <param name="builder">The <see cref="T:Microsoft.Extensions.DependencyInjection.IHttpClientBuilder"/>.</param> <returns>An <see cref="T:Microsoft.Extensions.DependencyInjection.IHttpClientBuilder"/> that can be used to configure the client.</returns> <typeparam name="THandler"> The type of the <see cref="T:System.Net.Http.DelegatingHandler"/>. The handler type must be registered as a transient service. </typeparam> </member> <member name="M:Microsoft.Extensions.DependencyInjection.HttpClientBuilderExtensions.ConfigureHttpMessageHandlerBuilder(Microsoft.Extensions.DependencyInjection.IHttpClientBuilder,System.Action{Microsoft.Extensions.Http.HttpMessageHandlerBuilder})"> <summary> Adds a delegate that will be used to configure message handlers using <see cref="T:Microsoft.Extensions.Http.HttpMessageHandlerBuilder"/> for a named <see cref="T:System.Net.Http.HttpClient"/>. </summary> <param name="builder">The <see cref="T:Microsoft.Extensions.DependencyInjection.IHttpClientBuilder"/>.</param> <param name="configureBuilder">A delegate that is used to configure an <see cref="T:Microsoft.Extensions.Http.HttpMessageHandlerBuilder"/>.</param> <returns>An <see cref="T:Microsoft.Extensions.DependencyInjection.IHttpClientBuilder"/> that can be used to configure the client.</returns> </member> <member name="M:Microsoft.Extensions.DependencyInjection.HttpClientBuilderExtensions.AddTypedClient``1(Microsoft.Extensions.DependencyInjection.IHttpClientBuilder)"> <summary> Configures a binding between the <typeparamref name="TClient" /> type and the named <see cref="T:System.Net.Http.HttpClient"/> associated with the <see cref="T:Microsoft.Extensions.DependencyInjection.IHttpClientBuilder"/>. </summary> <typeparam name="TClient"> The type of the typed client. They type specified will be registered in the service collection as a transient service. See <see cref="T:Microsoft.Extensions.Http.ITypedHttpClientFactory`1" /> for more details about authoring typed clients. </typeparam> <param name="builder">The <see cref="T:Microsoft.Extensions.DependencyInjection.IHttpClientBuilder"/>.</param> <remarks> <para> <typeparamref name="TClient"/> instances constructed with the appropriate <see cref="T:System.Net.Http.HttpClient" /> can be retrieved from <see cref="M:System.IServiceProvider.GetService(System.Type)" /> (and related methods) by providing <typeparamref name="TClient"/> as the service type. </para> <para> Calling <see cref="M:Microsoft.Extensions.DependencyInjection.HttpClientBuilderExtensions.AddTypedClient``1(Microsoft.Extensions.DependencyInjection.IHttpClientBuilder)"/> will register a typed client binding that creates <typeparamref name="TClient"/> using the <see cref="T:Microsoft.Extensions.Http.ITypedHttpClientFactory`1" />. </para> </remarks> </member> <member name="M:Microsoft.Extensions.DependencyInjection.HttpClientBuilderExtensions.AddTypedClient``2(Microsoft.Extensions.DependencyInjection.IHttpClientBuilder)"> <summary> Configures a binding between the <typeparamref name="TClient" /> type and the named <see cref="T:System.Net.Http.HttpClient"/> associated with the <see cref="T:Microsoft.Extensions.DependencyInjection.IHttpClientBuilder"/>. The created instances will be of type <typeparamref name="TImplementation"/>. </summary> <typeparam name="TClient"> The declared type of the typed client. They type specified will be registered in the service collection as a transient service. See <see cref="T:Microsoft.Extensions.Http.ITypedHttpClientFactory`1" /> for more details about authoring typed clients. </typeparam> <typeparam name="TImplementation"> The implementation type of the typed client. The type specified by will be instantiated by the <see cref="T:Microsoft.Extensions.Http.ITypedHttpClientFactory`1"/>. </typeparam> <param name="builder">The <see cref="T:Microsoft.Extensions.DependencyInjection.IHttpClientBuilder"/>.</param> <remarks> <para> <typeparamref name="TClient"/> instances constructed with the appropriate <see cref="T:System.Net.Http.HttpClient" /> can be retrieved from <see cref="M:System.IServiceProvider.GetService(System.Type)" /> (and related methods) by providing <typeparamref name="TClient"/> as the service type. </para> <para> Calling <see cref="M:Microsoft.Extensions.DependencyInjection.HttpClientBuilderExtensions.AddTypedClient``2(Microsoft.Extensions.DependencyInjection.IHttpClientBuilder)"/> will register a typed client binding that creates <typeparamref name="TImplementation"/> using the <see cref="T:Microsoft.Extensions.Http.ITypedHttpClientFactory`1" />. </para> </remarks> </member> <member name="M:Microsoft.Extensions.DependencyInjection.HttpClientBuilderExtensions.AddTypedClient``1(Microsoft.Extensions.DependencyInjection.IHttpClientBuilder,System.Func{System.Net.Http.HttpClient,``0})"> <summary> Configures a binding between the <typeparamref name="TClient" /> type and the named <see cref="T:System.Net.Http.HttpClient"/> associated with the <see cref="T:Microsoft.Extensions.DependencyInjection.IHttpClientBuilder"/>. </summary> <typeparam name="TClient"> The type of the typed client. They type specified will be registered in the service collection as a transient service. </typeparam> <param name="builder">The <see cref="T:Microsoft.Extensions.DependencyInjection.IHttpClientBuilder"/>.</param> <param name="factory">A factory function that will be used to construct the typed client.</param> <remarks> <para> <typeparamref name="TClient"/> instances constructed with the appropriate <see cref="T:System.Net.Http.HttpClient" /> can be retrieved from <see cref="M:System.IServiceProvider.GetService(System.Type)" /> (and related methods) by providing <typeparamref name="TClient"/> as the service type. </para> <para> Calling <see cref="M:Microsoft.Extensions.DependencyInjection.HttpClientBuilderExtensions.AddTypedClient``1(Microsoft.Extensions.DependencyInjection.IHttpClientBuilder,System.Func{System.Net.Http.HttpClient,``0})"/> will register a typed client binding that creates <typeparamref name="TClient"/> using the provided factory function. </para> </remarks> </member> <member name="M:Microsoft.Extensions.DependencyInjection.HttpClientBuilderExtensions.AddTypedClient``1(Microsoft.Extensions.DependencyInjection.IHttpClientBuilder,System.Func{System.Net.Http.HttpClient,System.IServiceProvider,``0})"> <summary> Configures a binding between the <typeparamref name="TClient" /> type and the named <see cref="T:System.Net.Http.HttpClient"/> associated with the <see cref="T:Microsoft.Extensions.DependencyInjection.IHttpClientBuilder"/>. </summary> <typeparam name="TClient"> The type of the typed client. They type specified will be registered in the service collection as a transient service. </typeparam> <param name="builder">The <see cref="T:Microsoft.Extensions.DependencyInjection.IHttpClientBuilder"/>.</param> <param name="factory">A factory function that will be used to construct the typed client.</param> <remarks> <para> <typeparamref name="TClient"/> instances constructed with the appropriate <see cref="T:System.Net.Http.HttpClient" /> can be retrieved from <see cref="M:System.IServiceProvider.GetService(System.Type)" /> (and related methods) by providing <typeparamref name="TClient"/> as the service type. </para> <para> Calling <see cref="M:Microsoft.Extensions.DependencyInjection.HttpClientBuilderExtensions.AddTypedClient``1(Microsoft.Extensions.DependencyInjection.IHttpClientBuilder,System.Func{System.Net.Http.HttpClient,System.IServiceProvider,``0})"/> will register a typed client binding that creates <typeparamref name="TClient"/> using the provided factory function. </para> </remarks> </member> <member name="M:Microsoft.Extensions.DependencyInjection.HttpClientBuilderExtensions.SetHandlerLifetime(Microsoft.Extensions.DependencyInjection.IHttpClientBuilder,System.TimeSpan)"> <summary> Sets the length of time that a <see cref="T:System.Net.Http.HttpMessageHandler"/> instance can be reused. Each named client can have its own configured handler lifetime value. The default value is two minutes. Set the lifetime to <see cref="F:System.Threading.Timeout.InfiniteTimeSpan"/> to disable handler expiry. </summary> <remarks> <para> The default implementation of <see cref="T:System.Net.Http.IHttpClientFactory"/> will pool the <see cref="T:System.Net.Http.HttpMessageHandler"/> instances created by the factory to reduce resource consumption. This setting configures the amount of time a handler can be pooled before it is scheduled for removal from the pool and disposal. </para> <para> Pooling of handlers is desirable as each handler typially manages its own underlying HTTP connections; creating more handlers than necessary can result in connection delays. Some handlers also keep connections open indefinitly which can prevent the handler from reacting to DNS changes. The value of <paramref name="handlerLifetime"/> should be chosen with an understanding of the application's requirement to respond to changes in the network environment. </para> <para> Expiry of a handler will not immediately dispose the handler. An expired handler is placed in a separate pool which is processed at intervals to dispose handlers only when they become unreachable. Using long-lived <see cref="T:System.Net.Http.HttpClient"/> instances will prevent the underlying <see cref="T:System.Net.Http.HttpMessageHandler"/> from being disposed until all references are garbage-collected. </para> </remarks> </member> <member name="T:Microsoft.Extensions.DependencyInjection.HttpClientFactoryServiceCollectionExtensions"> <summary> Extensions methods to configure an <see cref="T:Microsoft.Extensions.DependencyInjection.IServiceCollection"/> for <see cref="T:System.Net.Http.IHttpClientFactory"/>. </summary> </member> <member name="M:Microsoft.Extensions.DependencyInjection.HttpClientFactoryServiceCollectionExtensions.AddHttpClient(Microsoft.Extensions.DependencyInjection.IServiceCollection)"> <summary> Adds the <see cref="T:System.Net.Http.IHttpClientFactory"/> and related services to the <see cref="T:Microsoft.Extensions.DependencyInjection.IServiceCollection"/>. </summary> <param name="services">The <see cref="T:Microsoft.Extensions.DependencyInjection.IServiceCollection"/>.</param> <returns>The <see cref="T:Microsoft.Extensions.DependencyInjection.IServiceCollection"/>.</returns> </member> <member name="M:Microsoft.Extensions.DependencyInjection.HttpClientFactoryServiceCollectionExtensions.AddHttpClient(Microsoft.Extensions.DependencyInjection.IServiceCollection,System.String)"> <summary> Adds the <see cref="T:System.Net.Http.IHttpClientFactory"/> and related services to the <see cref="T:Microsoft.Extensions.DependencyInjection.IServiceCollection"/> and configures a named <see cref="T:System.Net.Http.HttpClient"/>. </summary> <param name="services">The <see cref="T:Microsoft.Extensions.DependencyInjection.IServiceCollection"/>.</param> <param name="name">The logical name of the <see cref="T:System.Net.Http.HttpClient"/> to configure.</param> <returns>An <see cref="T:Microsoft.Extensions.DependencyInjection.IHttpClientBuilder"/> that can be used to configure the client.</returns> <remarks> <para> <see cref="T:System.Net.Http.HttpClient"/> instances that apply the provided configuration can be retrieved using <see cref="M:System.Net.Http.IHttpClientFactory.CreateClient(System.String)"/> and providing the matching name. </para> <para> Use <see cref="F:Microsoft.Extensions.Options.Options.DefaultName"/> as the name to configure the default client. </para> </remarks> </member> <member name="M:Microsoft.Extensions.DependencyInjection.HttpClientFactoryServiceCollectionExtensions.AddHttpClient(Microsoft.Extensions.DependencyInjection.IServiceCollection,System.String,System.Action{System.Net.Http.HttpClient})"> <summary> Adds the <see cref="T:System.Net.Http.IHttpClientFactory"/> and related services to the <see cref="T:Microsoft.Extensions.DependencyInjection.IServiceCollection"/> and configures a named <see cref="T:System.Net.Http.HttpClient"/>. </summary> <param name="services">The <see cref="T:Microsoft.Extensions.DependencyInjection.IServiceCollection"/>.</param> <param name="name">The logical name of the <see cref="T:System.Net.Http.HttpClient"/> to configure.</param> <param name="configureClient">A delegate that is used to configure an <see cref="T:System.Net.Http.HttpClient"/>.</param> <returns>An <see cref="T:Microsoft.Extensions.DependencyInjection.IHttpClientBuilder"/> that can be used to configure the client.</returns> <remarks> <para> <see cref="T:System.Net.Http.HttpClient"/> instances that apply the provided configuration can be retrieved using <see cref="M:System.Net.Http.IHttpClientFactory.CreateClient(System.String)"/> and providing the matching name. </para> <para> Use <see cref="F:Microsoft.Extensions.Options.Options.DefaultName"/> as the name to configure the default client. </para> </remarks> </member> <member name="M:Microsoft.Extensions.DependencyInjection.HttpClientFactoryServiceCollectionExtensions.AddHttpClient(Microsoft.Extensions.DependencyInjection.IServiceCollection,System.String,System.Action{System.IServiceProvider,System.Net.Http.HttpClient})"> <summary> Adds the <see cref="T:System.Net.Http.IHttpClientFactory"/> and related services to the <see cref="T:Microsoft.Extensions.DependencyInjection.IServiceCollection"/> and configures a named <see cref="T:System.Net.Http.HttpClient"/>. </summary> <param name="services">The <see cref="T:Microsoft.Extensions.DependencyInjection.IServiceCollection"/>.</param> <param name="name">The logical name of the <see cref="T:System.Net.Http.HttpClient"/> to configure.</param> <param name="configureClient">A delegate that is used to configure an <see cref="T:System.Net.Http.HttpClient"/>.</param> <returns>An <see cref="T:Microsoft.Extensions.DependencyInjection.IHttpClientBuilder"/> that can be used to configure the client.</returns> <remarks> <para> <see cref="T:System.Net.Http.HttpClient"/> instances that apply the provided configuration can be retrieved using <see cref="M:System.Net.Http.IHttpClientFactory.CreateClient(System.String)"/> and providing the matching name. </para> <para> Use <see cref="F:Microsoft.Extensions.Options.Options.DefaultName"/> as the name to configure the default client. </para> </remarks> </member> <member name="M:Microsoft.Extensions.DependencyInjection.HttpClientFactoryServiceCollectionExtensions.AddHttpClient``1(Microsoft.Extensions.DependencyInjection.IServiceCollection)"> <summary> Adds the <see cref="T:System.Net.Http.IHttpClientFactory"/> and related services to the <see cref="T:Microsoft.Extensions.DependencyInjection.IServiceCollection"/> and configures a binding between the <typeparamref name="TClient"/> type and a named <see cref="T:System.Net.Http.HttpClient"/>. The client name will be set to the full name of <typeparamref name="TClient"/>. </summary> <typeparam name="TClient"> The type of the typed client. They type specified will be registered in the service collection as a transient service. See <see cref="T:Microsoft.Extensions.Http.ITypedHttpClientFactory`1" /> for more details about authoring typed clients. </typeparam> <param name="services">The <see cref="T:Microsoft.Extensions.DependencyInjection.IServiceCollection"/>.</param> <returns>An <see cref="T:Microsoft.Extensions.DependencyInjection.IHttpClientBuilder"/> that can be used to configure the client.</returns> <remarks> <para> <see cref="T:System.Net.Http.HttpClient"/> instances that apply the provided configuration can be retrieved using <see cref="M:System.Net.Http.IHttpClientFactory.CreateClient(System.String)"/> and providing the matching name. </para> <para> <typeparamref name="TClient"/> instances constructed with the appropriate <see cref="T:System.Net.Http.HttpClient" /> can be retrieved from <see cref="M:System.IServiceProvider.GetService(System.Type)" /> (and related methods) by providing <typeparamref name="TClient"/> as the service type. </para> <para> Use <see cref="F:Microsoft.Extensions.Options.Options.DefaultName"/> as the name to configure the default client. </para> </remarks> </member> <member name="M:Microsoft.Extensions.DependencyInjection.HttpClientFactoryServiceCollectionExtensions.AddHttpClient``2(Microsoft.Extensions.DependencyInjection.IServiceCollection)"> <summary> Adds the <see cref="T:System.Net.Http.IHttpClientFactory"/> and related services to the <see cref="T:Microsoft.Extensions.DependencyInjection.IServiceCollection"/> and configures a binding between the <typeparamref name="TClient" /> type and a named <see cref="T:System.Net.Http.HttpClient"/>. The client name will be set to the type name of <typeparamref name="TClient"/>. </summary> <typeparam name="TClient"> The type of the typed client. They type specified will be registered in the service collection as a transient service. See <see cref="T:Microsoft.Extensions.Http.ITypedHttpClientFactory`1" /> for more details about authoring typed clients. </typeparam> <typeparam name="TImplementation"> The implementation type of the typed client. They type specified will be instantiated by the <see cref="T:Microsoft.Extensions.Http.ITypedHttpClientFactory`1"/> </typeparam> <param name="services">The <see cref="T:Microsoft.Extensions.DependencyInjection.IServiceCollection"/>.</param> <returns>An <see cref="T:Microsoft.Extensions.DependencyInjection.IHttpClientBuilder"/> that can be used to configure the client.</returns> <remarks> <para> <see cref="T:System.Net.Http.HttpClient"/> instances that apply the provided configuration can be retrieved using <see cref="M:System.Net.Http.IHttpClientFactory.CreateClient(System.String)"/> and providing the matching name. </para> <para> <typeparamref name="TClient"/> instances constructed with the appropriate <see cref="T:System.Net.Http.HttpClient" /> can be retrieved from <see cref="M:System.IServiceProvider.GetService(System.Type)" /> (and related methods) by providing <typeparamref name="TClient"/> as the service type. </para> </remarks> </member> <member name="M:Microsoft.Extensions.DependencyInjection.HttpClientFactoryServiceCollectionExtensions.AddHttpClient``1(Microsoft.Extensions.DependencyInjection.IServiceCollection,System.String)"> <summary> Adds the <see cref="T:System.Net.Http.IHttpClientFactory"/> and related services to the <see cref="T:Microsoft.Extensions.DependencyInjection.IServiceCollection"/> and configures a binding between the <typeparamref name="TClient"/> type and a named <see cref="T:System.Net.Http.HttpClient"/>. </summary> <typeparam name="TClient"> The type of the typed client. They type specified will be registered in the service collection as a transient service. See <see cref="T:Microsoft.Extensions.Http.ITypedHttpClientFactory`1" /> for more details about authoring typed clients. </typeparam> <param name="services">The <see cref="T:Microsoft.Extensions.DependencyInjection.IServiceCollection"/>.</param> <param name="name">The logical name of the <see cref="T:System.Net.Http.HttpClient"/> to configure.</param> <returns>An <see cref="T:Microsoft.Extensions.DependencyInjection.IHttpClientBuilder"/> that can be used to configure the client.</returns> <remarks> <para> <see cref="T:System.Net.Http.HttpClient"/> instances that apply the provided configuration can be retrieved using <see cref="M:System.Net.Http.IHttpClientFactory.CreateClient(System.String)"/> and providing the matching name. </para> <para> <typeparamref name="TClient"/> instances constructed with the appropriate <see cref="T:System.Net.Http.HttpClient" /> can be retrieved from <see cref="M:System.IServiceProvider.GetService(System.Type)" /> (and related methods) by providing <typeparamref name="TClient"/> as the service type. </para> <para> Use <see cref="F:Microsoft.Extensions.Options.Options.DefaultName"/> as the name to configure the default client. </para> </remarks> </member> <member name="M:Microsoft.Extensions.DependencyInjection.HttpClientFactoryServiceCollectionExtensions.AddHttpClient``2(Microsoft.Extensions.DependencyInjection.IServiceCollection,System.String)"> <summary> Adds the <see cref="T:System.Net.Http.IHttpClientFactory"/> and related services to the <see cref="T:Microsoft.Extensions.DependencyInjection.IServiceCollection"/> and configures a binding between the <typeparamref name="TClient" /> type and a named <see cref="T:System.Net.Http.HttpClient"/>. The client name will be set to the type name of <typeparamref name="TClient"/>. </summary> <typeparam name="TClient"> The type of the typed client. They type specified will be registered in the service collection as a transient service. See <see cref="T:Microsoft.Extensions.Http.ITypedHttpClientFactory`1" /> for more details about authoring typed clients. </typeparam> <typeparam name="TImplementation"> The implementation type of the typed client. They type specified will be instantiated by the <see cref="T:Microsoft.Extensions.Http.ITypedHttpClientFactory`1"/> </typeparam> <param name="services">The <see cref="T:Microsoft.Extensions.DependencyInjection.IServiceCollection"/>.</param> <param name="name">The logical name of the <see cref="T:System.Net.Http.HttpClient"/> to configure.</param> <returns>An <see cref="T:Microsoft.Extensions.DependencyInjection.IHttpClientBuilder"/> that can be used to configure the client.</returns> <remarks> <para> <see cref="T:System.Net.Http.HttpClient"/> instances that apply the provided configuration can be retrieved using <see cref="M:System.Net.Http.IHttpClientFactory.CreateClient(System.String)"/> and providing the matching name. </para> <para> <typeparamref name="TClient"/> instances constructed with the appropriate <see cref="T:System.Net.Http.HttpClient" /> can be retrieved from <see cref="M:System.IServiceProvider.GetService(System.Type)" /> (and related methods) by providing <typeparamref name="TClient"/> as the service type. </para> <para> Use <see cref="F:Microsoft.Extensions.Options.Options.DefaultName"/> as the name to configure the default client. </para> </remarks> </member> <member name="M:Microsoft.Extensions.DependencyInjection.HttpClientFactoryServiceCollectionExtensions.AddHttpClient``1(Microsoft.Extensions.DependencyInjection.IServiceCollection,System.Action{System.Net.Http.HttpClient})"> <summary> Adds the <see cref="T:System.Net.Http.IHttpClientFactory"/> and related services to the <see cref="T:Microsoft.Extensions.DependencyInjection.IServiceCollection"/> and configures a binding between the <typeparamref name="TClient" /> type and a named <see cref="T:System.Net.Http.HttpClient"/>. The client name will be set to the type name of <typeparamref name="TClient"/>. </summary> <typeparam name="TClient"> The type of the typed client. They type specified will be registered in the service collection as a transient service. See <see cref="T:Microsoft.Extensions.Http.ITypedHttpClientFactory`1" /> for more details about authoring typed clients. </typeparam> <param name="services">The <see cref="T:Microsoft.Extensions.DependencyInjection.IServiceCollection"/>.</param> <param name="configureClient">A delegate that is used to configure an <see cref="T:System.Net.Http.HttpClient"/>.</param> <returns>An <see cref="T:Microsoft.Extensions.DependencyInjection.IHttpClientBuilder"/> that can be used to configure the client.</returns> <remarks> <para> <see cref="T:System.Net.Http.HttpClient"/> instances that apply the provided configuration can be retrieved using <see cref="M:System.Net.Http.IHttpClientFactory.CreateClient(System.String)"/> and providing the matching name. </para> <para> <typeparamref name="TClient"/> instances constructed with the appropriate <see cref="T:System.Net.Http.HttpClient" /> can be retrieved from <see cref="M:System.IServiceProvider.GetService(System.Type)" /> (and related methods) by providing <typeparamref name="TClient"/> as the service type. </para> </remarks> </member> <member name="M:Microsoft.Extensions.DependencyInjection.HttpClientFactoryServiceCollectionExtensions.AddHttpClient``2(Microsoft.Extensions.DependencyInjection.IServiceCollection,System.Action{System.Net.Http.HttpClient})"> <summary> Adds the <see cref="T:System.Net.Http.IHttpClientFactory"/> and related services to the <see cref="T:Microsoft.Extensions.DependencyInjection.IServiceCollection"/> and configures a binding between the <typeparamref name="TClient" /> type and a named <see cref="T:System.Net.Http.HttpClient"/>. The client name will be set to the type name of <typeparamref name="TClient"/>. </summary> <typeparam name="TClient"> The type of the typed client. They type specified will be registered in the service collection as a transient service. See <see cref="T:Microsoft.Extensions.Http.ITypedHttpClientFactory`1" /> for more details about authoring typed clients. </typeparam> <typeparam name="TImplementation"> The implementation type of the typed client. They type specified will be instantiated by the <see cref="T:Microsoft.Extensions.Http.ITypedHttpClientFactory`1"/> </typeparam> <param name="services">The <see cref="T:Microsoft.Extensions.DependencyInjection.IServiceCollection"/>.</param> <param name="configureClient">A delegate that is used to configure an <see cref="T:System.Net.Http.HttpClient"/>.</param> <returns>An <see cref="T:Microsoft.Extensions.DependencyInjection.IHttpClientBuilder"/> that can be used to configure the client.</returns> <remarks> <para> <see cref="T:System.Net.Http.HttpClient"/> instances that apply the provided configuration can be retrieved using <see cref="M:System.Net.Http.IHttpClientFactory.CreateClient(System.String)"/> and providing the matching name. </para> <para> <typeparamref name="TClient"/> instances constructed with the appropriate <see cref="T:System.Net.Http.HttpClient" /> can be retrieved from <see cref="M:System.IServiceProvider.GetService(System.Type)" /> (and related methods) by providing <typeparamref name="TClient"/> as the service type. </para> <para> Use <see cref="F:Microsoft.Extensions.Options.Options.DefaultName"/> as the name to configure the default client. </para> </remarks> </member> <member name="M:Microsoft.Extensions.DependencyInjection.HttpClientFactoryServiceCollectionExtensions.AddHttpClient``1(Microsoft.Extensions.DependencyInjection.IServiceCollection,System.String,System.Action{System.Net.Http.HttpClient})"> <summary> Adds the <see cref="T:System.Net.Http.IHttpClientFactory"/> and related services to the <see cref="T:Microsoft.Extensions.DependencyInjection.IServiceCollection"/> and configures a binding between the <typeparamref name="TClient" /> type and a named <see cref="T:System.Net.Http.HttpClient"/>. </summary> <typeparam name="TClient"> The type of the typed client. They type specified will be registered in the service collection as a transient service. See <see cref="T:Microsoft.Extensions.Http.ITypedHttpClientFactory`1" /> for more details about authoring typed clients. </typeparam> <param name="services">The <see cref="T:Microsoft.Extensions.DependencyInjection.IServiceCollection"/>.</param> <param name="name">The logical name of the <see cref="T:System.Net.Http.HttpClient"/> to configure.</param> <param name="configureClient">A delegate that is used to configure an <see cref="T:System.Net.Http.HttpClient"/>.</param> <returns>An <see cref="T:Microsoft.Extensions.DependencyInjection.IHttpClientBuilder"/> that can be used to configure the client.</returns> <remarks> <para> <see cref="T:System.Net.Http.HttpClient"/> instances that apply the provided configuration can be retrieved using <see cref="M:System.Net.Http.IHttpClientFactory.CreateClient(System.String)"/> and providing the matching name. </para> <para> <typeparamref name="TClient"/> instances constructed with the appropriate <see cref="T:System.Net.Http.HttpClient" /> can be retrieved from <see cref="M:System.IServiceProvider.GetService(System.Type)" /> (and related methods) by providing <typeparamref name="TClient"/> as the service type. </para> <para> Use <see cref="F:Microsoft.Extensions.Options.Options.DefaultName"/> as the name to configure the default client. </para> </remarks> </member> <member name="M:Microsoft.Extensions.DependencyInjection.HttpClientFactoryServiceCollectionExtensions.AddHttpClient``2(Microsoft.Extensions.DependencyInjection.IServiceCollection,System.String,System.Action{System.Net.Http.HttpClient})"> <summary> Adds the <see cref="T:System.Net.Http.IHttpClientFactory"/> and related services to the <see cref="T:Microsoft.Extensions.DependencyInjection.IServiceCollection"/> and configures a binding between the <typeparamref name="TClient" /> type and a named <see cref="T:System.Net.Http.HttpClient"/>. </summary> <typeparam name="TClient"> The type of the typed client. They type specified will be registered in the service collection as a transient service. See <see cref="T:Microsoft.Extensions.Http.ITypedHttpClientFactory`1" /> for more details about authoring typed clients. </typeparam> <typeparam name="TImplementation"> The implementation type of the typed client. They type specified will be instantiated by the <see cref="T:Microsoft.Extensions.Http.ITypedHttpClientFactory`1"/> </typeparam> <param name="services">The <see cref="T:Microsoft.Extensions.DependencyInjection.IServiceCollection"/>.</param> <param name="name">The logical name of the <see cref="T:System.Net.Http.HttpClient"/> to configure.</param> <param name="configureClient">A delegate that is used to configure an <see cref="T:System.Net.Http.HttpClient"/>.</param> <returns>An <see cref="T:Microsoft.Extensions.DependencyInjection.IHttpClientBuilder"/> that can be used to configure the client.</returns> <remarks> <para> <see cref="T:System.Net.Http.HttpClient"/> instances that apply the provided configuration can be retrieved using <see cref="M:System.Net.Http.IHttpClientFactory.CreateClient(System.String)"/> and providing the matching name. </para> <para> <typeparamref name="TClient"/> instances constructed with the appropriate <see cref="T:System.Net.Http.HttpClient" /> can be retrieved from <see cref="M:System.IServiceProvider.GetService(System.Type)" /> (and related methods) by providing <typeparamref name="TClient"/> as the service type. </para> <para> Use <see cref="F:Microsoft.Extensions.Options.Options.DefaultName"/> as the name to configure the default client. </para> </remarks> </member> <member name="T:Microsoft.Extensions.DependencyInjection.IHttpClientBuilder"> <summary> A builder for configuring named <see cref="T:System.Net.Http.HttpClient"/> instances returned by <see cref="T:System.Net.Http.IHttpClientFactory"/>. </summary> </member> <member name="P:Microsoft.Extensions.DependencyInjection.IHttpClientBuilder.Name"> <summary> Gets the name of the client configured by this builder. </summary> </member> <member name="P:Microsoft.Extensions.DependencyInjection.IHttpClientBuilder.Services"> <summary> Gets the application service collection. </summary> </member> <member name="T:System.Net.Http.HttpClientFactoryExtensions"> <summary> Extensions methods for <see cref="T:System.Net.Http.IHttpClientFactory"/>. </summary> </member> <member name="M:System.Net.Http.HttpClientFactoryExtensions.CreateClient(System.Net.Http.IHttpClientFactory)"> <summary> Creates a new <see cref="T:System.Net.Http.HttpClient"/> using the default configuration. </summary> <param name="factory">The <see cref="T:System.Net.Http.IHttpClientFactory"/>.</param> <returns>An <see cref="T:System.Net.Http.HttpClient"/> configured using the default configuration.</returns> </member> <member name="T:System.Net.Http.IHttpClientFactory"> <summary> A factory abstraction for a component that can create <see cref="T:System.Net.Http.HttpClient"/> instances with custom configuration for a given logical name. </summary> <remarks> A default <see cref="T:System.Net.Http.IHttpClientFactory"/> can be registered in an <see cref="T:Microsoft.Extensions.DependencyInjection.IServiceCollection"/> by calling <see cref="M:Microsoft.Extensions.DependencyInjection.HttpClientFactoryServiceCollectionExtensions.AddHttpClient(Microsoft.Extensions.DependencyInjection.IServiceCollection)"/>. The default <see cref="T:System.Net.Http.IHttpClientFactory"/> will be registered in the service collection as a singleton. </remarks> </member> <member name="M:System.Net.Http.IHttpClientFactory.CreateClient(System.String)"> <summary> Creates and configures an <see cref="T:System.Net.Http.HttpClient"/> instance using the configuration that corresponds to the logical name specified by <paramref name="name"/>. </summary> <param name="name">The logical name of the client to create.</param> <returns>A new <see cref="T:System.Net.Http.HttpClient"/> instance.</returns> <remarks> <para> Each call to <see cref="M:System.Net.Http.IHttpClientFactory.CreateClient(System.String)"/> is guaranteed to return a new <see cref="T:System.Net.Http.HttpClient"/> instance. Callers may cache the returned <see cref="T:System.Net.Http.HttpClient"/> instance indefinitely or surround its use in a <langword>using</langword> block to dispose it when desired. </para> <para> The default <see cref="T:System.Net.Http.IHttpClientFactory"/> implementation may cache the underlying <see cref="T:System.Net.Http.HttpMessageHandler"/> instances to improve performance. </para> <para> Callers are also free to mutate the returned <see cref="T:System.Net.Http.HttpClient"/> instance's public properties as desired. </para> </remarks> </member> </members> </doc> |