IHttpClientBuilder Interfész

Definíció

Névtér:
Microsoft.Extensions.DependencyInjection
Szerelvény:
Microsoft.Extensions.Http.dll
Csomag:
Microsoft.Extensions.Http v11.0.0-preview.5.26302.115
Forrás:
IHttpClientBuilder.cs
Forrás:
IHttpClientBuilder.cs
Forrás:
IHttpClientBuilder.cs
Forrás:
IHttpClientBuilder.cs

A által visszaadott HttpClientnevesített IHttpClientFactory példányok konfigurálására szolgáló szerkesztő.

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

Tulajdonságok

Name Description
Name

Lekéri a szerkesztő által konfigurált ügyfél nevét.
Services

Lekéri az alkalmazásszolgáltatás gyűjteményét.

Bővítő metódusok

Name Description
AddAsKeyed(IHttpClientBuilder, ServiceLifetime)

Egy elnevezett HttpClient és a kapcsolódó kezelőfolyamatot HttpMessageHandler kulcsként regisztrálja kulcsként, kulcsként az ügyfél nevével és a lifetime paraméterben megadott élettartammal. Alapértelmezés szerint az élettartam .Scoped
AddDefaultLogger(IHttpClientBuilder)

Visszaadja az alapértelmezett naplózást egy elnevezetthez HttpClient, ha korábban hívással RemoveAllLoggers(IHttpClientBuilder)eltávolították.
AddExtendedHttpClientLogging(IHttpClientBuilder, Action<LoggingOptions>, Boolean)

Hozzáad egy IHttpClientAsyncLogger naplót a névvel ellátott HttpClientkimenő kérelmek naplóinak küldéséhez.
AddExtendedHttpClientLogging(IHttpClientBuilder, Action<LoggingOptions>)

Hozzáad egy IHttpClientAsyncLogger naplót a névvel ellátott HttpClientkimenő kérelmek naplóinak küldéséhez.
AddExtendedHttpClientLogging(IHttpClientBuilder, Boolean)

Hozzáad egy IHttpClientAsyncLogger naplót a névvel ellátott HttpClientkimenő kérelmek naplóinak küldéséhez.
AddExtendedHttpClientLogging(IHttpClientBuilder, IConfigurationSection, Boolean)

Hozzáad egy IHttpClientAsyncLogger naplót a névvel ellátott HttpClientkimenő kérelmek naplóinak küldéséhez.
AddExtendedHttpClientLogging(IHttpClientBuilder, IConfigurationSection)

Hozzáad egy IHttpClientAsyncLogger naplót a névvel ellátott HttpClientkimenő kérelmek naplóinak küldéséhez.
AddExtendedHttpClientLogging(IHttpClientBuilder)

Hozzáad egy IHttpClientAsyncLogger naplót a névvel ellátott HttpClientkimenő kérelmek naplóinak küldéséhez.
AddHttpMessageHandler(IHttpClientBuilder, Func<DelegatingHandler>)

Hozzáad egy meghatalmazottat, amellyel további üzenetkezelőt hozhat létre egy elnevezett HttpClientszámára.
AddHttpMessageHandler(IHttpClientBuilder, Func<IServiceProvider,DelegatingHandler>)

Hozzáad egy meghatalmazottat, amellyel további üzenetkezelőt hozhat létre egy elnevezett HttpClientszámára.
AddHttpMessageHandler<THandler>(IHttpClientBuilder)

Hozzáad egy további üzenetkezelőt a függőséginjektálási tárolóból egy elnevezetthez HttpClient.
AddLogger(IHttpClientBuilder, Func<IServiceProvider,IHttpClientLogger>, Boolean)

Hozzáad egy meghatalmazottat, amellyel egy további naplózót hoz létre egy elnevezett HttpClientszámára. Az egyéni naplózót egy dedikált naplózási delegatingHandler fogja meghívni a megfelelő nevesített HttpClientkérések mindegyikére.
AddLogger<TLogger>(IHttpClientBuilder, Boolean)

Hozzáad egy meghatalmazottat, amellyel egy további naplózót hoz létre egy elnevezett HttpClientszámára. Az egyéni naplózót egy dedikált naplózási delegatingHandler fogja meghívni a megfelelő nevesített HttpClientkérések mindegyikére.
AddPolicyHandler(IHttpClientBuilder, Func<HttpRequestMessage,IAsyncPolicy<HttpResponseMessage>>)

Hozzáad egy PolicyHttpMessageHandler olyan elemet, amely körülveszi a kérések végrehajtását, és egy, a policySelectorprogram által visszaadott szabályzatot ad vissza.
AddPolicyHandler(IHttpClientBuilder, Func<IServiceProvider,HttpRequestMessage,IAsyncPolicy<HttpResponseMessage>>)

