Skip to content
Permalink
Branch: master
Find file Copy path
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
622 lines (622 sloc) 55.9 KB
<Type Name="HttpClientBuilderExtensions" FullName="Microsoft.Extensions.DependencyInjection.HttpClientBuilderExtensions">
<TypeSignature Language="C#" Value="public static class HttpClientBuilderExtensions" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi abstract sealed beforefieldinit HttpClientBuilderExtensions extends System.Object" />
<TypeSignature Language="DocId" Value="T:Microsoft.Extensions.DependencyInjection.HttpClientBuilderExtensions" />
<TypeSignature Language="VB.NET" Value="Public Module HttpClientBuilderExtensions" />
<TypeSignature Language="C++ CLI" Value="public ref class HttpClientBuilderExtensions abstract sealed" />
<TypeSignature Language="F#" Value="type HttpClientBuilderExtensions = class" />
<AssemblyInfo>
<AssemblyName>Microsoft.Extensions.Http</AssemblyName>
<AssemblyVersion>2.1.0.0</AssemblyVersion>
<AssemblyVersion>2.2.0.0</AssemblyVersion>
<AssemblyVersion>3.0.0.0</AssemblyVersion>
<AssemblyVersion>3.1.0.0</AssemblyVersion>
</AssemblyInfo>
<Base>
<BaseTypeName>System.Object</BaseTypeName>
</Base>
<Interfaces />
<Docs>
<summary>Extension methods for configuring an <see cref="T:Microsoft.Extensions.DependencyInjection.IHttpClientBuilder" /></summary>
<remarks>To be added.</remarks>
</Docs>
<Members>
<Member MemberName="AddHttpMessageHandler">
<MemberSignature Language="C#" Value="public static Microsoft.Extensions.DependencyInjection.IHttpClientBuilder AddHttpMessageHandler (this Microsoft.Extensions.DependencyInjection.IHttpClientBuilder builder, Func&lt;IServiceProvider,System.Net.Http.DelegatingHandler&gt; configureHandler);" />
<MemberSignature Language="ILAsm" Value=".method public static hidebysig class Microsoft.Extensions.DependencyInjection.IHttpClientBuilder AddHttpMessageHandler(class Microsoft.Extensions.DependencyInjection.IHttpClientBuilder builder, class System.Func`2&lt;class System.IServiceProvider, class System.Net.Http.DelegatingHandler&gt; configureHandler) cil managed" />
<MemberSignature Language="DocId" Value="M:Microsoft.Extensions.DependencyInjection.HttpClientBuilderExtensions.AddHttpMessageHandler(Microsoft.Extensions.DependencyInjection.IHttpClientBuilder,System.Func{System.IServiceProvider,System.Net.Http.DelegatingHandler})" />
<MemberSignature Language="VB.NET" Value="&lt;Extension()&gt;&#xA;Public Function AddHttpMessageHandler (builder As IHttpClientBuilder, configureHandler As Func(Of IServiceProvider, DelegatingHandler)) As IHttpClientBuilder" />
<MemberSignature Language="C++ CLI" Value="public:&#xA;[System::Runtime::CompilerServices::Extension]&#xA; static Microsoft::Extensions::DependencyInjection::IHttpClientBuilder ^ AddHttpMessageHandler(Microsoft::Extensions::DependencyInjection::IHttpClientBuilder ^ builder, Func&lt;IServiceProvider ^, System::Net::Http::DelegatingHandler ^&gt; ^ configureHandler);" />
<MemberSignature Language="F#" Value="static member AddHttpMessageHandler : Microsoft.Extensions.DependencyInjection.IHttpClientBuilder * Func&lt;IServiceProvider, System.Net.Http.DelegatingHandler&gt; -&gt; Microsoft.Extensions.DependencyInjection.IHttpClientBuilder" Usage="Microsoft.Extensions.DependencyInjection.HttpClientBuilderExtensions.AddHttpMessageHandler (builder, configureHandler)" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyName>Microsoft.Extensions.Http</AssemblyName>
<AssemblyVersion>2.1.0.0</AssemblyVersion>
<AssemblyVersion>2.2.0.0</AssemblyVersion>
<AssemblyVersion>3.0.0.0</AssemblyVersion>
<AssemblyVersion>3.1.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>Microsoft.Extensions.DependencyInjection.IHttpClientBuilder</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="builder" Type="Microsoft.Extensions.DependencyInjection.IHttpClientBuilder" RefType="this" />
<Parameter Name="configureHandler" Type="System.Func&lt;System.IServiceProvider,System.Net.Http.DelegatingHandler&gt;" />
</Parameters>
<Docs>
<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>
<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>
<returns>An <see cref="T:Microsoft.Extensions.DependencyInjection.IHttpClientBuilder" /> that can be used to configure the client.</returns>
<remarks>
<para>
The <paramref name="configureHandler" /> delegate should return a new instance of the message handler each time it
is invoked.
</para>
<para>
The <see cref="T:System.IServiceProvider" /> argument provided to <paramref name="configureHandler" /> will be
a reference to a scoped service provider that shares the lifetime of the handler being constructed.
</para>
</remarks>
</Docs>
</Member>
<Member MemberName="AddHttpMessageHandler">
<MemberSignature Language="C#" Value="public static Microsoft.Extensions.DependencyInjection.IHttpClientBuilder AddHttpMessageHandler (this Microsoft.Extensions.DependencyInjection.IHttpClientBuilder builder, Func&lt;System.Net.Http.DelegatingHandler&gt; configureHandler);" />
<MemberSignature Language="ILAsm" Value=".method public static hidebysig class Microsoft.Extensions.DependencyInjection.IHttpClientBuilder AddHttpMessageHandler(class Microsoft.Extensions.DependencyInjection.IHttpClientBuilder builder, class System.Func`1&lt;class System.Net.Http.DelegatingHandler&gt; configureHandler) cil managed" />
<MemberSignature Language="DocId" Value="M:Microsoft.Extensions.DependencyInjection.HttpClientBuilderExtensions.AddHttpMessageHandler(Microsoft.Extensions.DependencyInjection.IHttpClientBuilder,System.Func{System.Net.Http.DelegatingHandler})" />
<MemberSignature Language="VB.NET" Value="&lt;Extension()&gt;&#xA;Public Function AddHttpMessageHandler (builder As IHttpClientBuilder, configureHandler As Func(Of DelegatingHandler)) As IHttpClientBuilder" />
<MemberSignature Language="C++ CLI" Value="public:&#xA;[System::Runtime::CompilerServices::Extension]&#xA; static Microsoft::Extensions::DependencyInjection::IHttpClientBuilder ^ AddHttpMessageHandler(Microsoft::Extensions::DependencyInjection::IHttpClientBuilder ^ builder, Func&lt;System::Net::Http::DelegatingHandler ^&gt; ^ configureHandler);" />
<MemberSignature Language="F#" Value="static member AddHttpMessageHandler : Microsoft.Extensions.DependencyInjection.IHttpClientBuilder * Func&lt;System.Net.Http.DelegatingHandler&gt; -&gt; Microsoft.Extensions.DependencyInjection.IHttpClientBuilder" Usage="Microsoft.Extensions.DependencyInjection.HttpClientBuilderExtensions.AddHttpMessageHandler (builder, configureHandler)" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyName>Microsoft.Extensions.Http</AssemblyName>
<AssemblyVersion>2.1.0.0</AssemblyVersion>
<AssemblyVersion>2.2.0.0</AssemblyVersion>
<AssemblyVersion>3.0.0.0</AssemblyVersion>
<AssemblyVersion>3.1.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>Microsoft.Extensions.DependencyInjection.IHttpClientBuilder</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="builder" Type="Microsoft.Extensions.DependencyInjection.IHttpClientBuilder" RefType="this" />
<Parameter Name="configureHandler" Type="System.Func&lt;System.Net.Http.DelegatingHandler&gt;" />
</Parameters>
<Docs>
<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>
<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>
<returns>An <see cref="T:Microsoft.Extensions.DependencyInjection.IHttpClientBuilder" /> that can be used to configure the client.</returns>
<remarks>The <paramref name="configureHandler" /> delegate should return a new instance of the message handler each time it
is invoked.</remarks>
</Docs>
</Member>
<Member MemberName="AddHttpMessageHandler&lt;THandler&gt;">
<MemberSignature Language="C#" Value="public static Microsoft.Extensions.DependencyInjection.IHttpClientBuilder AddHttpMessageHandler&lt;THandler&gt; (this Microsoft.Extensions.DependencyInjection.IHttpClientBuilder builder) where THandler : System.Net.Http.DelegatingHandler;" />
<MemberSignature Language="ILAsm" Value=".method public static hidebysig class Microsoft.Extensions.DependencyInjection.IHttpClientBuilder AddHttpMessageHandler&lt;(class System.Net.Http.DelegatingHandler) THandler&gt;(class Microsoft.Extensions.DependencyInjection.IHttpClientBuilder builder) cil managed" />
<MemberSignature Language="DocId" Value="M:Microsoft.Extensions.DependencyInjection.HttpClientBuilderExtensions.AddHttpMessageHandler``1(Microsoft.Extensions.DependencyInjection.IHttpClientBuilder)" />
<MemberSignature Language="VB.NET" Value="&lt;Extension()&gt;&#xA;Public Function AddHttpMessageHandler(Of THandler As DelegatingHandler) (builder As IHttpClientBuilder) As IHttpClientBuilder" />
<MemberSignature Language="C++ CLI" Value="public:&#xA;generic &lt;typename THandler&gt;&#xA; where THandler : System::Net::Http::DelegatingHandler[System::Runtime::CompilerServices::Extension]&#xA; static Microsoft::Extensions::DependencyInjection::IHttpClientBuilder ^ AddHttpMessageHandler(Microsoft::Extensions::DependencyInjection::IHttpClientBuilder ^ builder);" />
<MemberSignature Language="F#" Value="static member AddHttpMessageHandler : Microsoft.Extensions.DependencyInjection.IHttpClientBuilder -&gt; Microsoft.Extensions.DependencyInjection.IHttpClientBuilder (requires 'Handler :&gt; System.Net.Http.DelegatingHandler)" Usage="Microsoft.Extensions.DependencyInjection.HttpClientBuilderExtensions.AddHttpMessageHandler builder" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyName>Microsoft.Extensions.Http</AssemblyName>
<AssemblyVersion>2.1.0.0</AssemblyVersion>
<AssemblyVersion>2.2.0.0</AssemblyVersion>
<AssemblyVersion>3.0.0.0</AssemblyVersion>
<AssemblyVersion>3.1.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>Microsoft.Extensions.DependencyInjection.IHttpClientBuilder</ReturnType>
</ReturnValue>
<TypeParameters>
<TypeParameter Name="THandler">
<Constraints>
<BaseTypeName>System.Net.Http.DelegatingHandler</BaseTypeName>
</Constraints>
</TypeParameter>
</TypeParameters>
<Parameters>
<Parameter Name="builder" Type="Microsoft.Extensions.DependencyInjection.IHttpClientBuilder" RefType="this" />
</Parameters>
<Docs>
<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>
<param name="builder">The <see cref="T:Microsoft.Extensions.DependencyInjection.IHttpClientBuilder" />.</param>
<summary>Adds an additional message handler from the dependency injection container for a named <see cref="T:System.Net.Http.HttpClient" />.</summary>
<returns>An <see cref="T:Microsoft.Extensions.DependencyInjection.IHttpClientBuilder" /> that can be used to configure the client.</returns>
<remarks>
<para>
The <typeparamref name="THandler" /> will be resolved from a scoped service provider that shares
the lifetime of the handler being constructed.
</para>
</remarks>
</Docs>
</Member>
<Member MemberName="AddTypedClient&lt;TClient&gt;">
<MemberSignature Language="C#" Value="public static Microsoft.Extensions.DependencyInjection.IHttpClientBuilder AddTypedClient&lt;TClient&gt; (this Microsoft.Extensions.DependencyInjection.IHttpClientBuilder builder) where TClient : class;" />
<MemberSignature Language="ILAsm" Value=".method public static hidebysig class Microsoft.Extensions.DependencyInjection.IHttpClientBuilder AddTypedClient&lt;class TClient&gt;(class Microsoft.Extensions.DependencyInjection.IHttpClientBuilder builder) cil managed" />
<MemberSignature Language="DocId" Value="M:Microsoft.Extensions.DependencyInjection.HttpClientBuilderExtensions.AddTypedClient``1(Microsoft.Extensions.DependencyInjection.IHttpClientBuilder)" />
<MemberSignature Language="VB.NET" Value="&lt;Extension()&gt;&#xA;Public Function AddTypedClient(Of TClient As Class) (builder As IHttpClientBuilder) As IHttpClientBuilder" />
<MemberSignature Language="C++ CLI" Value="public:&#xA;generic &lt;typename TClient&gt;&#xA; where TClient : class[System::Runtime::CompilerServices::Extension]&#xA; static Microsoft::Extensions::DependencyInjection::IHttpClientBuilder ^ AddTypedClient(Microsoft::Extensions::DependencyInjection::IHttpClientBuilder ^ builder);" />
<MemberSignature Language="F#" Value="static member AddTypedClient : Microsoft.Extensions.DependencyInjection.IHttpClientBuilder -&gt; Microsoft.Extensions.DependencyInjection.IHttpClientBuilder (requires 'Client : null)" Usage="Microsoft.Extensions.DependencyInjection.HttpClientBuilderExtensions.AddTypedClient builder" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyName>Microsoft.Extensions.Http</AssemblyName>
<AssemblyVersion>2.1.0.0</AssemblyVersion>
<AssemblyVersion>2.2.0.0</AssemblyVersion>
<AssemblyVersion>3.0.0.0</AssemblyVersion>
<AssemblyVersion>3.1.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>Microsoft.Extensions.DependencyInjection.IHttpClientBuilder</ReturnType>
</ReturnValue>
<TypeParameters>
<TypeParameter Name="TClient">
<Constraints>
<ParameterAttribute>ReferenceTypeConstraint</ParameterAttribute>
</Constraints>
</TypeParameter>
</TypeParameters>
<Parameters>
<Parameter Name="builder" Type="Microsoft.Extensions.DependencyInjection.IHttpClientBuilder" RefType="this" />
</Parameters>
<Docs>
<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>
<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>
<returns>To be added.</returns>
<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>
<para>
The typed client's service dependencies will be resolved from the same service provider
that is used to resolve the typed client. It is not possible to access services from the
scope bound to the message handler, which is managed independently.
</para>
</remarks>
</Docs>
</Member>
<Member MemberName="AddTypedClient&lt;TClient&gt;">
<MemberSignature Language="C#" Value="public static Microsoft.Extensions.DependencyInjection.IHttpClientBuilder AddTypedClient&lt;TClient&gt; (this Microsoft.Extensions.DependencyInjection.IHttpClientBuilder builder, Func&lt;System.Net.Http.HttpClient,IServiceProvider,TClient&gt; factory) where TClient : class;" />
<MemberSignature Language="ILAsm" Value=".method public static hidebysig class Microsoft.Extensions.DependencyInjection.IHttpClientBuilder AddTypedClient&lt;class TClient&gt;(class Microsoft.Extensions.DependencyInjection.IHttpClientBuilder builder, class System.Func`3&lt;class System.Net.Http.HttpClient, class System.IServiceProvider, !!TClient&gt; factory) cil managed" />
<MemberSignature Language="DocId" Value="M:Microsoft.Extensions.DependencyInjection.HttpClientBuilderExtensions.AddTypedClient``1(Microsoft.Extensions.DependencyInjection.IHttpClientBuilder,System.Func{System.Net.Http.HttpClient,System.IServiceProvider,``0})" />
<MemberSignature Language="VB.NET" Value="&lt;Extension()&gt;&#xA;Public Function AddTypedClient(Of TClient As Class) (builder As IHttpClientBuilder, factory As Func(Of HttpClient, IServiceProvider, TClient)) As IHttpClientBuilder" />
<MemberSignature Language="C++ CLI" Value="public:&#xA;generic &lt;typename TClient&gt;&#xA; where TClient : class[System::Runtime::CompilerServices::Extension]&#xA; static Microsoft::Extensions::DependencyInjection::IHttpClientBuilder ^ AddTypedClient(Microsoft::Extensions::DependencyInjection::IHttpClientBuilder ^ builder, Func&lt;System::Net::Http::HttpClient ^, IServiceProvider ^, TClient&gt; ^ factory);" />
<MemberSignature Language="F#" Value="static member AddTypedClient : Microsoft.Extensions.DependencyInjection.IHttpClientBuilder * Func&lt;System.Net.Http.HttpClient, IServiceProvider, 'Client (requires 'Client : null)&gt; -&gt; Microsoft.Extensions.DependencyInjection.IHttpClientBuilder (requires 'Client : null)" Usage="Microsoft.Extensions.DependencyInjection.HttpClientBuilderExtensions.AddTypedClient (builder, factory)" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyName>Microsoft.Extensions.Http</AssemblyName>
<AssemblyVersion>2.1.0.0</AssemblyVersion>
<AssemblyVersion>2.2.0.0</AssemblyVersion>
<AssemblyVersion>3.0.0.0</AssemblyVersion>
<AssemblyVersion>3.1.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>Microsoft.Extensions.DependencyInjection.IHttpClientBuilder</ReturnType>
</ReturnValue>
<TypeParameters>
<TypeParameter Name="TClient">
<Constraints>
<ParameterAttribute>ReferenceTypeConstraint</ParameterAttribute>
</Constraints>
</TypeParameter>
</TypeParameters>
<Parameters>
<Parameter Name="builder" Type="Microsoft.Extensions.DependencyInjection.IHttpClientBuilder" RefType="this" />
<Parameter Name="factory" Type="System.Func&lt;System.Net.Http.HttpClient,System.IServiceProvider,TClient&gt;" />
</Parameters>
<Docs>
<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>
<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>
<returns>To be added.</returns>
<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>
</Docs>
</Member>
<Member MemberName="AddTypedClient&lt;TClient&gt;">
<MemberSignature Language="C#" Value="public static Microsoft.Extensions.DependencyInjection.IHttpClientBuilder AddTypedClient&lt;TClient&gt; (this Microsoft.Extensions.DependencyInjection.IHttpClientBuilder builder, Func&lt;System.Net.Http.HttpClient,TClient&gt; factory) where TClient : class;" />
<MemberSignature Language="ILAsm" Value=".method public static hidebysig class Microsoft.Extensions.DependencyInjection.IHttpClientBuilder AddTypedClient&lt;class TClient&gt;(class Microsoft.Extensions.DependencyInjection.IHttpClientBuilder builder, class System.Func`2&lt;class System.Net.Http.HttpClient, !!TClient&gt; factory) cil managed" />
<MemberSignature Language="DocId" Value="M:Microsoft.Extensions.DependencyInjection.HttpClientBuilderExtensions.AddTypedClient``1(Microsoft.Extensions.DependencyInjection.IHttpClientBuilder,System.Func{System.Net.Http.HttpClient,``0})" />
<MemberSignature Language="VB.NET" Value="&lt;Extension()&gt;&#xA;Public Function AddTypedClient(Of TClient As Class) (builder As IHttpClientBuilder, factory As Func(Of HttpClient, TClient)) As IHttpClientBuilder" />
<MemberSignature Language="C++ CLI" Value="public:&#xA;generic &lt;typename TClient&gt;&#xA; where TClient : class[System::Runtime::CompilerServices::Extension]&#xA; static Microsoft::Extensions::DependencyInjection::IHttpClientBuilder ^ AddTypedClient(Microsoft::Extensions::DependencyInjection::IHttpClientBuilder ^ builder, Func&lt;System::Net::Http::HttpClient ^, TClient&gt; ^ factory);" />
<MemberSignature Language="F#" Value="static member AddTypedClient : Microsoft.Extensions.DependencyInjection.IHttpClientBuilder * Func&lt;System.Net.Http.HttpClient, 'Client (requires 'Client : null)&gt; -&gt; Microsoft.Extensions.DependencyInjection.IHttpClientBuilder (requires 'Client : null)" Usage="Microsoft.Extensions.DependencyInjection.HttpClientBuilderExtensions.AddTypedClient (builder, factory)" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyName>Microsoft.Extensions.Http</AssemblyName>
<AssemblyVersion>2.1.0.0</AssemblyVersion>
<AssemblyVersion>2.2.0.0</AssemblyVersion>
<AssemblyVersion>3.0.0.0</AssemblyVersion>
<AssemblyVersion>3.1.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>Microsoft.Extensions.DependencyInjection.IHttpClientBuilder</ReturnType>
</ReturnValue>
<TypeParameters>
<TypeParameter Name="TClient">
<Constraints>
<ParameterAttribute>ReferenceTypeConstraint</ParameterAttribute>
</Constraints>
</TypeParameter>
</TypeParameters>
<Parameters>
<Parameter Name="builder" Type="Microsoft.Extensions.DependencyInjection.IHttpClientBuilder" RefType="this" />
<Parameter Name="factory" Type="System.Func&lt;System.Net.Http.HttpClient,TClient&gt;" />
</Parameters>
<Docs>
<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>
<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>
<returns>To be added.</returns>
<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>
</Docs>
</Member>
<Member MemberName="AddTypedClient&lt;TClient,TImplementation&gt;">
<MemberSignature Language="C#" Value="public static Microsoft.Extensions.DependencyInjection.IHttpClientBuilder AddTypedClient&lt;TClient,TImplementation&gt; (this Microsoft.Extensions.DependencyInjection.IHttpClientBuilder builder) where TClient : class where TImplementation : class, TClient;" />
<MemberSignature Language="ILAsm" Value=".method public static hidebysig class Microsoft.Extensions.DependencyInjection.IHttpClientBuilder AddTypedClient&lt;class TClient, class (!!TClient) TImplementation&gt;(class Microsoft.Extensions.DependencyInjection.IHttpClientBuilder builder) cil managed" />
<MemberSignature Language="DocId" Value="M:Microsoft.Extensions.DependencyInjection.HttpClientBuilderExtensions.AddTypedClient``2(Microsoft.Extensions.DependencyInjection.IHttpClientBuilder)" />
<MemberSignature Language="VB.NET" Value="&lt;Extension()&gt;&#xA;Public Function AddTypedClient(Of TClient As Class, TImplementation As Class) (builder As IHttpClientBuilder) As IHttpClientBuilder" />
<MemberSignature Language="C++ CLI" Value="public:&#xA;generic &lt;typename TClient, typename TImplementation&gt;&#xA; where TClient : class where TImplementation : class, TClient[System::Runtime::CompilerServices::Extension]&#xA; static Microsoft::Extensions::DependencyInjection::IHttpClientBuilder ^ AddTypedClient(Microsoft::Extensions::DependencyInjection::IHttpClientBuilder ^ builder);" />
<MemberSignature Language="F#" Value="static member AddTypedClient : Microsoft.Extensions.DependencyInjection.IHttpClientBuilder -&gt; Microsoft.Extensions.DependencyInjection.IHttpClientBuilder (requires 'Client : null)" Usage="Microsoft.Extensions.DependencyInjection.HttpClientBuilderExtensions.AddTypedClient builder" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyName>Microsoft.Extensions.Http</AssemblyName>
<AssemblyVersion>2.1.0.0</AssemblyVersion>
<AssemblyVersion>2.2.0.0</AssemblyVersion>
<AssemblyVersion>3.0.0.0</AssemblyVersion>
<AssemblyVersion>3.1.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>Microsoft.Extensions.DependencyInjection.IHttpClientBuilder</ReturnType>
</ReturnValue>
<TypeParameters>
<TypeParameter Name="TClient">
<Constraints>
<ParameterAttribute>ReferenceTypeConstraint</ParameterAttribute>
</Constraints>
</TypeParameter>
<TypeParameter Name="TImplementation">
<Constraints>
<ParameterAttribute>ReferenceTypeConstraint</ParameterAttribute>
<BaseTypeName>TClient</BaseTypeName>
</Constraints>
</TypeParameter>
</TypeParameters>
<Parameters>
<Parameter Name="builder" Type="Microsoft.Extensions.DependencyInjection.IHttpClientBuilder" RefType="this" />
</Parameters>
<Docs>
<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>
<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>
<returns>To be added.</returns>
<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>
<para>
The typed client's service dependencies will be resolved from the same service provider
that is used to resolve the typed client. It is not possible to access services from the
scope bound to the message handler, which is managed independently.
</para>
</remarks>
</Docs>
</Member>
<Member MemberName="ConfigureHttpClient">
<MemberSignature Language="C#" Value="public static Microsoft.Extensions.DependencyInjection.IHttpClientBuilder ConfigureHttpClient (this Microsoft.Extensions.DependencyInjection.IHttpClientBuilder builder, Action&lt;IServiceProvider,System.Net.Http.HttpClient&gt; configureClient);" />
<MemberSignature Language="ILAsm" Value=".method public static hidebysig class Microsoft.Extensions.DependencyInjection.IHttpClientBuilder ConfigureHttpClient(class Microsoft.Extensions.DependencyInjection.IHttpClientBuilder builder, class System.Action`2&lt;class System.IServiceProvider, class System.Net.Http.HttpClient&gt; configureClient) cil managed" />
<MemberSignature Language="DocId" Value="M:Microsoft.Extensions.DependencyInjection.HttpClientBuilderExtensions.ConfigureHttpClient(Microsoft.Extensions.DependencyInjection.IHttpClientBuilder,System.Action{System.IServiceProvider,System.Net.Http.HttpClient})" />
<MemberSignature Language="VB.NET" Value="&lt;Extension()&gt;&#xA;Public Function ConfigureHttpClient (builder As IHttpClientBuilder, configureClient As Action(Of IServiceProvider, HttpClient)) As IHttpClientBuilder" />
<MemberSignature Language="C++ CLI" Value="public:&#xA;[System::Runtime::CompilerServices::Extension]&#xA; static Microsoft::Extensions::DependencyInjection::IHttpClientBuilder ^ ConfigureHttpClient(Microsoft::Extensions::DependencyInjection::IHttpClientBuilder ^ builder, Action&lt;IServiceProvider ^, System::Net::Http::HttpClient ^&gt; ^ configureClient);" />
<MemberSignature Language="F#" Value="static member ConfigureHttpClient : Microsoft.Extensions.DependencyInjection.IHttpClientBuilder * Action&lt;IServiceProvider, System.Net.Http.HttpClient&gt; -&gt; Microsoft.Extensions.DependencyInjection.IHttpClientBuilder" Usage="Microsoft.Extensions.DependencyInjection.HttpClientBuilderExtensions.ConfigureHttpClient (builder, configureClient)" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyName>Microsoft.Extensions.Http</AssemblyName>
<AssemblyVersion>2.1.0.0</AssemblyVersion>
<AssemblyVersion>2.2.0.0</AssemblyVersion>
<AssemblyVersion>3.0.0.0</AssemblyVersion>
<AssemblyVersion>3.1.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>Microsoft.Extensions.DependencyInjection.IHttpClientBuilder</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="builder" Type="Microsoft.Extensions.DependencyInjection.IHttpClientBuilder" RefType="this" />
<Parameter Name="configureClient" Type="System.Action&lt;System.IServiceProvider,System.Net.Http.HttpClient&gt;" />
</Parameters>
<Docs>
<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>
<summary>Adds a delegate that will be used to configure a named <see cref="T:System.Net.Http.HttpClient" />.</summary>
<returns>An <see cref="T:Microsoft.Extensions.DependencyInjection.IHttpClientBuilder" /> that can be used to configure the client.</returns>
<remarks>The <see cref="T:System.IServiceProvider" /> provided to <paramref name="configureClient" /> will be the
same application's root service provider instance.</remarks>
</Docs>
</Member>
<Member MemberName="ConfigureHttpClient">
<MemberSignature Language="C#" Value="public static Microsoft.Extensions.DependencyInjection.IHttpClientBuilder ConfigureHttpClient (this Microsoft.Extensions.DependencyInjection.IHttpClientBuilder builder, Action&lt;System.Net.Http.HttpClient&gt; configureClient);" />
<MemberSignature Language="ILAsm" Value=".method public static hidebysig class Microsoft.Extensions.DependencyInjection.IHttpClientBuilder ConfigureHttpClient(class Microsoft.Extensions.DependencyInjection.IHttpClientBuilder builder, class System.Action`1&lt;class System.Net.Http.HttpClient&gt; configureClient) cil managed" />
<MemberSignature Language="DocId" Value="M:Microsoft.Extensions.DependencyInjection.HttpClientBuilderExtensions.ConfigureHttpClient(Microsoft.Extensions.DependencyInjection.IHttpClientBuilder,System.Action{System.Net.Http.HttpClient})" />
<MemberSignature Language="VB.NET" Value="&lt;Extension()&gt;&#xA;Public Function ConfigureHttpClient (builder As IHttpClientBuilder, configureClient As Action(Of HttpClient)) As IHttpClientBuilder" />
<MemberSignature Language="C++ CLI" Value="public:&#xA;[System::Runtime::CompilerServices::Extension]&#xA; static Microsoft::Extensions::DependencyInjection::IHttpClientBuilder ^ ConfigureHttpClient(Microsoft::Extensions::DependencyInjection::IHttpClientBuilder ^ builder, Action&lt;System::Net::Http::HttpClient ^&gt; ^ configureClient);" />
<MemberSignature Language="F#" Value="static member ConfigureHttpClient : Microsoft.Extensions.DependencyInjection.IHttpClientBuilder * Action&lt;System.Net.Http.HttpClient&gt; -&gt; Microsoft.Extensions.DependencyInjection.IHttpClientBuilder" Usage="Microsoft.Extensions.DependencyInjection.HttpClientBuilderExtensions.ConfigureHttpClient (builder, configureClient)" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyName>Microsoft.Extensions.Http</AssemblyName>
<AssemblyVersion>2.1.0.0</AssemblyVersion>
<AssemblyVersion>2.2.0.0</AssemblyVersion>
<AssemblyVersion>3.0.0.0</AssemblyVersion>
<AssemblyVersion>3.1.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>Microsoft.Extensions.DependencyInjection.IHttpClientBuilder</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="builder" Type="Microsoft.Extensions.DependencyInjection.IHttpClientBuilder" RefType="this" />
<Parameter Name="configureClient" Type="System.Action&lt;System.Net.Http.HttpClient&gt;" />
</Parameters>
<Docs>
<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>
<summary>Adds a delegate that will be used to configure a named <see cref="T:System.Net.Http.HttpClient" />.</summary>
<returns>An <see cref="T:Microsoft.Extensions.DependencyInjection.IHttpClientBuilder" /> that can be used to configure the client.</returns>
<remarks>To be added.</remarks>
</Docs>
</Member>
<Member MemberName="ConfigureHttpMessageHandlerBuilder">
<MemberSignature Language="C#" Value="public static Microsoft.Extensions.DependencyInjection.IHttpClientBuilder ConfigureHttpMessageHandlerBuilder (this Microsoft.Extensions.DependencyInjection.IHttpClientBuilder builder, Action&lt;Microsoft.Extensions.Http.HttpMessageHandlerBuilder&gt; configureBuilder);" />
<MemberSignature Language="ILAsm" Value=".method public static hidebysig class Microsoft.Extensions.DependencyInjection.IHttpClientBuilder ConfigureHttpMessageHandlerBuilder(class Microsoft.Extensions.DependencyInjection.IHttpClientBuilder builder, class System.Action`1&lt;class Microsoft.Extensions.Http.HttpMessageHandlerBuilder&gt; configureBuilder) cil managed" />
<MemberSignature Language="DocId" Value="M:Microsoft.Extensions.DependencyInjection.HttpClientBuilderExtensions.ConfigureHttpMessageHandlerBuilder(Microsoft.Extensions.DependencyInjection.IHttpClientBuilder,System.Action{Microsoft.Extensions.Http.HttpMessageHandlerBuilder})" />
<MemberSignature Language="VB.NET" Value="&lt;Extension()&gt;&#xA;Public Function ConfigureHttpMessageHandlerBuilder (builder As IHttpClientBuilder, configureBuilder As Action(Of HttpMessageHandlerBuilder)) As IHttpClientBuilder" />
<MemberSignature Language="C++ CLI" Value="public:&#xA;[System::Runtime::CompilerServices::Extension]&#xA; static Microsoft::Extensions::DependencyInjection::IHttpClientBuilder ^ ConfigureHttpMessageHandlerBuilder(Microsoft::Extensions::DependencyInjection::IHttpClientBuilder ^ builder, Action&lt;Microsoft::Extensions::Http::HttpMessageHandlerBuilder ^&gt; ^ configureBuilder);" />
<MemberSignature Language="F#" Value="static member ConfigureHttpMessageHandlerBuilder : Microsoft.Extensions.DependencyInjection.IHttpClientBuilder * Action&lt;Microsoft.Extensions.Http.HttpMessageHandlerBuilder&gt; -&gt; Microsoft.Extensions.DependencyInjection.IHttpClientBuilder" Usage="Microsoft.Extensions.DependencyInjection.HttpClientBuilderExtensions.ConfigureHttpMessageHandlerBuilder (builder, configureBuilder)" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyName>Microsoft.Extensions.Http</AssemblyName>
<AssemblyVersion>2.1.0.0</AssemblyVersion>
<AssemblyVersion>2.2.0.0</AssemblyVersion>
<AssemblyVersion>3.0.0.0</AssemblyVersion>
<AssemblyVersion>3.1.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>Microsoft.Extensions.DependencyInjection.IHttpClientBuilder</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="builder" Type="Microsoft.Extensions.DependencyInjection.IHttpClientBuilder" RefType="this" />
<Parameter Name="configureBuilder" Type="System.Action&lt;Microsoft.Extensions.Http.HttpMessageHandlerBuilder&gt;" />
</Parameters>
<Docs>
<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>
<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>
<returns>An <see cref="T:Microsoft.Extensions.DependencyInjection.IHttpClientBuilder" /> that can be used to configure the client.</returns>
<remarks>To be added.</remarks>
</Docs>
</Member>
<Member MemberName="ConfigurePrimaryHttpMessageHandler">
<MemberSignature Language="C#" Value="public static Microsoft.Extensions.DependencyInjection.IHttpClientBuilder ConfigurePrimaryHttpMessageHandler (this Microsoft.Extensions.DependencyInjection.IHttpClientBuilder builder, Func&lt;IServiceProvider,System.Net.Http.HttpMessageHandler&gt; configureHandler);" />
<MemberSignature Language="ILAsm" Value=".method public static hidebysig class Microsoft.Extensions.DependencyInjection.IHttpClientBuilder ConfigurePrimaryHttpMessageHandler(class Microsoft.Extensions.DependencyInjection.IHttpClientBuilder builder, class System.Func`2&lt;class System.IServiceProvider, class System.Net.Http.HttpMessageHandler&gt; configureHandler) cil managed" />
<MemberSignature Language="DocId" Value="M:Microsoft.Extensions.DependencyInjection.HttpClientBuilderExtensions.ConfigurePrimaryHttpMessageHandler(Microsoft.Extensions.DependencyInjection.IHttpClientBuilder,System.Func{System.IServiceProvider,System.Net.Http.HttpMessageHandler})" />
<MemberSignature Language="VB.NET" Value="&lt;Extension()&gt;&#xA;Public Function ConfigurePrimaryHttpMessageHandler (builder As IHttpClientBuilder, configureHandler As Func(Of IServiceProvider, HttpMessageHandler)) As IHttpClientBuilder" />
<MemberSignature Language="C++ CLI" Value="public:&#xA;[System::Runtime::CompilerServices::Extension]&#xA; static Microsoft::Extensions::DependencyInjection::IHttpClientBuilder ^ ConfigurePrimaryHttpMessageHandler(Microsoft::Extensions::DependencyInjection::IHttpClientBuilder ^ builder, Func&lt;IServiceProvider ^, System::Net::Http::HttpMessageHandler ^&gt; ^ configureHandler);" />
<MemberSignature Language="F#" Value="static member ConfigurePrimaryHttpMessageHandler : Microsoft.Extensions.DependencyInjection.IHttpClientBuilder * Func&lt;IServiceProvider, System.Net.Http.HttpMessageHandler&gt; -&gt; Microsoft.Extensions.DependencyInjection.IHttpClientBuilder" Usage="Microsoft.Extensions.DependencyInjection.HttpClientBuilderExtensions.ConfigurePrimaryHttpMessageHandler (builder, configureHandler)" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyName>Microsoft.Extensions.Http</AssemblyName>
<AssemblyVersion>2.1.0.0</AssemblyVersion>
<AssemblyVersion>2.2.0.0</AssemblyVersion>
<AssemblyVersion>3.0.0.0</AssemblyVersion>
<AssemblyVersion>3.1.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>Microsoft.Extensions.DependencyInjection.IHttpClientBuilder</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="builder" Type="Microsoft.Extensions.DependencyInjection.IHttpClientBuilder" RefType="this" />
<Parameter Name="configureHandler" Type="System.Func&lt;System.IServiceProvider,System.Net.Http.HttpMessageHandler&gt;" />
</Parameters>
<Docs>
<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>
<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>
<returns>An <see cref="T:Microsoft.Extensions.DependencyInjection.IHttpClientBuilder" /> that can be used to configure the client.</returns>
<remarks>
<para>
The <paramref name="configureHandler" /> delegate should return a new instance of the message handler each time it
is invoked.
</para>
<para>
The <see cref="T:System.IServiceProvider" /> argument provided to <paramref name="configureHandler" /> will be
a reference to a scoped service provider that shares the lifetime of the handler being constructed.
</para>
</remarks>
</Docs>
</Member>
<Member MemberName="ConfigurePrimaryHttpMessageHandler">
<MemberSignature Language="C#" Value="public static Microsoft.Extensions.DependencyInjection.IHttpClientBuilder ConfigurePrimaryHttpMessageHandler (this Microsoft.Extensions.DependencyInjection.IHttpClientBuilder builder, Func&lt;System.Net.Http.HttpMessageHandler&gt; configureHandler);" />
<MemberSignature Language="ILAsm" Value=".method public static hidebysig class Microsoft.Extensions.DependencyInjection.IHttpClientBuilder ConfigurePrimaryHttpMessageHandler(class Microsoft.Extensions.DependencyInjection.IHttpClientBuilder builder, class System.Func`1&lt;class System.Net.Http.HttpMessageHandler&gt; configureHandler) cil managed" />
<MemberSignature Language="DocId" Value="M:Microsoft.Extensions.DependencyInjection.HttpClientBuilderExtensions.ConfigurePrimaryHttpMessageHandler(Microsoft.Extensions.DependencyInjection.IHttpClientBuilder,System.Func{System.Net.Http.HttpMessageHandler})" />
<MemberSignature Language="VB.NET" Value="&lt;Extension()&gt;&#xA;Public Function ConfigurePrimaryHttpMessageHandler (builder As IHttpClientBuilder, configureHandler As Func(Of HttpMessageHandler)) As IHttpClientBuilder" />
<MemberSignature Language="C++ CLI" Value="public:&#xA;[System::Runtime::CompilerServices::Extension]&#xA; static Microsoft::Extensions::DependencyInjection::IHttpClientBuilder ^ ConfigurePrimaryHttpMessageHandler(Microsoft::Extensions::DependencyInjection::IHttpClientBuilder ^ builder, Func&lt;System::Net::Http::HttpMessageHandler ^&gt; ^ configureHandler);" />
<MemberSignature Language="F#" Value="static member ConfigurePrimaryHttpMessageHandler : Microsoft.Extensions.DependencyInjection.IHttpClientBuilder * Func&lt;System.Net.Http.HttpMessageHandler&gt; -&gt; Microsoft.Extensions.DependencyInjection.IHttpClientBuilder" Usage="Microsoft.Extensions.DependencyInjection.HttpClientBuilderExtensions.ConfigurePrimaryHttpMessageHandler (builder, configureHandler)" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyName>Microsoft.Extensions.Http</AssemblyName>
<AssemblyVersion>2.1.0.0</AssemblyVersion>
<AssemblyVersion>2.2.0.0</AssemblyVersion>
<AssemblyVersion>3.0.0.0</AssemblyVersion>
<AssemblyVersion>3.1.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>Microsoft.Extensions.DependencyInjection.IHttpClientBuilder</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="builder" Type="Microsoft.Extensions.DependencyInjection.IHttpClientBuilder" RefType="this" />
<Parameter Name="configureHandler" Type="System.Func&lt;System.Net.Http.HttpMessageHandler&gt;" />
</Parameters>
<Docs>
<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>
<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>
<returns>An <see cref="T:Microsoft.Extensions.DependencyInjection.IHttpClientBuilder" /> that can be used to configure the client.</returns>
<remarks>The <paramref name="configureHandler" /> delegate should return a new instance of the message handler each time it
is invoked.</remarks>
</Docs>
</Member>
<Member MemberName="ConfigurePrimaryHttpMessageHandler&lt;THandler&gt;">
<MemberSignature Language="C#" Value="public static Microsoft.Extensions.DependencyInjection.IHttpClientBuilder ConfigurePrimaryHttpMessageHandler&lt;THandler&gt; (this Microsoft.Extensions.DependencyInjection.IHttpClientBuilder builder) where THandler : System.Net.Http.HttpMessageHandler;" />
<MemberSignature Language="ILAsm" Value=".method public static hidebysig class Microsoft.Extensions.DependencyInjection.IHttpClientBuilder ConfigurePrimaryHttpMessageHandler&lt;(class System.Net.Http.HttpMessageHandler) THandler&gt;(class Microsoft.Extensions.DependencyInjection.IHttpClientBuilder builder) cil managed" />
<MemberSignature Language="DocId" Value="M:Microsoft.Extensions.DependencyInjection.HttpClientBuilderExtensions.ConfigurePrimaryHttpMessageHandler``1(Microsoft.Extensions.DependencyInjection.IHttpClientBuilder)" />
<MemberSignature Language="VB.NET" Value="&lt;Extension()&gt;&#xA;Public Function ConfigurePrimaryHttpMessageHandler(Of THandler As HttpMessageHandler) (builder As IHttpClientBuilder) As IHttpClientBuilder" />
<MemberSignature Language="C++ CLI" Value="public:&#xA;generic &lt;typename THandler&gt;&#xA; where THandler : System::Net::Http::HttpMessageHandler[System::Runtime::CompilerServices::Extension]&#xA; static Microsoft::Extensions::DependencyInjection::IHttpClientBuilder ^ ConfigurePrimaryHttpMessageHandler(Microsoft::Extensions::DependencyInjection::IHttpClientBuilder ^ builder);" />
<MemberSignature Language="F#" Value="static member ConfigurePrimaryHttpMessageHandler : Microsoft.Extensions.DependencyInjection.IHttpClientBuilder -&gt; Microsoft.Extensions.DependencyInjection.IHttpClientBuilder (requires 'Handler :&gt; System.Net.Http.HttpMessageHandler)" Usage="Microsoft.Extensions.DependencyInjection.HttpClientBuilderExtensions.ConfigurePrimaryHttpMessageHandler builder" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyName>Microsoft.Extensions.Http</AssemblyName>
<AssemblyVersion>2.1.0.0</AssemblyVersion>
<AssemblyVersion>2.2.0.0</AssemblyVersion>
<AssemblyVersion>3.0.0.0</AssemblyVersion>
<AssemblyVersion>3.1.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>Microsoft.Extensions.DependencyInjection.IHttpClientBuilder</ReturnType>
</ReturnValue>
<TypeParameters>
<TypeParameter Name="THandler">
<Constraints>
<BaseTypeName>System.Net.Http.HttpMessageHandler</BaseTypeName>
</Constraints>
</TypeParameter>
</TypeParameters>
<Parameters>
<Parameter Name="builder" Type="Microsoft.Extensions.DependencyInjection.IHttpClientBuilder" RefType="this" />
</Parameters>
<Docs>
<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>
<param name="builder">The <see cref="T:Microsoft.Extensions.DependencyInjection.IHttpClientBuilder" />.</param>
<summary>Configures the primary <see cref="T:System.Net.Http.HttpMessageHandler" /> from the dependency injection container
for a named <see cref="T:System.Net.Http.HttpClient" />.</summary>
<returns>An <see cref="T:Microsoft.Extensions.DependencyInjection.IHttpClientBuilder" /> that can be used to configure the client.</returns>
<remarks>
<para>
The <typeparamref name="THandler" /> will be resolved from a scoped service provider that shares
the lifetime of the handler being constructed.
</para>
</remarks>
</Docs>
</Member>
<Member MemberName="SetHandlerLifetime">
<MemberSignature Language="C#" Value="public static Microsoft.Extensions.DependencyInjection.IHttpClientBuilder SetHandlerLifetime (this Microsoft.Extensions.DependencyInjection.IHttpClientBuilder builder, TimeSpan handlerLifetime);" />
<MemberSignature Language="ILAsm" Value=".method public static hidebysig class Microsoft.Extensions.DependencyInjection.IHttpClientBuilder SetHandlerLifetime(class Microsoft.Extensions.DependencyInjection.IHttpClientBuilder builder, valuetype System.TimeSpan handlerLifetime) cil managed" />
<MemberSignature Language="DocId" Value="M:Microsoft.Extensions.DependencyInjection.HttpClientBuilderExtensions.SetHandlerLifetime(Microsoft.Extensions.DependencyInjection.IHttpClientBuilder,System.TimeSpan)" />
<MemberSignature Language="VB.NET" Value="&lt;Extension()&gt;&#xA;Public Function SetHandlerLifetime (builder As IHttpClientBuilder, handlerLifetime As TimeSpan) As IHttpClientBuilder" />
<MemberSignature Language="C++ CLI" Value="public:&#xA;[System::Runtime::CompilerServices::Extension]&#xA; static Microsoft::Extensions::DependencyInjection::IHttpClientBuilder ^ SetHandlerLifetime(Microsoft::Extensions::DependencyInjection::IHttpClientBuilder ^ builder, TimeSpan handlerLifetime);" />
<MemberSignature Language="F#" Value="static member SetHandlerLifetime : Microsoft.Extensions.DependencyInjection.IHttpClientBuilder * TimeSpan -&gt; Microsoft.Extensions.DependencyInjection.IHttpClientBuilder" Usage="Microsoft.Extensions.DependencyInjection.HttpClientBuilderExtensions.SetHandlerLifetime (builder, handlerLifetime)" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyName>Microsoft.Extensions.Http</AssemblyName>
<AssemblyVersion>2.1.0.0</AssemblyVersion>
<AssemblyVersion>2.2.0.0</AssemblyVersion>
<AssemblyVersion>3.0.0.0</AssemblyVersion>
<AssemblyVersion>3.1.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>Microsoft.Extensions.DependencyInjection.IHttpClientBuilder</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="builder" Type="Microsoft.Extensions.DependencyInjection.IHttpClientBuilder" RefType="this" />
<Parameter Name="handlerLifetime" Type="System.TimeSpan" />
</Parameters>
<Docs>
<param name="builder">To be added.</param>
<param name="handlerLifetime">To be added.</param>
<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>
<returns>To be added.</returns>
<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 typically manages its own underlying HTTP connections; creating
more handlers than necessary can result in connection delays. Some handlers also keep connections open indefinitely
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>
</Docs>
</Member>
</Members>
</Type>
You can’t perform that action at this time.