SocketsHttpHandler Klasa

Definicja

Udostępnia domyślną procedurę obsługi komunikatów używaną przez 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
SocketsHttpHandler

Uwagi

Począwszy od platformy .NET Core 2,1, Klasa SocketsHttpHandler zapewnia implementację używaną przez klasy sieci HTTP wyższego poziomu, takie jak HttpClient.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 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 używała starszej klasy System.Net.Http.HttpClientHandler, 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:

  • Wywołując metodę AppContext.SetSwitch 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)
    
  • Przez zdefiniowanie przełącznika System.Net.Http.UseSocketsHttpHandler 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
      }
    }
    
  • Zdefiniowanie zmiennej środowiskowej o nazwie DOTNET_SYSTEM_NET_HTTP_USESOCKETSHTTPHANDLER i ustawienie jej na false lub 0.By defining an environment variable named DOTNET_SYSTEM_NET_HTTP_USESOCKETSHTTPHANDLER and setting it to either false or 0.

Konstruktory

SocketsHttpHandler()

Właściwości

AllowAutoRedirect
AutomaticDecompression

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

ConnectTimeout
CookieContainer

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

Credentials
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
MaxAutomaticRedirections

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

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

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

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

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
PreAuthenticate

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

Properties
Proxy

Pobiera lub ustawia niestandardowy serwer proxy w przypadku truewłaściwości   UseProxy.Gets or sets the custom proxy when the UseProxy property is true.

ResponseDrainTimeout
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
UseProxy

Metody

Dispose()

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

(Odziedziczone po HttpMessageHandler)
Dispose(Boolean)

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

(Odziedziczone po HttpMessageHandler)
Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.Determines whether the specified object is equal to the current object.

(Odziedziczone po Object)
GetHashCode()

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

(Odziedziczone po Object)
GetType()

Pobiera Type bieżącego wystąpienia.Gets the Type of the current instance.

(Odziedziczone po Object)
MemberwiseClone()

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

(Odziedziczone po Object)
SendAsync(HttpRequestMessage, CancellationToken)

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

(Odziedziczone po HttpMessageHandler)
ToString()

Zwraca ciąg reprezentujący bieżący obiekt.Returns a string that represents the current object.

(Odziedziczone po Object)

Dotyczy