WinHttpHandler Klasa

Definicja

Przestrzeń nazw:

System.Net.Http

Zestaw:

System.Net.Http.WinHttpHandler.dll

Pakiet:

System.Net.Http.WinHttpHandler v8.0.0

Źródło:

WinHttpHandler.cs

Obsługuje komunikaty oparte na interfejsie WinHTTP systemu Windows. Ta klasa jest przeznaczona do użytku w środowiskach serwera.

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

Dziedziczenie

Object

HttpMessageHandler

WinHttpHandler

Uwagi

WinHttpHandler jest podobny do innych istniejących klas, takich jak HttpClientHandler. WinHttpHandler Program obsługi udostępnia program obsługi pod wystąpieniem HttpClient i służy do wysyłania żądań HTTP do serwera i odbierania odpowiedzi serwera. Implementacja WinHttpHandler obsługuje wersje HTTP do HTTP/2.

WinHttpHandlerjest przeznaczony do użycia głównie w środowiskach serwerów przez ASP.NET Core i inne aplikacje platformy .NET komunikujące się z serwerami HTTP. WinHttpHandler Zapewnia również deweloperom bardziej szczegółową kontrolę nad komunikacją HTTP aplikacji niż klasa HttpClientHandler . Dzięki temu deweloperzy mogą implementować bardziej zaawansowane scenariusze HTTP lub modyfikować wartości domyślne systemu (na przykład ustawienia serwera proxy, limity czasu i weryfikację certyfikatu SSL serwera).

WinHttpHandler nie jest przeznaczony do zastąpienia dla HttpClientHandler. Zamiast tego jest to bardziej zaawansowana wersja, która jest udostępniana w scenariuszach, w których HttpClientHandler jest niewystarczająca. WinHttpHandler jest implementowany jako cienka otoka w interfejsie WinHTTP systemu Windows i jest obsługiwana tylko w systemach Windows.

W przypadku korzystania z łańcucha wielu procedur obsługi WinHttpHandler powinien znajdować się w dolnej części łańcucha.

Ta klasa jest również dostępna do użycia w aplikacjach klasycznych, instalując ją jako pakiet NuGet. Aby uzyskać więcej informacji, zobacz Pakiet NuGet System.Net.Http.WinHttpHandler.

Począwszy od platformy .NET 5, WinHttpHandler nie jest już uwzględniany w zestawie System.Net.Http.dll w ramach środowiska uruchomieniowego platformy .NET. Aby uzyskać więcej informacji, zobacz WinHttpHandler usunięte ze środowiska uruchomieniowego platformy .NET.

Konstruktory

WinHttpHandler()

Inicjuje nowe wystąpienie klasy WinHttpHandler.

Właściwości

