IHttpClientBuilder 介面

定義

用來設定 IHttpClientFactory 所傳回具名 HttpClient 執行個體的建立器。

public interface class IHttpClientBuilder
public interface IHttpClientBuilder
type IHttpClientBuilder = interface
Public Interface IHttpClientBuilder

屬性

Name

取得此建立器所設定的用戶端名稱。

Services

取得應用程式服務集合。

擴充方法

AddDefaultLogger(IHttpClientBuilder)

如果先前藉由呼叫 RemoveAllLoggers(IHttpClientBuilder)來移除名為 的預設記錄HttpClient,請將它加回 。

AddHttpMessageHandler(IHttpClientBuilder, Func<IServiceProvider,DelegatingHandler>)

新增將用於為具名 HttpClient 建立其他訊息處理常式的委派。

AddHttpMessageHandler(IHttpClientBuilder, Func<DelegatingHandler>)

新增將用於為具名 HttpClient 建立其他訊息處理常式的委派。

AddHttpMessageHandler<THandler>(IHttpClientBuilder)

從具名 HttpClient 的相依性插入容器中,新增額外的訊息處理常式。

AddLogger(IHttpClientBuilder, Func<IServiceProvider,IHttpClientLogger>, Boolean)

加入將用來為具名 HttpClient建立其他記錄器的委派。 自定義記錄器會在對應 HttpClient之 的每個要求上,從專用記錄委派Handler 叫用。

AddLogger<TLogger>(IHttpClientBuilder, Boolean)

加入將用來為具名 HttpClient建立其他記錄器的委派。 自定義記錄器會在對應 HttpClient之 的每個要求上,從專用記錄委派Handler 叫用。

AddTypedClient<TClient>(IHttpClientBuilder)

設定 TClient 類型和與 IHttpClientBuilder 建立關聯之具名 HttpClient 之間的繫結。

AddTypedClient<TClient>(IHttpClientBuilder, Func<HttpClient,TClient>)

設定 TClient 類型和與 IHttpClientBuilder 建立關聯之具名 HttpClient 之間的繫結。

AddTypedClient<TClient>(IHttpClientBuilder, Func<HttpClient,IServiceProvider,TClient>)

設定 TClient 類型和與 IHttpClientBuilder 建立關聯之具名 HttpClient 之間的繫結。

AddTypedClient<TClient,TImplementation>(IHttpClientBuilder)

設定 TClient 類型和與 IHttpClientBuilder 建立關聯之具名 HttpClient 之間的繫結。 建立的執行個體將屬於類型 TImplementation

ConfigureAdditionalHttpMessageHandlers(IHttpClientBuilder, Action<IList<DelegatingHandler>,IServiceProvider>)

加入委派,這個委派將用來設定用於指定 HttpClient之的其他訊息處理程式HttpMessageHandlerBuilder

ConfigureHttpClient(IHttpClientBuilder, Action<IServiceProvider,HttpClient>)

新增將用於設定具名 HttpClient 的委派。

ConfigureHttpClient(IHttpClientBuilder, Action<HttpClient>)

新增將用於設定具名 HttpClient 的委派。

ConfigureHttpMessageHandlerBuilder(IHttpClientBuilder, Action<HttpMessageHandlerBuilder>)
已淘汰.

新增用於設定訊息處理常式的委派,其會針對具名 HttpClient 使用 HttpMessageHandlerBuilder

ConfigurePrimaryHttpMessageHandler(IHttpClientBuilder, Action<HttpMessageHandler,IServiceProvider>)

新增將用來設定具名 HttpClient 之主要 HttpMessageHandler 的委派。

ConfigurePrimaryHttpMessageHandler(IHttpClientBuilder, Func<IServiceProvider,HttpMessageHandler>)

新增將用來設定具名 HttpClient 之主要 HttpMessageHandler 的委派。

ConfigurePrimaryHttpMessageHandler(IHttpClientBuilder, Func<HttpMessageHandler>)

新增將用來設定具名 HttpClient 之主要 HttpMessageHandler 的委派。

ConfigurePrimaryHttpMessageHandler<THandler>(IHttpClientBuilder)

從具名 HttpClient 的相依性插入容器中設定主要 HttpMessageHandler

RedactLoggedHeaders(IHttpClientBuilder, IEnumerable<String>)

設定應在記錄前修訂其值的 HTTP 標頭名稱集合。

RedactLoggedHeaders(IHttpClientBuilder, Func<String,Boolean>)

設定 Func<T,TResult>,其可決定是否在記錄前先修訂 HTTP 標頭值。

RemoveAllLoggers(IHttpClientBuilder)

拿掉所有先前為具名 HttpClient的記錄器新增的記錄器,包括預設記錄器。

SetHandlerLifetime(IHttpClientBuilder, TimeSpan)

