WinHttpHandler Třída

Definice

Obor názvů:

System.Net.Http

Sestavení:

System.Net.Http.WinHttpHandler.dll

Balíček:

System.Net.Http.WinHttpHandler v8.0.0

Zdroj:

WinHttpHandler.cs

Zpracovává zprávy na základě rozhraní WinHTTP systému Windows. Tato třída je určena pro použití v serverových prostředích.

public ref class WinHttpHandler : System::Net::Http::HttpMessageHandler

public class WinHttpHandler : System.Net.Http.HttpMessageHandler

type WinHttpHandler = class
    inherit HttpMessageHandler

Public Class WinHttpHandler
Inherits HttpMessageHandler

Dědičnost

Object

HttpMessageHandler

WinHttpHandler

Poznámky

WinHttpHandler je podobný jiným existujícím třídám, jako HttpClientHandlerje . WinHttpHandler poskytuje obslužnou rutinu pod HttpClient instancí a slouží k odesílání požadavků HTTP na server a přijímání odpovědí serveru. Implementace WinHttpHandler podporuje verze HTTP až DO HTTP/2.

WinHttpHandlerje navržený pro použití primárně v serverových prostředích ASP.NET Core a dalšími aplikacemi .NET, které komunikují se servery HTTP. WinHttpHandler také poskytuje vývojářům podrobnější kontrolu nad komunikací HTTP aplikace než HttpClientHandler třída. To umožňuje vývojářům implementovat pokročilejší scénáře HTTP nebo upravit výchozí nastavení systému (například nastavení proxy serveru, vypršení časových limitů a ověření certifikátu SSL serveru).

WinHttpHandler nemá být náhradou za HttpClientHandler. Místo toho se jedná o pokročilejší verzi, která je k dispozici pro scénáře, ve kterých HttpClientHandler není dostatek. WinHttpHandler je implementovaný jako tenký obálka v rozhraní WinHTTP systému Windows a je podporován pouze v systémech Windows.

Při použití řetězu více obslužných WinHttpHandler rutin by měl být v dolní části řetězce.

Tato třída je také k dispozici pro použití v desktopových aplikacích tím, že ji nainstaluje jako balíček NuGet. Další informace najdete v tématu Balíček NuGet System.Net.Http.WinHttpHandler.

Počínaje verzí .NET 5 WinHttpHandler již není součástí sestaveníSystem.Net.Http.dll jako součást modulu runtime .NET. Další informace najdete v tématu Odebrání rutiny WinHttpHandler z modulu runtime .NET.

Konstruktory

WinHttpHandler()

Inicializuje novou instanci WinHttpHandler třídy.

Vlastnosti

AutomaticDecompression	Získá nebo nastaví typ metody dekomprese používané obslužnou rutinou pro automatickou dekompresi http obsah odpovědi.
AutomaticRedirection	Získá nebo nastaví hodnotu, která označuje, zda obslužná rutina by měla následovat http přesměrování odpovědi.
CheckCertificateRevocationList	Získá nebo nastaví hodnotu, která určuje, zda kontrolovat seznam odvolaných certifikátů během ověřování certifikátu SSL.
ClientCertificateOption	Získá nebo nastaví hodnotu, která označuje, zda je certifikát automaticky vybrán z úložiště certifikátů nebo zda volající je povoleno předat určitý klientský certifikát.
ClientCertificates	Získá kolekci certifikátů SSL ověřování klienta, které se používají pro ověřování klienta obslužnou rutinou, pokud ClientCertificateOption je vlastnost nastavena na Manual.
CookieContainer	Získá nebo nastaví objekt kontejneru spravovaného souboru cookie. Tato vlastnost se používá pouze v CookieUsePolicy případě, že vlastnost je nastavena na UseSpecifiedCookieContainer. V opačném SendAsync(HttpRequestMessage, CancellationToken) případě metoda vyvolá výjimku.
CookieUsePolicy	Získá nebo nastaví hodnotu, která označuje, jak se mají soubory cookie spravovat a používat. Vývojáři se mohou rozhodnout soubory cookie ignorovat, povolit obslužné rutině jejich automatickou správu nebo ruční zpracování pomocí objektu CookieContainer .
DefaultProxyCredentials	Získá nebo nastaví přihlašovací údaje použité k ověření uživatele na ověřovací proxy.
EnableMultipleHttp2Connections	Získá nebo nastaví hodnotu, která označuje, zda lze navázat další připojení HTTP/2 ke stejnému serveru při dosažení maximálního počtu souběžných datových proudů na všech existujících připojeních.
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 povolených připojení TCP 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í velikost části hlavičky z odpovědi serveru v bajtech.
PreAuthenticate	Získá nebo nastaví hodnotu, která označ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 HttpClient požadavky. 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, když WindowsProxyUsePolicy je vlastnost nastavena na použití vlastní proxy.
ReceiveDataTimeout	Získá nebo nastaví časový limit pro příjem datové části odpovědi ze serveru.
ReceiveHeadersTimeout	Získá nebo nastaví časový limit pro příjem hlaviček odpovědi ze serveru.
SendTimeout	Získá nebo nastaví časový limit pro odeslání požadavku.
ServerCertificateValidationCallback	Získá nebo nastaví metodu zpětného volání pro ověření certifikátu serveru. Toto zpětné volání je součástí metody handshake PROTOKOLU SSL.
ServerCredentials	Získá nebo nastaví přihlašovací údaje, které mají být použity klientem k ověření na serveru.
SslProtocols	Získá nebo nastaví kolekci protokolů TLS/SSL podporovaných klientem.
TcpKeepAliveEnabled	Získá nebo nastaví hodnotu označující, zda je povoleno udržování protokolu TCP.
TcpKeepAliveInterval	Získá nebo nastaví interval udržování protokolu TCP.
TcpKeepAliveTime	Získá nebo nastaví časový limit udržování protokolu TCP.
WindowsProxyUsePolicy	Získá nebo nastaví nastavení proxy serveru. Tuto vlastnost je možné nastavit tak, aby zakázala proxy server, použila vlastní proxy server nebo použila nastavení proxy serveru WinHTTP nebo WinInet na počítači.

Metody

Dispose()	Uvolní nespravované prostředky a odstraní spravované prostředky používané HttpMessageHandlernástrojem . (Zděděno od HttpMessageHandler)
Dispose(Boolean)	Uvolní nespravované prostředky používané WinHttpHandlernástrojem a volitelně odstraní spravované prostředky.
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetType()	Získá aktuální Type instanci. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (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 tokenem požadavku a zrušení. V opačném případě vyvolá NotSupportedException. (Zděděno od HttpMessageHandler)
SendAsync(HttpRequestMessage, CancellationToken)	Odešle požadavek HTTP jako asynchronní operaci.
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)