IHttpClientBuilder Schnittstelle

Definition

Ein Generator zum Konfigurieren von benannten HttpClient-Instanzen, die von IHttpClientFactory zurückgegeben werden.A builder for configuring named HttpClient instances returned by IHttpClientFactory.

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.Gets the name of the client configured by this builder.

Services

Ruft die Anwendungsdienstsammlung ab.Gets the application service collection.

Erweiterungsmethoden

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.Adds a delegate that will be used to create an additional message handler for a named HttpClient.

AddHttpMessageHandler(IHttpClientBuilder, Func<DelegatingHandler>)

Fügt einen Delegaten hinzu, der zum Erstellen eines zusätzlichen Meldungshandlers für eine benannte HttpClient-Klasse verwendet wird.Adds a delegate that will be used to create an additional message handler for a named HttpClient.

AddHttpMessageHandler<THandler>(IHttpClientBuilder)

Fügt einen zusätzlichen Meldungshandler aus dem Abhängigkeitsinjektionscontainer für eine benannte HttpClient-Klasse hinzu.Adds an additional message handler from the dependency injection container for a named HttpClient.

AddTypedClient<TClient>(IHttpClientBuilder)

Konfiguriert eine Bindung zwischen dem TClient-Typ und der benannten HttpClient-Klasse, die der IHttpClientBuilder-Methode zugeordnet ist.Configures a binding between the TClient type and the named HttpClient associated with the IHttpClientBuilder.

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

Konfiguriert eine Bindung zwischen dem TClient-Typ und der benannten HttpClient-Klasse, die der IHttpClientBuilder-Methode zugeordnet ist.Configures a binding between the TClient type and the named HttpClient associated with the IHttpClientBuilder.

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.Configures a binding between the TClient type and the named HttpClient associated with the IHttpClientBuilder.

AddTypedClient<TClient,TImplementation>(IHttpClientBuilder)

Konfiguriert eine Bindung zwischen dem TClient-Typ und der benannten HttpClient-Klasse, die der IHttpClientBuilder-Methode zugeordnet ist.Configures a binding between the TClient type and the named HttpClient associated with the IHttpClientBuilder. Die erstellten Instanzen sind vom Typ TImplementation.The created instances will be of type TImplementation.

ConfigureHttpClient(IHttpClientBuilder, Action<IServiceProvider,HttpClient>)

Fügt einen Delegaten hinzu, der für die Konfiguration einer benannten HttpClient-Klasse verwendet wird.Adds a delegate that will be used to configure a named HttpClient.

ConfigureHttpClient(IHttpClientBuilder, Action<HttpClient>)

Fügt einen Delegaten hinzu, der für die Konfiguration einer benannten HttpClient-Klasse verwendet wird.Adds a delegate that will be used to configure a named HttpClient.

ConfigureHttpMessageHandlerBuilder(IHttpClientBuilder, Action<HttpMessageHandlerBuilder>)

Fügt einen Delegaten hinzu, der zum Konfigurieren von Meldungshandlern mithilfe von HttpMessageHandlerBuilder der benannten HttpClient-Klasse verwendet wird.Adds a delegate that will be used to configure message handlers using HttpMessageHandlerBuilder for a named HttpClient.

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.Adds a delegate that will be used to configure the primary HttpMessageHandler for a named HttpClient.

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.Adds a delegate that will be used to configure the primary HttpMessageHandler for a named HttpClient.

ConfigurePrimaryHttpMessageHandler<THandler>(IHttpClientBuilder)

Konfiguriert die primäre HttpMessageHandler-Klasse aus dem Abhängigkeitsinjektionscontainer für eine benannte HttpClient-Klasse.Configures the primary HttpMessageHandler from the dependency injection container for a named HttpClient.

SetHandlerLifetime(IHttpClientBuilder, TimeSpan)

Legt die Zeitspanne fest, für die eine HttpMessageHandler-Klasse wiederverwendet werden kann.Sets the length of time that a HttpMessageHandler instance can be reused. Für jeden benannten Client kann ein eigener Wert für die Lebensdauer des Handlers konfiguriert werden.Each named client can have its own configured handler lifetime value. Der Standardwert ist 2 Minuten.The default value is two minutes. Legen Sie die Lebensdauer auf InfiniteTimeSpan fest, um das Ablaufen des Handlers zu deaktivieren.Set the lifetime to InfiniteTimeSpan to disable handler expiry.

AddPolicyHandler(IHttpClientBuilder, IAsyncPolicy<HttpResponseMessage>)

Fügt eine PolicyHttpMessageHandler-Klasse hinzu, die die Anforderungsausführung mit dem bereitgestellten Polly.IAsyncPolicy`1-Element umschließt.Adds a PolicyHttpMessageHandler which will surround request execution with the provided Polly.IAsyncPolicy`1.

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.Adds a PolicyHttpMessageHandler which will surround request execution with a policy returned by the policySelector.

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

Fügt eine PolicyHttpMessageHandler-Klasse hinzu, die die Anforderungsausführung mit einer Richtlinie umschließt, die durch die Ausführung der bereitgestellten Schlüsselauswahllogik keySelector und policyFactory zurückgegebenen wird.Adds a PolicyHttpMessageHandler which will surround request execution with a policy returned by executing provided key selection logic keySelector and policyFactory

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.Adds a PolicyHttpMessageHandler which will surround request execution with a policy returned by the policySelector.

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

Fügt eine PolicyHttpMessageHandler-Klasse hinzu, die die Anforderungsausführung mit einer von Polly.Registry.IReadOnlyPolicyRegistry`1 zurückgegebenen Richtlinie umschließt.Adds a PolicyHttpMessageHandler which will surround request execution with a policy returned by the Polly.Registry.IReadOnlyPolicyRegistry`1.

AddPolicyHandlerFromRegistry(IHttpClientBuilder, String)

Fügt eine PolicyHttpMessageHandler-Klasse hinzu, die die Anforderungsausführung mit einer von Polly.Registry.IReadOnlyPolicyRegistry`1 zurückgegebenen Richtlinie umschließt.Adds a PolicyHttpMessageHandler which will surround request execution with a policy returned by the Polly.Registry.IReadOnlyPolicyRegistry`1.

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

Fügt eine PolicyHttpMessageHandler-Klasse hinzu, die die Anforderungsausführung mit einem Polly.Policy-Element umschließt, das durch die Ausführung des bereitgestellten Konfigurationsdelegaten erstellt wird.Adds a PolicyHttpMessageHandler which will surround request execution with a Polly.Policy created by executing the provided configuration delegate. Der Richtliniengenerator wird so vorkonfiguriert, dass die Anwendung der Richtlinie für Anforderungen ausgelöst wird, bei denen ein vorübergehender Fehler angezeigt wird.The policy builder will be preconfigured to trigger application of the policy for requests that fail with conditions that indicate a transient failure.

Gilt für: