HttpClientBuilderExtensions.UseSocketsHttpHandler Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Überlädt
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. |
UseSocketsHttpHandler(IHttpClientBuilder, Action<ISocketsHttpHandlerBuilder>)
Fügt einen benannten HttpClient als primären Handler hinzu oder aktualisiert SocketsHttpHandler ihn und konfiguriert ihn mithilfe von ISocketsHttpHandlerBuilder.
public:
[System::Runtime::CompilerServices::Extension]
static Microsoft::Extensions::DependencyInjection::IHttpClientBuilder ^ UseSocketsHttpHandler(Microsoft::Extensions::DependencyInjection::IHttpClientBuilder ^ builder, Action<Microsoft::Extensions::DependencyInjection::ISocketsHttpHandlerBuilder ^> ^ configureBuilder);
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public static Microsoft.Extensions.DependencyInjection.IHttpClientBuilder UseSocketsHttpHandler (this Microsoft.Extensions.DependencyInjection.IHttpClientBuilder builder, Action<Microsoft.Extensions.DependencyInjection.ISocketsHttpHandlerBuilder> configureBuilder);
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
static member UseSocketsHttpHandler : Microsoft.Extensions.DependencyInjection.IHttpClientBuilder * Action<Microsoft.Extensions.DependencyInjection.ISocketsHttpHandlerBuilder> -> Microsoft.Extensions.DependencyInjection.IHttpClientBuilder
<Extension()>
Public Function UseSocketsHttpHandler (builder As IHttpClientBuilder, configureBuilder As Action(Of ISocketsHttpHandlerBuilder)) As IHttpClientBuilder
Parameter
- builder
- IHttpClientBuilder
Das IHttpClientBuilder.
- configureBuilder
- Action<ISocketsHttpHandlerBuilder>
Delegat, der verwendet wird, um die Konfiguration des primären SocketsHttpHandler auf ISocketsHttpHandlerBuilder einzurichten, die später während der Erstellung auf den primären Handler angewendet wird.
Gibt zurück
Eine IHttpClientBuilder-Schnittstelle, die zum Konfigurieren des Clients verwendet werden kann.
- Attribute
Hinweise
Wenn ein primärer Handler bereits auf SocketsHttpHandler den Wert festgelegt wurde, indem zuvor z. B. oder UseSocketsHttpHandler(IHttpClientBuilder, Action<ISocketsHttpHandlerBuilder>)aufgerufen wurde, ConfigurePrimaryHttpMessageHandler(IHttpClientBuilder, Func<HttpMessageHandler>) wird die für festgelegte Konfiguration auf ISocketsHttpHandlerBuilder die vorhandene instance angewendet. Andernfalls wird eine neue instance von SocketsHttpHandler erstellt.
Gilt für:
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.
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public static Microsoft.Extensions.DependencyInjection.IHttpClientBuilder UseSocketsHttpHandler (this Microsoft.Extensions.DependencyInjection.IHttpClientBuilder builder, Action<System.Net.Http.SocketsHttpHandler,IServiceProvider>? configureHandler = default);
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
static member UseSocketsHttpHandler : Microsoft.Extensions.DependencyInjection.IHttpClientBuilder * Action<System.Net.Http.SocketsHttpHandler, IServiceProvider> -> Microsoft.Extensions.DependencyInjection.IHttpClientBuilder
<Extension()>
Public Function UseSocketsHttpHandler (builder As IHttpClientBuilder, Optional configureHandler As Action(Of SocketsHttpHandler, IServiceProvider) = Nothing) As IHttpClientBuilder
Parameter
- builder
- IHttpClientBuilder
Das IHttpClientBuilder.
- configureHandler
- Action<SocketsHttpHandler,IServiceProvider>
Optionaler Delegat, der zum Konfigurieren des primären SocketsHttpHandlerverwendet wird.
Gibt zurück
Eine IHttpClientBuilder-Schnittstelle, die zum Konfigurieren des Clients verwendet werden kann.
- Attribute
Hinweise
Wenn ein primärer Handler bereits durch SocketsHttpHandler aufrufen, z. B. oderUseSocketsHttpHandler(IHttpClientBuilder, Action<ISocketsHttpHandlerBuilder>), auf den Wert festgelegt wurde, ConfigurePrimaryHttpMessageHandler(IHttpClientBuilder, Func<HttpMessageHandler>) wird der übergebene Delegat configureHandler
auf die vorhandene instance angewendet. Andernfalls wird eine neue instance von SocketsHttpHandler erstellt.