Hozzáad egy PolicyHttpMessageHandler olyan elemet, amely körülveszi a kérések végrehajtását, és egy, a policySelectorprogram által visszaadott szabályzatot ad vissza.
AddPolicyHandler(IHttpClientBuilder, Func<IServiceProvider,HttpRequestMessage, String,IAsyncPolicy<HttpResponseMessage>>, Func<HttpRequestMessage, String>)

Hozzáad egy PolicyHttpMessageHandler olyan parancsot, amely körülveszi a kérés végrehajtását egy visszaadott szabályzattal a megadott kulcskijelölési logika keySelector és policyFactorya .
AddPolicyHandler(IHttpClientBuilder, IAsyncPolicy<HttpResponseMessage>)

Hozzáad egy PolicyHttpMessageHandler olyan elemet, amely körülveszi a kérés végrehajtását a megadott IAsyncPolicy`1.
AddPolicyHandlerFromRegistry(IHttpClientBuilder, Func<IReadOnlyPolicyRegistry<String>,HttpRequestMessage,IAsyncPolicy<HttpResponseMessage>>)

Hozzáad egy PolicyHttpMessageHandler olyan elemet, amely körülveszi a kérések végrehajtását, és egy, a IReadOnlyPolicyRegistry<TKey>program által visszaadott szabályzatot ad vissza.
AddPolicyHandlerFromRegistry(IHttpClientBuilder, String)

Hozzáad egy PolicyHttpMessageHandler olyan elemet, amely körülveszi a kérések végrehajtását, és egy, a IReadOnlyPolicyRegistry<TKey>program által visszaadott szabályzatot ad vissza.
AddResilienceHandler(IHttpClientBuilder, String, Action<ResiliencePipelineBuilder<HttpResponseMessage>,ResilienceHandlerContext>)

Hozzáad egy rugalmassági folyamatkezelőt, amely egy nevesített beágyazott rugalmassági folyamatot használ.
AddResilienceHandler(IHttpClientBuilder, String, Action<ResiliencePipelineBuilder<HttpResponseMessage>>)

Hozzáad egy rugalmassági folyamatkezelőt, amely egy nevesített beágyazott rugalmassági folyamatot használ.
AddServiceDiscovery(IHttpClientBuilder)

Szolgáltatásfelderítést ad hozzá a IHttpClientBuilder.
AddStandardHedgingHandler(IHttpClientBuilder, Action<IRoutingStrategyBuilder>)

Egy standard fedezetkezelőt ad hozzá, amely a kérés végrehajtását szabványos fedezeti mechanizmussal burkolja.
AddStandardHedgingHandler(IHttpClientBuilder)

Egy standard fedezetkezelőt ad hozzá, amely a kérés végrehajtását szabványos fedezeti mechanizmussal burkolja.
AddStandardResilienceHandler(IHttpClientBuilder, Action<HttpStandardResilienceOptions>)

Egy szabványos rugalmasságkezelőt ad hozzá, amely több rugalmassági stratégiát használ alapértelmezett beállításokkal a kérések elküldéséhez és az átmeneti hibák kezeléséhez.
AddStandardResilienceHandler(IHttpClientBuilder, IConfigurationSection)

Egy szabványos rugalmasságkezelőt ad hozzá, amely több rugalmassági stratégiát használ alapértelmezett beállításokkal a kérések elküldéséhez és az átmeneti hibák kezeléséhez.
AddStandardResilienceHandler(IHttpClientBuilder)

Egy szabványos rugalmasságkezelőt ad hozzá, amely több rugalmassági stratégiát használ alapértelmezett beállításokkal a kérések elküldéséhez és az átmeneti hibák kezeléséhez.
AddTransientHttpErrorPolicy(IHttpClientBuilder, Func<PolicyBuilder<HttpResponseMessage>,IAsyncPolicy<HttpResponseMessage>>)

A megadott konfigurációs PolicyHttpMessageHandler meghatalmazott végrehajtásával létrehozott kérések végrehajtásával Policy körülveszi a végrehajtást. A szabályzatszerkesztő előre konfigurálva lesz a szabályzat alkalmazásának aktiválásához olyan kérések esetében, amelyek átmeneti hibát jelző feltételekkel meghiúsulnak.
AddTypedClient<TClient,TImplementation>(IHttpClientBuilder)

Konfigurálja a kötést a TClient típus és a HttpClient névvel társított név IHttpClientBuilderközött. A létrehozott példányok típusa TImplementationa következő lesz:
AddTypedClient<TClient>(IHttpClientBuilder, Func<HttpClient,IServiceProvider,TClient>)

Konfigurálja a kötést a TClient típus és a HttpClient névvel társított név IHttpClientBuilderközött.
AddTypedClient<TClient>(IHttpClientBuilder, Func<HttpClient,TClient>)

Konfigurálja a kötést a TClient típus és a HttpClient névvel társított név IHttpClientBuilderközött.
AddTypedClient<TClient>(IHttpClientBuilder)

Konfigurálja a kötést a TClient típus és a HttpClient névvel társított név IHttpClientBuilderközött.
ConfigureAdditionalHttpMessageHandlers(IHttpClientBuilder, Action<IList<DelegatingHandler>,IServiceProvider>)

Hozzáad egy meghatalmazottat, amellyel további üzenetkezelőket konfigurálhat egy névvel ellátott HttpMessageHandlerBuilderüzenetkezelő használatávalHttpClient.
ConfigureHttpClient(IHttpClientBuilder, Action<HttpClient>)

Hozzáad egy delegáltat, amelyet egy elnevezett HttpClient konfigurálására fog használni.
ConfigureHttpClient(IHttpClientBuilder, Action<IServiceProvider,HttpClient>)

Hozzáad egy delegáltat, amelyet egy elnevezett HttpClient konfigurálására fog használni.
ConfigureHttpMessageHandlerBuilder(IHttpClientBuilder, Action<HttpMessageHandlerBuilder>)
Elavult.

Olyan meghatalmazottat ad hozzá, amely az üzenetkezelők HttpMessageHandlerBuilder névvel történő HttpClientkonfigurálásához használható.
ConfigurePrimaryHttpMessageHandler(IHttpClientBuilder, Action<HttpMessageHandler,IServiceProvider>)

Hozzáad egy meghatalmazottat, amellyel konfigurálható az elsődleges HttpMessageHandler név HttpClient.
ConfigurePrimaryHttpMessageHandler(IHttpClientBuilder, Func<HttpMessageHandler>)

Hozzáad egy meghatalmazottat, amellyel konfigurálható az elsődleges HttpMessageHandler név HttpClient.
ConfigurePrimaryHttpMessageHandler(IHttpClientBuilder, Func<IServiceProvider,HttpMessageHandler>)

Hozzáad egy meghatalmazottat, amellyel konfigurálható az elsődleges HttpMessageHandler név HttpClient.
ConfigurePrimaryHttpMessageHandler<THandler>(IHttpClientBuilder)

Konfigurálja az elsődlegest HttpMessageHandler a függőséginjektálási tárolóból egy megnevezett HttpClient számára.
RedactLoggedHeaders(IHttpClientBuilder, Func<String,Boolean>)

Beállítja azt, Func<T,TResult> amely meghatározza, hogy a HTTP-fejléc értékét a megfelelő fejlécnév alapján újra ki kell-e adni a naplózás előtt.
RedactLoggedHeaders(IHttpClientBuilder, IEnumerable<String>)

Beállítja a HTTP-fejlécek azon neveinek gyűjteményét, amelyek értékeit a naplózás előtt újra ki kell léptetni.
RemoveAllLoggers(IHttpClientBuilder)

Eltávolítja a névvel ellátott HttpClientösszes korábban hozzáadott naplózót, beleértve az alapértelmezetteket is.
RemoveAllResilienceHandlers(IHttpClientBuilder)

Eltávolítja a korábban regisztrált összes rugalmasságkezelőt.
RemoveAsKeyed(IHttpClientBuilder)

Eltávolítja a névvel ellátott HttpClient és HttpMessageHandlera .
SetHandlerLifetime(IHttpClientBuilder, TimeSpan)

A HttpMessageHandler példány újrafelhasználásának időtartamát állítja be. Minden megnevezett ügyfél saját konfigurált kezelői élettartam-értékkel rendelkezhet. Az alapértelmezett érték két perc. Állítsa be az élettartamot a InfiniteTimeSpan kezelő lejáratának letiltásához.
UseSocketsHttpHandler(IHttpClientBuilder, Action<ISocketsHttpHandlerBuilder>)

Elsődleges kezelőként hozzáad vagy frissít SocketsHttpHandler egy elnevezettet HttpClient , és konfigurálja azt a használatával ISocketsHttpHandlerBuilder.
UseSocketsHttpHandler(IHttpClientBuilder, Action<SocketsHttpHandler,IServiceProvider>)

Egy elnevezett SocketsHttpHandlerkezelő elsődleges kezelőjeként adja hozzá vagy frissíti a frissítéseketHttpClient. Ha meg van adva, egy meghatalmazottat is hozzáad, amely az elsődleges SocketsHttpHandlerkonfigurálásához lesz használva.

A következőre érvényes: