Freigeben über


IHttpClientBuilder Schnittstelle

Definition

Ein Generator zum Konfigurieren von benannten HttpClient-Instanzen, die von IHttpClientFactory zurückgegeben werden.

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

Eigenschaften

Name

Ruft den Namen des Clients ab, der von diesem Generator konfiguriert wird.

Services

Ruft die Anwendungsdienstsammlung ab.

Erweiterungsmethoden

AddAsKeyed(IHttpClientBuilder, ServiceLifetime)

Ein Generator zum Konfigurieren von benannten HttpClient-Instanzen, die von IHttpClientFactory zurückgegeben werden.

AddDefaultLogger(IHttpClientBuilder)

Fügt die Standardprotokollierung für einen benannten HttpClientwieder hinzu, wenn sie zuvor durch Aufrufen RemoveAllLoggers(IHttpClientBuilder)von entfernt wurde.

AddHttpMessageHandler(IHttpClientBuilder, Func<IServiceProvider,DelegatingHandler>)

Fügt einen Delegaten hinzu, der zum Erstellen eines zusätzlichen Meldungshandlers für eine benannte HttpClient-Klasse verwendet wird.

AddHttpMessageHandler(IHttpClientBuilder, Func<DelegatingHandler>)

Fügt einen Delegaten hinzu, der zum Erstellen eines zusätzlichen Meldungshandlers für eine benannte HttpClient-Klasse verwendet wird.

AddHttpMessageHandler<THandler>(IHttpClientBuilder)

Fügt einen zusätzlichen Meldungshandler aus dem Abhängigkeitsinjektionscontainer für eine benannte HttpClient-Klasse hinzu.

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

Fügt einen Delegaten hinzu, der zum Erstellen einer zusätzlichen Protokollierung für einen namens HttpClientverwendet wird. Die benutzerdefinierte Protokollierung wird von einem dedizierten ProtokollierungsdelegatingHandler für jede Anforderung des entsprechenden namens HttpClientaufgerufen.

AddLogger<TLogger>(IHttpClientBuilder, Boolean)

Fügt einen Delegaten hinzu, der zum Erstellen einer zusätzlichen Protokollierung für einen namens HttpClientverwendet wird. Die benutzerdefinierte Protokollierung wird von einem dedizierten ProtokollierungsdelegatingHandler für jede Anforderung des entsprechenden namens HttpClientaufgerufen.

AddTypedClient<TClient>(IHttpClientBuilder)

Konfiguriert eine Bindung zwischen dem TClient-Typ und der benannten HttpClient-Klasse, die der IHttpClientBuilder-Methode zugeordnet ist.

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

Konfiguriert eine Bindung zwischen dem TClient-Typ und der benannten HttpClient-Klasse, die der IHttpClientBuilder-Methode zugeordnet ist.

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

Konfiguriert eine Bindung zwischen dem TClient-Typ und der benannten HttpClient-Klasse, die der IHttpClientBuilder-Methode zugeordnet ist.

AddTypedClient<TClient,TImplementation>(IHttpClientBuilder)

Konfiguriert eine Bindung zwischen dem TClient-Typ und der benannten HttpClient-Klasse, die der IHttpClientBuilder-Methode zugeordnet ist. Die erstellten Instanzen sind vom Typ TImplementation.

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

Fügt einen Delegaten hinzu, der zum Konfigurieren zusätzlicher Nachrichtenhandler mithilfe von HttpMessageHandlerBuilder für einen benannten HttpClientverwendet wird.

ConfigureHttpClient(IHttpClientBuilder, Action<IServiceProvider,HttpClient>)

Fügt einen Delegaten hinzu, der für die Konfiguration einer benannten HttpClient-Klasse verwendet wird.

ConfigureHttpClient(IHttpClientBuilder, Action<HttpClient>)

Fügt einen Delegaten hinzu, der für die Konfiguration einer benannten HttpClient-Klasse verwendet wird.

ConfigureHttpMessageHandlerBuilder(IHttpClientBuilder, Action<HttpMessageHandlerBuilder>)
Veraltet.

Fügt einen Delegaten hinzu, der zum Konfigurieren von Meldungshandlern mithilfe von HttpMessageHandlerBuilder der benannten HttpClient-Klasse verwendet wird.

ConfigurePrimaryHttpMessageHandler(IHttpClientBuilder, Action<HttpMessageHandler,IServiceProvider>)

Fügt einen Delegaten hinzu, der für die Konfiguration der primären HttpMessageHandler-Klasse für eine benannte HttpClient-Klasse verwendet wird.

ConfigurePrimaryHttpMessageHandler(IHttpClientBuilder, Func<IServiceProvider,HttpMessageHandler>)

Fügt einen Delegaten hinzu, der für die Konfiguration der primären HttpMessageHandler-Klasse für eine benannte HttpClient-Klasse verwendet wird.

ConfigurePrimaryHttpMessageHandler(IHttpClientBuilder, Func<HttpMessageHandler>)

Fügt einen Delegaten hinzu, der für die Konfiguration der primären HttpMessageHandler-Klasse für eine benannte HttpClient-Klasse verwendet wird.

ConfigurePrimaryHttpMessageHandler<THandler>(IHttpClientBuilder)

Konfiguriert die primäre HttpMessageHandler-Klasse aus dem Abhängigkeitsinjektionscontainer für eine benannte HttpClient-Klasse.

RedactLoggedHeaders(IHttpClientBuilder, IEnumerable<String>)

Legt die Sammlung von HTTP-Headernamen fest, für die vor der Protokollierung Werte bearbeitet werden sollen.

RedactLoggedHeaders(IHttpClientBuilder, Func<String,Boolean>)

