SocketsHttpHandler SocketsHttpHandler SocketsHttpHandler SocketsHttpHandler Class

Definicja

Udostępnia domyślną procedurę obsługi komunikatów używaną HttpClient w programie .NET Core 2,1 i nowszych.Provides the default message handler used by HttpClient in .NET Core 2.1 and later.

public ref class SocketsHttpHandler sealed : System::Net::Http::HttpMessageHandler
public sealed class SocketsHttpHandler : System.Net.Http.HttpMessageHandler
type SocketsHttpHandler = class
    inherit HttpMessageHandler
Public NotInheritable Class SocketsHttpHandler
Inherits HttpMessageHandler
Dziedziczenie
SocketsHttpHandlerSocketsHttpHandlerSocketsHttpHandlerSocketsHttpHandler

Uwagi

Począwszy od platformy .NET Core 2,1, SocketsHttpHandler Klasa zapewnia implementację używaną przez klasy sieci http wyższego poziomu, HttpClienttakie jak.Starting with .NET Core 2.1, the SocketsHttpHandler class provides the implementation used by higher-level HTTP networking classes such as HttpClient. Korzystanie z SocketsHttpHandler oferty oferuje wiele korzyści:The use of SocketsHttpHandler offers a number of advantages:

  • Znaczący wzrost wydajności w porównaniu z poprzednią implementacją.A significant performance improvement when compared with the previous implementation.

  • Eliminacja zależności platformy, która upraszcza wdrażanie i obsługę.The elimination of platform dependencies, which simplifies deployment and servicing. Na przykład libcurl nie jest już zależność od platformy .NET Core dla macOS i .NET Core dla systemu Linux.For example, libcurl is no longer a dependency on .NET Core for macOS and .NET Core for Linux.

  • Spójne zachowanie na wszystkich platformach .NET.Consistent behavior across all .NET platforms.

Jeśli ta zmiana jest niepożądana, można skonfigurować aplikację tak, aby korzystała z starszej System.Net.Http.HttpClientHandler klasy, a nie na wiele sposobów:If this change is undesirable, you can configure your application to use the older System.Net.Http.HttpClientHandler class instead in a number of ways:

  • Przez wywołanie AppContext.SetSwitch metody w następujący sposób:By calling the AppContext.SetSwitch method as follows:

    AppContext.SetSwitch("System.Net.Http.UseSocketsHttpHandler", false);
    
    AppContext.SetSwitch("System.Net.Http.UseSocketsHttpHandler", False)
    
  • Definiując System.Net.Http.UseSocketsHttpHandler przełącznik w pliku konfiguracji . servicecore. runtimeconfig. JSON :By defining the System.Net.Http.UseSocketsHttpHandler switch in the .netcore.runtimeconfig.json configuration file:

    "runtimeOptions": {
      "configProperties": {
          "System.Net.Http.UseSocketsHttpHandler": false
      }
    }
    
  • Przez zdefiniowanie zmiennej środowiskowej DOTNET_SYSTEM_NET_HTTP_USESOCKETSHTTPHANDLER o nazwie i ustawienie jej false na wartość lub 0.By defining an environment variable named DOTNET_SYSTEM_NET_HTTP_USESOCKETSHTTPHANDLER and setting it to either false or 0.

Konstruktory

SocketsHttpHandler() SocketsHttpHandler() SocketsHttpHandler() SocketsHttpHandler()

Właściwości

AllowAutoRedirect AllowAutoRedirect AllowAutoRedirect AllowAutoRedirect
AutomaticDecompression AutomaticDecompression AutomaticDecompression AutomaticDecompression

Pobiera lub ustawia typ metody dekompresji używanej przez program obsługi dla automatycznej dekompresji odpowiedzi zawartości HTTP.Gets or sets the type of decompression method used by the handler for automatic decompression of the HTTP content response.

ConnectTimeout ConnectTimeout ConnectTimeout ConnectTimeout
CookieContainer CookieContainer CookieContainer CookieContainer

Pobiera lub ustawia obiekt kontenera zarządzanego pliku cookie.Gets or sets the managed cookie container object.

Credentials Credentials Credentials Credentials
DefaultProxyCredentials DefaultProxyCredentials DefaultProxyCredentials DefaultProxyCredentials