設定可以重複使用 HttpMessageHandler 執行個體的時間長度。 每個具名用戶端都可以設定自己的處理常式存留期值。 預設值為兩分鐘。 將存留期設定成 InfiniteTimeSpan 以停用處理常式到期時間。

UseSocketsHttpHandler(IHttpClientBuilder, Action<ISocketsHttpHandlerBuilder>)

將 或 更新 SocketsHttpHandler 新增為具名 HttpClient 的主要處理程式,並使用 ISocketsHttpHandlerBuilder進行設定。

UseSocketsHttpHandler(IHttpClientBuilder, Action<SocketsHttpHandler,IServiceProvider>)

新增或更新 SocketsHttpHandler 為具名 HttpClient的主要處理程式。 如果提供,也加入將用來設定主要 SocketsHttpHandler的委派。

AddExtendedHttpClientLogging(IHttpClientBuilder)

加入 , IHttpClientAsyncLogger 以針對具名 HttpClient的傳出要求發出記錄。

AddExtendedHttpClientLogging(IHttpClientBuilder, IConfigurationSection)

加入 , IHttpClientAsyncLogger 以針對具名 HttpClient的傳出要求發出記錄。

AddExtendedHttpClientLogging(IHttpClientBuilder, Action<LoggingOptions>)

加入 , IHttpClientAsyncLogger 以針對具名 HttpClient的傳出要求發出記錄。

AddPolicyHandler(IHttpClientBuilder, IAsyncPolicy<HttpResponseMessage>)

新增 PolicyHttpMessageHandler,其會將提供的 IAsyncPolicy`1 以要求執行括住。

AddPolicyHandler(IHttpClientBuilder, Func<IServiceProvider,HttpRequestMessage,IAsyncPolicy<HttpResponseMessage>>)

新增會以 policySelector 所傳回原則括住要求執行的 PolicyHttpMessageHandler

AddPolicyHandler(IHttpClientBuilder, Func<IServiceProvider,HttpRequestMessage, String,IAsyncPolicy<HttpResponseMessage>>, Func<HttpRequestMessage, String>)

加入, PolicyHttpMessageHandler 其會使用藉由執行提供的索引鍵選取邏輯 keySelectorpolicyFactory所傳回的原則來括住要求執行。

AddPolicyHandler(IHttpClientBuilder, Func<HttpRequestMessage,IAsyncPolicy<HttpResponseMessage>>)

新增會以 policySelector 所傳回原則括住要求執行的 PolicyHttpMessageHandler

AddPolicyHandlerFromRegistry(IHttpClientBuilder, Func<IReadOnlyPolicyRegistry<String>,HttpRequestMessage,IAsyncPolicy<HttpResponseMessage>>)

新增會以 IReadOnlyPolicyRegistry<TKey> 所傳回原則括住要求執行的 PolicyHttpMessageHandler

AddPolicyHandlerFromRegistry(IHttpClientBuilder, String)

新增會以 IReadOnlyPolicyRegistry<TKey> 所傳回原則括住要求執行的 PolicyHttpMessageHandler

AddTransientHttpErrorPolicy(IHttpClientBuilder, Func<PolicyBuilder<HttpResponseMessage>,IAsyncPolicy<HttpResponseMessage>>)

新增 PolicyHttpMessageHandler,其會以執行所提供組態委派建立的 Policy 來括住要求執行。 原則建立器將預先設定為針對失敗之要求觸發原則的應用程式,並顯示指出暫時性失敗的條件。

AddResilienceHandler(IHttpClientBuilder, String, Action<ResiliencePipelineBuilder<HttpResponseMessage>,ResilienceHandlerContext>)

新增使用具名內嵌復原管線的復原管線處理程式。

AddResilienceHandler(IHttpClientBuilder, String, Action<ResiliencePipelineBuilder<HttpResponseMessage>>)

新增使用具名內嵌復原管線的復原管線處理程式。

AddStandardHedgingHandler(IHttpClientBuilder)

新增使用標準 Hedging 機制包裝要求執行的標準 Hedging 處理程式。

AddStandardHedgingHandler(IHttpClientBuilder, Action<IRoutingStrategyBuilder>)

新增使用標準 Hedging 機制包裝要求執行的標準 Hedging 處理程式。

AddStandardResilienceHandler(IHttpClientBuilder)

新增標準復原處理程式,此處理程式會使用多個復原策略搭配預設選項來傳送要求並處理任何暫時性錯誤。

AddStandardResilienceHandler(IHttpClientBuilder, IConfigurationSection)

新增標準復原處理程式,此處理程式會使用多個復原策略搭配預設選項來傳送要求並處理任何暫時性錯誤。

AddStandardResilienceHandler(IHttpClientBuilder, Action<HttpStandardResilienceOptions>)

新增標準復原處理程式,此處理程式會使用多個復原策略搭配預設選項來傳送要求並處理任何暫時性錯誤。

適用於