AutomaticDecompression	Pobiera lub ustawia typ metody dekompresji używanej przez program obsługi automatycznej dekompresji odpowiedzi zawartości HTTP.
AutomaticRedirection	Pobiera lub ustawia wartość wskazującą, czy program obsługi powinien postępować zgodnie z odpowiedziami przekierowania HTTP.
CheckCertificateRevocationList	Pobiera lub ustawia wartość wskazującą, czy należy sprawdzić listę odwołania certyfikatów podczas walidacji certyfikatów SSL.
ClientCertificateOption	Pobiera lub ustawia wartość wskazującą, czy certyfikat jest automatycznie wybierany z magazynu certyfikatów, czy obiekt wywołujący może przekazać określony certyfikat klienta.
ClientCertificates	Pobiera kolekcję certyfikatów SSL uwierzytelniania klienta, które są używane do uwierzytelniania klienta przez program obsługi, jeśli ClientCertificateOption właściwość jest ustawiona na Manual.
CookieContainer	Pobiera lub ustawia zarządzany obiekt kontenera plików cookie. Ta właściwość jest używana tylko wtedy, gdy CookieUsePolicy właściwość jest ustawiona na UseSpecifiedCookieContainer. SendAsync(HttpRequestMessage, CancellationToken) W przeciwnym razie metoda zgłosi wyjątek.
CookieUsePolicy	Pobiera lub ustawia wartość wskazującą sposób zarządzania plikami cookie i ich użycia. Deweloperzy mogą ignorować pliki cookie, zezwalać programowi obsługi na automatyczne zarządzanie nimi lub ręcznie obsługiwać je przy użyciu CookieContainer obiektu.
DefaultProxyCredentials	Pobiera lub ustawia poświadczenia używane do uwierzytelniania użytkownika na serwerze proxy uwierzytelniania.
EnableMultipleHttp2Connections	Pobiera lub ustawia wartość wskazującą, czy można ustanowić dodatkowe połączenia HTTP/2 z tym samym serwerem, gdy maksymalna liczba współbieżnych strumieni zostanie osiągnięta dla wszystkich istniejących połączeń.
MaxAutomaticRedirections	Pobiera lub ustawia maksymalną liczbę dozwolonych przekierowań HTTP.
MaxConnectionsPerServer	Pobiera lub ustawia maksymalną liczbę połączeń TCP dozwolonych dla jednego serwera.
MaxResponseDrainSize	Pobiera lub ustawia maksymalną ilość danych, które mogą być opróżniane z odpowiedzi w bajtach.
MaxResponseHeadersLength	Pobiera lub ustawia maksymalny rozmiar części nagłówka z odpowiedzi serwera w bajtach.
PreAuthenticate	Pobiera lub ustawia wartość wskazującą, czy program obsługi wysyła nagłówek autoryzacji z żądaniem.
Properties	Pobiera zapisywalny słownik (czyli mapę) właściwości niestandardowych dla żądań HttpClient . Słownik jest inicjowany jako pusty; Można wstawić pary klucz-wartość i wykonywać zapytania dla niestandardowych procedur obsługi i specjalnego przetwarzania.
Proxy	Pobiera lub ustawia niestandardowy serwer proxy, gdy WindowsProxyUsePolicy właściwość jest ustawiona na użycie niestandardowego serwera proxy.
ReceiveDataTimeout	Pobiera lub ustawia limit czasu odbierania części danych odpowiedzi z serwera.
ReceiveHeadersTimeout	Pobiera lub ustawia limit czasu odbierania nagłówków odpowiedzi z serwera.
SendTimeout	Pobiera lub ustawia limit czasu wysyłania żądania.
ServerCertificateValidationCallback	Pobiera lub ustawia metodę wywołania zwrotnego w celu zweryfikowania certyfikatu serwera. To wywołanie zwrotne jest częścią uzgadniania SSL.
ServerCredentials	Pobiera lub ustawia poświadczenia, które mają być używane przez klienta do uwierzytelniania na serwerze.
SslProtocols	Pobiera lub ustawia kolekcję protokołów TLS/SSL obsługiwanych przez klienta.
TcpKeepAliveEnabled	Pobiera lub ustawia wartość wskazującą, czy włączono utrzymywania aktywności protokołu TCP.
TcpKeepAliveInterval	Pobiera lub ustawia interwał utrzymania aktywności protokołu TCP.
TcpKeepAliveTime	Pobiera lub ustawia limit czasu utrzymania aktywności protokołu TCP.
WindowsProxyUsePolicy	Pobiera lub ustawia ustawienie serwera proxy. Tę właściwość można ustawić, aby wyłączyć serwer proxy, użyć niestandardowego serwera proxy lub użyć ustawień serwera proxy WinHTTP lub WinInet na maszynie.

Metody

Dispose()	Zwalnia niezarządzane zasoby i usuwa zarządzane zasoby używane przez program HttpMessageHandler. (Odziedziczone po HttpMessageHandler)
Dispose(Boolean)	Zwalnia niezarządzane zasoby używane przez WinHttpHandlerprogram i opcjonalnie usuwa zasoby zarządzane.
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
Send(HttpRequestMessage, CancellationToken)	Po zastąpieniu w klasie pochodnej wysyła żądanie HTTP z określonym żądaniem i tokenem anulowania. W przeciwnym razie zwraca wartość NotSupportedException. (Odziedziczone po HttpMessageHandler)
SendAsync(HttpRequestMessage, CancellationToken)	Wysyła żądanie HTTP jako operację asynchroniczną.
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)