SocketsHttpHandler Třída

Definice

Obor názvů:

System.Net.Http

Sestavení:

System.Net.Http.dll

Zdroj:

SocketsHttpHandler.cs

Poskytuje výchozí obslužnou rutinu zprávy, kterou HttpClientpoužívá .

public ref class SocketsHttpHandler sealed : System::Net::Http::HttpMessageHandler

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public sealed class SocketsHttpHandler : System.Net.Http.HttpMessageHandler

[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
type SocketsHttpHandler = class
    inherit HttpMessageHandler

Public NotInheritable Class SocketsHttpHandler
Inherits HttpMessageHandler

Dědičnost

Object

HttpMessageHandler

SocketsHttpHandler

Atributy

UnsupportedOSPlatformAttribute

Poznámky

Třída SocketsHttpHandler poskytuje implementaci používanou vyšší úrovní síťových tříd HTTP, jako HttpClientje . Použití SocketsHttpHandler nabízí řadu výhod:

• Významné zlepšení výkonu v porovnání s předchozí implementací.
• Odstranění závislostí platformy, které zjednodušuje nasazení a údržbu. Například libcurl už není závislost na .NET pro macOS a Linux.
• Konzistentní chování na všech platformách .NET

Konstruktory

Name	Description
SocketsHttpHandler()	Vytvoří instanci SocketsHttpHandler třídy.

Vlastnosti

Name	Description
ActivityHeadersPropagator	Získá nebo nastaví šíření, který se má použít při šíření distribuovaného trasování a kontextu. Slouží null k zakázání šíření.
AllowAutoRedirect	Získá nebo nastaví hodnotu, která určuje, zda obslužná rutina má následovat odpovědi přesměrování.
AutomaticDecompression	Získá nebo nastaví typ dekomprese metoda používaná obslužnou rutinou pro automatické dekompresi odpovědi http obsahu.
ConnectCallback	Získá nebo nastaví vlastní zpětné volání použité k otevření nových připojení.
ConnectTimeout	Získá nebo nastaví časový rozsah čekání před vypršením časového limitu připojení.
CookieContainer	Získá nebo nastaví spravovaný objekt kontejneru cookie.
Credentials	Získá nebo nastaví ověřovací informace používané touto obslužnou rutinou.
DefaultProxyCredentials	Pokud se použije výchozí (systémový) proxy server, získá nebo nastaví přihlašovací údaje použité k odeslání na výchozí proxy server pro ověření.
EnableMultipleHttp2Connections	Získá nebo nastaví hodnotu, která označuje, zda lze navázat další připojení HTTP/2 ke stejnému serveru.
EnableMultipleHttp3Connections	Získá nebo nastaví hodnotu, která označuje, zda lze navázat další připojení HTTP/3 na stejný server.
Expect100ContinueTimeout	Získá nebo nastaví hodnotu časového limitu pro server HTTP 100 Continue odpověď.
InitialHttp2StreamWindowSize	Definuje počáteční velikost okna příjmu datového proudu HTTP2 pro všechna připojení otevřená tímto SocketsHttpHandlerobjektem .
IsSupported	Získá hodnotu, která označuje, zda obslužná rutina je podporována na aktuální platformě.
KeepAlivePingDelay	Získá nebo nastaví zpoždění příkazu ping naživu.
KeepAlivePingPolicy	Získá nebo nastaví chování ping naživu.
KeepAlivePingTimeout	Získá nebo nastaví časový limit příkazu ping naživu.
MaxAutomaticRedirections	Získá nebo nastaví maximální počet povolených přesměrování HTTP.
MaxConnectionsPerServer	Získá nebo nastaví maximální počet souběžných připojení TCP povolených na jeden server.
MaxResponseDrainSize	Získá nebo nastaví maximální množství dat, které lze vyprázdnit z odpovědí v bajtech.
MaxResponseHeadersLength	Získá nebo nastaví maximální délku v kilobajtech (1024 bajtů) hlaviček odpovědi.
MeterFactory	Získá nebo nastaví IMeterFactory vytvořit vlastní Meter instanci SocketsHttpHandler .
PlaintextStreamFilter	Získá nebo nastaví vlastní zpětné volání, který poskytuje přístup k streamu protokolu HTTP prostého textu.
PooledConnectionIdleTimeout	Získá nebo nastaví, jak dlouho může být připojení nečinné ve fondu, aby se považovalo za opakovaně použitelné.
PooledConnectionLifetime	Získá nebo nastaví, jak dlouho může být připojení ve fondu považováno za opakovaně použitelné.
PreAuthenticate	Získá nebo nastaví hodnotu, která určuje, zda obslužná rutina odešle autorizační hlavičku s požadavkem.
Properties	Získá zapisovatelný slovník (tj. mapování) vlastních vlastností pro požadavky HttpClient. Slovník je inicializován prázdný; Můžete vkládat a dotazovat páry klíč-hodnota pro vlastní obslužné rutiny a speciální zpracování.
Proxy	Získá nebo nastaví vlastní proxy, pokud UseProxy je truevlastnost .
RequestHeaderEncodingSelector	Získá nebo nastaví zpětné volání, které vybere kódovat hodnoty hlavičky Encoding požadavku.
ResponseDrainTimeout	Získá nebo nastaví časový rozsah čekání na vyprázdnění dat z odpovědí.
ResponseHeaderEncodingSelector	Získá nebo nastaví zpětné volání, které vybere Encoding dekódování hodnot hlavičky odpovědi.
SslOptions	Získá nebo nastaví sadu možností používaných pro ověřování TLS klienta.
UseCookies	Získá nebo nastaví hodnotu, která určuje, zda obslužná rutina má používat soubory cookie.
UseProxy	Získá nebo nastaví hodnotu, která určuje, zda obslužná rutina má použít proxy.

Metody

Name	Description
Dispose()	Uvolní nespravované prostředky a odstraní spravované prostředky používané nástrojem HttpMessageHandler. (Zděděno od HttpMessageHandler)
Dispose(Boolean)	Uvolní nespravované prostředky používané spravovanými HttpMessageHandler prostředky a volitelně zlikviduje spravované prostředky. (Zděděno od HttpMessageHandler)
Equals(Object)	Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetType()	Získá Type aktuální instance. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
Send(HttpRequestMessage, CancellationToken)	Při přepsání v odvozené třídě odešle požadavek HTTP se zadaným požadavkem a tokenem zrušení. V opačném případě vyvolá výjimku NotSupportedException. (Zděděno od HttpMessageHandler)
SendAsync(HttpRequestMessage, CancellationToken)	Odešle požadavek HTTP jako asynchronní operaci. (Zděděno od HttpMessageHandler)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)