Gdy używany jest domyślny serwer proxy (systemowy), Pobiera lub ustawia poświadczenia używane do przesyłania do domyślnego serwera proxy na potrzeby uwierzytelniania.When the default (system) proxy is used, gets or sets the credentials used to submit to the default proxy server for authentication.

Expect100ContinueTimeout Expect100ContinueTimeout Expect100ContinueTimeout Expect100ContinueTimeout
MaxAutomaticRedirections MaxAutomaticRedirections MaxAutomaticRedirections MaxAutomaticRedirections

Pobiera lub ustawia maksymalną liczbę dozwolonych przekierowań HTTP.Gets or sets the maximum number of allowed HTTP redirects.

MaxConnectionsPerServer MaxConnectionsPerServer MaxConnectionsPerServer MaxConnectionsPerServer

Pobiera lub ustawia maksymalną liczbę równoczesnych połączeń TCP dozwolonych dla jednego serwera.Gets or sets the maximum number of simultaneous TCP connections allowed to a single server.

MaxResponseDrainSize MaxResponseDrainSize MaxResponseDrainSize MaxResponseDrainSize

Pobiera lub ustawia maksymalną ilość danych, które mogą być opróżniane z odpowiedzi w bajtach.Gets or sets the maximum amount of data that can be drained from responses in bytes.

MaxResponseHeadersLength MaxResponseHeadersLength MaxResponseHeadersLength MaxResponseHeadersLength

Pobiera lub ustawia maksymalną długość w kilobajtach (1024 bajtów) nagłówków odpowiedzi.Gets or sets the maximum length, in kilobytes (1024 bytes), of the response headers.

PooledConnectionIdleTimeout PooledConnectionIdleTimeout PooledConnectionIdleTimeout PooledConnectionIdleTimeout

Pobiera lub ustawia czas bezczynności połączenia w puli, który ma być brany pod uwagę wielokrotne użycie.Gets or sets how long a connection can be idle in the pool to be considered reusable.

PooledConnectionLifetime PooledConnectionLifetime PooledConnectionLifetime PooledConnectionLifetime
PreAuthenticate PreAuthenticate PreAuthenticate PreAuthenticate

Pobiera lub ustawia wartość wskazującą, czy program obsługi wysyła nagłówek autoryzacji z żądaniem.Gets or sets a value that indicates whether the handler sends an Authorization header with the request.

Properties Properties Properties Properties
Proxy Proxy Proxy Proxy

Pobiera lub ustawia niestandardowy serwer proxy, gdy UseProxy właściwość jest true.Gets or sets the custom proxy when the UseProxy property is true.

ResponseDrainTimeout ResponseDrainTimeout ResponseDrainTimeout ResponseDrainTimeout
SslOptions SslOptions SslOptions SslOptions

Pobiera lub ustawia zestaw opcji używanych do uwierzytelniania TLS klienta.Gets or sets the set of options used for client TLS authentication.

UseCookies UseCookies UseCookies UseCookies
UseProxy UseProxy UseProxy UseProxy

Metody

Dispose() Dispose() Dispose() Dispose()

Zwalnia zasoby niezarządzane i usuwa zasoby zarządzane używane przez HttpMessageHandlerprogram.Releases the unmanaged resources and disposes of the managed resources used by the HttpMessageHandler.

(Inherited from HttpMessageHandler)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Zwalnia niezarządzane zasoby używane przez HttpMessageHandler i opcjonalnie usuwa zarządzane zasoby.Releases the unmanaged resources used by the HttpMessageHandler and optionally disposes of the managed resources.

(Inherited from HttpMessageHandler)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Określa, czy określony obiekt jest równy bieżącemu obiektowi.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Służy jako domyślna funkcja skrótu.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Type Pobiera bieżące wystąpienie.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Tworzy skróconą kopię bieżącego Objectelementu.Creates a shallow copy of the current Object.

(Inherited from Object)
SendAsync(HttpRequestMessage, CancellationToken) SendAsync(HttpRequestMessage, CancellationToken) SendAsync(HttpRequestMessage, CancellationToken) SendAsync(HttpRequestMessage, CancellationToken)

Wyślij żądanie HTTP jako operację asynchroniczną.Send an HTTP request as an asynchronous operation.

(Inherited from HttpMessageHandler)
ToString() ToString() ToString() ToString()

Zwraca ciąg, który reprezentuje bieżący obiekt.Returns a string that represents the current object.

(Inherited from Object)

Dotyczy