WinHttpHandler Klass
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Hanterar meddelanden baserat på WinHTTP-gränssnittet för Windows. Den här klassen är avsedd för användning i servermiljöer.
public ref class WinHttpHandler : System::Net::Http::HttpMessageHandlerpublic class WinHttpHandler : System.Net.Http.HttpMessageHandlertype WinHttpHandler = class
inherit HttpMessageHandlerPublic Class WinHttpHandler
Inherits HttpMessageHandler- Arv
Kommentarer
WinHttpHandler liknar andra befintliga klasser, till exempel HttpClientHandler. WinHttpHandler tillhandahåller en hanterare under en HttpClient instans och används för att skicka HTTP-begäranden till en server och ta emot serversvar. Implementeringen WinHttpHandler stöder HTTP-versioner upp till HTTP/2.
WinHttpHandler ger utvecklare mer detaljerad kontroll över programmets HTTP-kommunikation än HttpClientHandler klassen. På så sätt kan utvecklare implementera mer avancerade HTTP-scenarier eller ändra systemstandarder (till exempel proxyinställningar, tidsgränser och verifiering av server-SSL-certifikat).
WinHttpHandler är inte avsedd att ersätta HttpClientHandler. I stället är det en mer avancerad version som tillhandahålls för scenarier där HttpClientHandler det inte räcker. WinHttpHandler implementeras som en tunn omslutning i WinHTTP-gränssnittet för Windows och stöds endast på Windows system.
När du använder en kedja med flera hanterare WinHttpHandler bör du vara längst ned i kedjan.
Från och med .NET 5 ingår WinHttpHandler inte längre i sammansättningen System.Net.Http.dll som en del av .NET-körningen. Mer information finns i WinHttpHandler har tagits bort från .NET runtime.
Avslutande rubriker
Från och med version 6.0.0 har WinHttpHandler stöd för avslutande rubriker, även kallade trailers (RFC 7230 – 4.1.2. Segmenterad släpvagnsdel).
- På .NET Standard 2.1 och .NET 8 eller senare läggs släpvagnar till i TrailingHeaders.
- På .NET Framework läggs trailers till i en välkänd egenskap i HttpRequestMessage.Properties på begärandeobjektet som motsvarar svaret (HttpResponseMessage.RequestMessage). Namnet på egenskapen är
__ResponseTrailers, typen av egenskapsvärde är HttpHeaders.
Stöd för trailer implementeras via WINHTTP_QUERY_FLAG_TRAILERSQuery Info Flag som har introducerats i Windows 11 version 21H2 (10.0; Bygge 22000). På Windows system där WINHTTP_QUERY_FLAG_TRAILERS inte stöds ignoreras trailers.
Konstruktorer
| Name | Description |
|---|---|
| WinHttpHandler() |
Initierar en ny instans av WinHttpHandler klassen. |
Egenskaper
| Name | Description |
|---|---|
| AutomaticDecompression |
Hämtar eller anger vilken typ av dekomprimeringsmetod som används av hanteraren för automatisk dekomprimering av HTTP-innehållssvaret. |
| AutomaticRedirection |
Hämtar eller anger ett värde som anger om hanteraren ska följa HTTP-omdirigeringssvar. |
| CheckCertificateRevocationList |
Hämtar eller anger ett värde som anger om du vill kontrollera listan över återkallade certifikat under SSL-certifikatverifiering. |
| ClientCertificateOption |
Hämtar eller anger ett värde som anger om certifikatet väljs automatiskt från certifikatarkivet eller om anroparen tillåts skicka in ett specifikt klientcertifikat. |
| ClientCertificates |
Hämtar en samling SSL-certifikat för klientautentisering som används för klientautentisering av hanteraren om ClientCertificateOption egenskapen är inställd på |
| CookieContainer |
Hämtar eller anger det hanterade cookiecontainerobjektet. Den här egenskapen används endast när egenskapen CookieUsePolicy är inställd på UseSpecifiedCookieContainer. Annars SendAsync(HttpRequestMessage, CancellationToken) utlöser metoden ett undantag. |
| CookieUsePolicy |
Hämtar eller anger ett värde som anger hur cookies ska hanteras och användas. Utvecklare kan välja att ignorera cookies, låta hanteraren automatiskt hantera dem eller hantera dem manuellt med hjälp av ett CookieContainer objekt. |
| DefaultProxyCredentials |
När standardproxyn (system) används hämtar eller anger du de autentiseringsuppgifter som används för att skicka till standardproxyservern för autentisering. |
| EnableMultipleHttp2Connections |
Hämtar eller anger ett värde som anger om ytterligare HTTP/2-anslutningar kan upprättas till samma server när det maximala antalet samtidiga strömmar nås på alla befintliga anslutningar. |
| MaxAutomaticRedirections |
Hämtar eller anger det maximala antalet tillåtna HTTP-omdirigeringar. |
| MaxConnectionsPerServer |
Hämtar eller anger det maximala antalet TCP-anslutningar som tillåts till en enskild server. |
| MaxResponseDrainSize |
Hämtar eller anger den maximala mängden data som kan tömmas från svar i byte. |
| MaxResponseHeadersLength |
Hämtar eller anger den maximala längden i kilobyte (1 024 byte) för svarsrubrikerna. |
| PreAuthenticate |
Hämtar eller anger ett värde som anger om hanteraren skickar ett auktoriseringshuvud med begäran. |
| Properties |
Hämtar en skrivbar ordlista (dvs. en karta) med anpassade egenskaper för begäranden HttpClient . Ordlistan initieras tom. du kan infoga och fråga nyckel/värde-par för dina anpassade hanterare och särskild bearbetning. |
| Proxy |
Hämtar eller anger den anpassade proxyn WindowsProxyUsePolicy när egenskapen är inställd på att använda en anpassad proxy. |
| ReceiveDataTimeout |
Hämtar eller anger tidsgränsen för att ta emot datadelen av ett svar från servern. |
| ReceiveHeadersTimeout |
Hämtar eller anger tidsgränsen för att ta emot rubrikerna för ett svar från servern. |
| SendTimeout |
Hämtar eller anger tidsgränsen för att skicka en begäran. |
| ServerCertificateValidationCallback |
Hämtar eller anger en återanropsmetod för att verifiera servercertifikatet. Det här återanropet är en del av SSL-handskakningen. |
| ServerCredentials |
Hämtar eller anger de autentiseringsuppgifter som ska användas av klienten för att autentisera till servern. |
| SslProtocols |
Hämtar eller anger samlingen med TLS/SSL-protokoll som stöds av klienten. |
| TcpKeepAliveEnabled |
Hämtar eller anger ett värde som anger om TCP keep-alive är aktiverat. |
| TcpKeepAliveInterval |
Hämtar eller anger TCP keep-alive-intervallet. |
| TcpKeepAliveTime |
Hämtar eller anger tidsgränsen för TCP keep-alive. |
| WindowsProxyUsePolicy |
Hämtar eller anger proxyinställningen. Den här egenskapen kan anges för att inaktivera proxyn, använda en anpassad proxy eller använda proxyinställningarna för WinHTTP eller WinInet på datorn. |
Metoder
| Name | Description |
|---|---|
| Dispose() |
Släpper ohanterade resurser och gör sig av med de hanterade resurser som används av HttpMessageHandler. (Ärvd från HttpMessageHandler) |
| Dispose(Boolean) |
Släpper de ohanterade resurser som används av WinHttpHandler, och om du vill kan du ta bort de hanterade resurserna. |
| Equals(Object) |
Avgör om det angivna objektet är lika med det aktuella objektet. (Ärvd från Object) |
| GetHashCode() |
Fungerar som standard-hash-funktion. (Ärvd från Object) |
| GetType() |
Hämtar den aktuella instansen Type . (Ärvd från Object) |
| MemberwiseClone() |
Skapar en ytlig kopia av den aktuella Object. (Ärvd från Object) |
| SendAsync(HttpRequestMessage, CancellationToken) |
Skickar en HTTP-begäran som en asynkron åtgärd. |
| ToString() |
Returnerar en sträng som representerar det aktuella objektet. (Ärvd från Object) |