Legt die Func<T,TResult> fest, die bestimmt, ob der HTTP-Headerwert vor der Protokollierung bearbeitet wird.

RemoveAllLoggers(IHttpClientBuilder)

Entfernt alle zuvor hinzugefügten Protokollierungen für einen benannten HttpClient, einschließlich der Standardprotokollierung.

RemoveAsKeyed(IHttpClientBuilder)

Ein Generator zum Konfigurieren von benannten HttpClient-Instanzen, die von IHttpClientFactory zurückgegeben werden.

SetHandlerLifetime(IHttpClientBuilder, TimeSpan)

Legt die Zeitspanne fest, für die eine HttpMessageHandler-Klasse wiederverwendet werden kann. Für jeden benannten Client kann ein eigener Wert für die Lebensdauer des Handlers konfiguriert werden. Der Standardwert ist 2 Minuten. Legen Sie die Lebensdauer auf InfiniteTimeSpan fest, um das Ablaufen des Handlers zu deaktivieren.

UseSocketsHttpHandler(IHttpClientBuilder, Action<ISocketsHttpHandlerBuilder>)

Fügt einen benannten HttpClient als primären Handler hinzu oder aktualisiert SocketsHttpHandler ihn und konfiguriert ihn mithilfe von ISocketsHttpHandlerBuilder.

UseSocketsHttpHandler(IHttpClientBuilder, Action<SocketsHttpHandler,IServiceProvider>)

Fügt oder aktualisiert SocketsHttpHandler als primären Handler für einen namens HttpClient. Falls angegeben, fügt auch einen Delegaten hinzu, der zum Konfigurieren des primären SocketsHttpHandlerverwendet wird.

AddExtendedHttpClientLogging(IHttpClientBuilder)

Fügt ein IHttpClientAsyncLogger hinzu, um Protokolle für ausgehende Anforderungen für einen namens HttpClientausgibt.

AddExtendedHttpClientLogging(IHttpClientBuilder, IConfigurationSection)

Fügt ein IHttpClientAsyncLogger hinzu, um Protokolle für ausgehende Anforderungen für einen namens HttpClientausgibt.

AddExtendedHttpClientLogging(IHttpClientBuilder, Action<LoggingOptions>)

Fügt ein IHttpClientAsyncLogger hinzu, um Protokolle für ausgehende Anforderungen für einen namens HttpClientausgibt.

AddPolicyHandler(IHttpClientBuilder, IAsyncPolicy<HttpResponseMessage>)

Fügt eine PolicyHttpMessageHandler-Klasse hinzu, die die Anforderungsausführung mit dem bereitgestellten IAsyncPolicy`1-Element umschließt.

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

Fügt eine PolicyHttpMessageHandler-Klasse hinzu, die die Anforderungsausführung mit einer von policySelector zurückgegebenen Richtlinie umschließt.

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

Fügt eine PolicyHttpMessageHandler hinzu, die die Anforderungsausführung mit einer richtlinie umgibt, die zurückgegeben wird, indem die bereitgestellte Schlüsselauswahllogik keySelector und ausgeführt policyFactorywerden.

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

Fügt eine PolicyHttpMessageHandler-Klasse hinzu, die die Anforderungsausführung mit einer von policySelector zurückgegebenen Richtlinie umschließt.

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

Fügt eine PolicyHttpMessageHandler-Klasse hinzu, die die Anforderungsausführung mit einer von IReadOnlyPolicyRegistry<TKey> zurückgegebenen Richtlinie umschließt.

AddPolicyHandlerFromRegistry(IHttpClientBuilder, String)

Fügt eine PolicyHttpMessageHandler-Klasse hinzu, die die Anforderungsausführung mit einer von IReadOnlyPolicyRegistry<TKey> zurückgegebenen Richtlinie umschließt.

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

Fügt eine PolicyHttpMessageHandler-Klasse hinzu, die die Anforderungsausführung mit einem Policy-Element umschließt, das durch die Ausführung des bereitgestellten Konfigurationsdelegaten erstellt wird. Der Richtliniengenerator wird so vorkonfiguriert, dass die Anwendung der Richtlinie für Anforderungen ausgelöst wird, bei denen ein vorübergehender Fehler angezeigt wird.

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

Fügt einen Resilienzpipelinehandler hinzu, der eine benannte Inlineresilienzpipeline verwendet.

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

Fügt einen Resilienzpipelinehandler hinzu, der eine benannte Inlineresilienzpipeline verwendet.

AddStandardHedgingHandler(IHttpClientBuilder)

Fügt einen Standard hedging-Handler hinzu, der die Ausführung der Anforderung mit einem Standardsicherungsmechanismus umschließt.

AddStandardHedgingHandler(IHttpClientBuilder, Action<IRoutingStrategyBuilder>)

Fügt einen Standard hedging-Handler hinzu, der die Ausführung der Anforderung mit einem Standardsicherungsmechanismus umschließt.

AddStandardResilienceHandler(IHttpClientBuilder)

Fügt einen Standard-Resilienzhandler hinzu, der mehrere Resilienzstrategien mit Standardoptionen verwendet, um die Anforderungen zu senden und vorübergehende Fehler zu behandeln.

AddStandardResilienceHandler(IHttpClientBuilder, IConfigurationSection)

Fügt einen Standard-Resilienzhandler hinzu, der mehrere Resilienzstrategien mit Standardoptionen verwendet, um die Anforderungen zu senden und vorübergehende Fehler zu behandeln.

AddStandardResilienceHandler(IHttpClientBuilder, Action<HttpStandardResilienceOptions>)

Fügt einen Standard-Resilienzhandler hinzu, der mehrere Resilienzstrategien mit Standardoptionen verwendet, um die Anforderungen zu senden und vorübergehende Fehler zu behandeln.

Gilt für: