共用方式為


IHttpClientBuilder 介面

定義

一個用於配置命名 HttpClient 實例的建構器,返回 IHttpClientFactory

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

屬性

名稱 Description
Name

會取得由這個建置商設定的客戶名稱。

Services

取得應用程式服務集合。

擴充方法

名稱 Description
AddAsKeyed(IHttpClientBuilder, ServiceLifetime)

將一個命名 HttpClient 的處理流程及相關的處理流程 HttpMessageHandler 註冊為有鍵的服務,並以客戶端名稱為鍵,參數中提供 lifetime 壽命。 預設壽命為 Scoped

AddDefaultLogger(IHttpClientBuilder)

若先前已透過呼叫RemoveAllLoggers(IHttpClientBuilder)移除,則回傳已移除的命名HttpClient日誌。

AddExtendedHttpClientLogging(IHttpClientBuilder, Action<LoggingOptions>)

新增 以 IHttpClientAsyncLogger 發送出函請求的日誌 HttpClient

AddExtendedHttpClientLogging(IHttpClientBuilder, IConfigurationSection)

新增 以 IHttpClientAsyncLogger 發送出函請求的日誌 HttpClient

AddExtendedHttpClientLogging(IHttpClientBuilder)

新增 以 IHttpClientAsyncLogger 發送出函請求的日誌 HttpClient

AddHttpMessageHandler(IHttpClientBuilder, Func<DelegatingHandler>)

新增一個代理,用於為一個命名 HttpClient的 。

AddHttpMessageHandler(IHttpClientBuilder, Func<IServiceProvider,DelegatingHandler>)

新增一個代理,用於為一個命名 HttpClient的 。

AddHttpMessageHandler<THandler>(IHttpClientBuilder)

從相依注入容器中新增一個名為 HttpClient的訊息處理器。

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

新增一個代理,用於建立一個名為 HttpClient的 的額外記錄器。 自訂日誌會從專用的日誌 DelegatingHandler 中,對應的 HttpClient

AddLogger<TLogger>(IHttpClientBuilder, Boolean)

新增一個代理,用於建立一個名為 HttpClient的 的額外記錄器。 自訂日誌會從專用的日誌 DelegatingHandler 中,對應的 HttpClient

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

新增一個 PolicyHttpMessageHandler ,將請求執行包 policySelector圍一個由 .

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

新增一個 PolicyHttpMessageHandler ,將請求執行包 policySelector圍一個由 .

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

新增一個 PolicyHttpMessageHandler ,將請求執行包圍一個策略,透過執行提供的金鑰選擇邏輯 keySelectorpolicyFactory

AddPolicyHandler(IHttpClientBuilder, IAsyncPolicy<HttpResponseMessage>)

新增一個 PolicyHttpMessageHandler ,將請求執行包圍於提供的 IAsyncPolicy`1

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

新增一個 PolicyHttpMessageHandler ,將請求執行包 IReadOnlyPolicyRegistry<TKey>圍一個由 .

AddPolicyHandlerFromRegistry(IHttpClientBuilder, String)

新增一個 PolicyHttpMessageHandler ,將請求執行包 IReadOnlyPolicyRegistry<TKey>圍一個由 .

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

新增一個韌性管線處理器,使用命名的內嵌韌性管線。

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

新增一個韌性管線處理器,使用命名的內嵌韌性管線。

AddStandardHedgingHandler(IHttpClientBuilder, Action<IRoutingStrategyBuilder>)

新增一個標準的避險處理程序,將請求的執行包裝成標準的避險機制。

AddStandardHedgingHandler(IHttpClientBuilder)

新增一個標準的避險處理程序,將請求的執行包裝成標準的避險機制。

AddStandardResilienceHandler(IHttpClientBuilder, Action<HttpStandardResilienceOptions>)

新增標準韌性處理器,使用多種韌性策略並預設選項來傳送請求及處理任何暫態錯誤。

AddStandardResilienceHandler(IHttpClientBuilder, IConfigurationSection)

新增標準韌性處理器,使用多種韌性策略並預設選項來傳送請求及處理任何暫態錯誤。

AddStandardResilienceHandler(IHttpClientBuilder)

新增標準韌性處理器,使用多種韌性策略並預設選項來傳送請求及處理任何暫態錯誤。

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

新增一個 PolicyHttpMessageHandler ,將請求執行與執行所提供的配置代理所建立的 A Policy 包圍。 政策建構器會預先設定,對於在顯示暫時性故障的請求失敗時,觸發該政策的應用。

AddTypedClient<TClient,TImplementation>(IHttpClientBuilder)

配置型別與與 IHttpClientBuilder相關聯的名稱HttpClient之間的TClient綁定。 所建立的實例類型為 TImplementation

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

配置型別與與 IHttpClientBuilder相關聯的名稱HttpClient之間的TClient綁定。

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

配置型別與與 IHttpClientBuilder相關聯的名稱HttpClient之間的TClient綁定。

AddTypedClient<TClient>(IHttpClientBuilder)

配置型別與與 IHttpClientBuilder相關聯的名稱HttpClient之間的TClient綁定。

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

新增一個代理,用於設定額外的訊息處理程序,使用 HttpMessageHandlerBuilderHttpClient

ConfigureHttpClient(IHttpClientBuilder, Action<HttpClient>)

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

ConfigureHttpClient(IHttpClientBuilder, Action<IServiceProvider,HttpClient>)

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

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

新增一個代理,用於設定訊息處理器,使用 HttpMessageHandlerBuilderHttpClient

ConfigurePrimaryHttpMessageHandler(IHttpClientBuilder, Action<HttpMessageHandler,IServiceProvider>)

新增一個代理,用於設定命名HttpClient的主節點HttpMessageHandler

ConfigurePrimaryHttpMessageHandler(IHttpClientBuilder, Func<HttpMessageHandler>)

新增一個代理,用於設定命名HttpClient的主節點HttpMessageHandler

ConfigurePrimaryHttpMessageHandler(IHttpClientBuilder, Func<IServiceProvider,HttpMessageHandler>)

新增一個代理,用於設定命名HttpClient的主節點HttpMessageHandler

ConfigurePrimaryHttpMessageHandler<THandler>(IHttpClientBuilder)

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

RedactLoggedHeaders(IHttpClientBuilder, Func<String,Boolean>)

設定 , Func<T,TResult> 決定是否根據對應標頭名稱在記錄前遮蔽 HTTP 標頭值。

RedactLoggedHeaders(IHttpClientBuilder, IEnumerable<String>)

設定 HTTP 標頭名稱集合,記錄前應遮蔽的值。

RemoveAllLoggers(IHttpClientBuilder)

移除所有先前新增的已命名 HttpClient記錄器,包括預設的。

RemoveAllResilienceHandlers(IHttpClientBuilder)

移除所有先前註冊的韌性處理者。

RemoveAsKeyed(IHttpClientBuilder)

移除命名 HttpClientHttpMessageHandler的鍵化註冊。

SetHandlerLifetime(IHttpClientBuilder, TimeSpan)

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

UseSocketsHttpHandler(IHttpClientBuilder, Action<ISocketsHttpHandlerBuilder>)

新增或更新 SocketsHttpHandler 為命名 HttpClient 的主處理器,並使用 ISocketsHttpHandlerBuilder

UseSocketsHttpHandler(IHttpClientBuilder, Action<SocketsHttpHandler,IServiceProvider>)

新增或更新 SocketsHttpHandler 為命名 HttpClient的 。 若提供,也會新增一個代理,用於配置主節點 SocketsHttpHandler

適用於