WinHttpHandler Klasa

Definicja

WinHttpHandler to specjalistyczny program obsługi komunikatów oparty na interfejsie WinHTTP systemu Windows i jest przeznaczony do użycia w środowiskach serwerów.WinHttpHandler is a specialty message handler based on the WinHTTP interface of Windows and is intended for use in server environments. Ta klasa jest również dostępna do użycia w aplikacjach klasycznych, instalując ją jako pakiet NuGet.This class is also available for use in Desktop apps by installing it as a NuGet package. Aby uzyskać więcej informacji na temat instalowania tej klasy do użycia w aplikacjach klasycznych, zobacz System .NET. http. WinHttpHandler.For more information about installing this class for use in Desktop apps, see System.Net.Http.WinHttpHandler.

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
WinHttpHandler

Uwagi

WinHttpHandler przypomina inne istniejące klasy, takie jak HttpClientHandler.WinHttpHandler is similar to other existing classes such as HttpClientHandler. WinHttpHandler udostępnia program obsługi poniżej wystąpienia HttpClient i służy do wysyłania żądań HTTP do serwera i odbierania odpowiedzi serwera.WinHttpHandler provides a handler underneath an HttpClient instance and is used to send HTTP requests out to a server and receive server responses.

WinHttpHandler jest zaprojektowana do użycia głównie w środowiskach serwerów przez ASP.NET Core i inne aplikacje platformy .NET, które komunikują się z serwerami HTTP.WinHttpHandler is designed to be used primarily in server environments by ASP.NET Core and other .NET applications that communicate with HTTP servers. WinHttpHandler oferuje również deweloperom bardziej szczegółową kontrolę nad komunikacją HTTP aplikacji niż Klasa HttpClientHandler.WinHttpHandler also provides developers with more granular control over the application's HTTP communication than the HttpClientHandler class. Dzięki temu deweloperzy mogą zaimplementować bardziej zaawansowane scenariusze HTTP lub zmodyfikować ustawienia domyślne systemu (na przykład ustawienia serwera proxy, limity czasu i sprawdzanie poprawności certyfikatu protokołu SSL serwera).This allows developers to implement more advanced HTTP scenarios or modify system defaults (for example, proxy settings, timeouts and server SSL certificate validation).

WinHttpHandler nie jest przeznaczona do zastąpienia HttpClientHandler, jest to bardziej zaawansowana wersja udostępniona dla scenariuszy, w których HttpClientHandler jest niewystarczająca dla deweloperów.WinHttpHandler is not intended to be a replacement for HttpClientHandler, it is a more advanced version provided for scenarios where HttpClientHandler is insufficient for developers. WinHttpHandler jest zaimplementowana jako otoka cienka w interfejsie WinHTTP systemu Windows i jest obsługiwana tylko w systemach Windows.WinHttpHandler is implemented as a thin wrapper on the WinHTTP interface of Windows and is only supported on Windows systems.

W przypadku używania łańcucha wielu programów obsługi WinHttpHandler powinien znajdować się w dolnej części łańcucha.When using a chain of multiple handlers, WinHttpHandler should be at the bottom of the chain.

Konstruktory

WinHttpHandler()

Inicjuje nowe wystąpienie klasy WinHttpHandler.Initializes a new instance of the WinHttpHandler class.

Właściwości

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.

AutomaticRedirection

Pobiera lub ustawia wartość wskazującą, czy program obsługi powinien śledzić odpowiedzi HTTP.Gets or sets a value that indicates whether the handler should follow HTTP redirection responses.

CheckCertificateRevocationList

Pobiera lub ustawia wartość wskazującą, czy należy sprawdzać listę odwołania certyfikatów podczas weryfikacji certyfikatu SSL.Gets or sets a value that indicates whether to check the revocation list of certificates during SSL certificate validation.

ClientCertificateOption

Pobiera lub ustawia wartość wskazującą, czy certyfikat jest automatycznie pobierany z magazynu certyfikatów lub czy obiekt wywołujący może zostać przekazany do określonego certyfikatu klienta.Gets or sets a value that indicates if the certificate is automatically picked from the certificate store or if the caller is allowed to pass in a specific client certificate.

ClientCertificates

Pobiera lub ustawia kolekcję certyfikatów SSL uwierzytelniania klienta, które są używane do uwierzytelniania klienta przez program obsługi, jeśli właściwość ClientCertificateOption jest ustawiona na ręczny.Gets or sets a collection of client authentication SSL certificates that are used for client authentication by the Handler if the ClientCertificateOption property is set to Manual.

CookieContainer

Pobiera lub ustawia obiekt kontenera zarządzanego pliku cookie.Gets or sets the managed cookie container object. Ta właściwość jest używana tylko wtedy, gdy właściwość CookieUsePolicy jest ustawiona na UseSpecifiedCookieContainer.This property is only used when the CookieUsePolicy property is set to UseSpecifiedCookieContainer. W przeciwnym razie metoda SendAsync(HttpRequestMessage, CancellationToken) zgłosi wyjątek.Otherwise, the SendAsync(HttpRequestMessage, CancellationToken) method will throw an exception.

CookieUsePolicy

Pobiera lub ustawia wartość wskazującą sposób zarządzania i używania plików cookie.Gets or sets a value that indicates how cookies should be managed and used. Deweloperzy mogą wybrać ignorowanie plików cookie, zezwolić programowi obsługi na automatyczne zarządzanie nimi lub ręczne obsłużenie ich przy użyciu obiektu CookieContainer.Developers can choose to ignore cookies, allow the handler to automatically manage them or manually handle them using a CookieContainer object.

DefaultProxyCredentials

Pobiera lub ustawia poświadczenia używane do uwierzytelniania użytkownika na uwierzytelnianym serwerze proxy.Gets or sets the credentials used to authenticate the user to an authenticating proxy.

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ę połączeń TCP dozwolonych dla jednego serwera.Gets or sets the maximum number of 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 maksymalny rozmiar części nagłówka z odpowiedzi serwera w bajtach.Gets or sets the maximum size of the header portion from the server response in bytes.

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, gdy właściwość WindowsProxyUsePolicy jest ustawiona na używanie niestandardowego serwera proxy.Gets or sets the custom proxy when the WindowsProxyUsePolicy property is set to use a custom proxy.

ReceiveDataTimeout

Pobiera lub ustawia limit czasu odbioru części danych odpowiedzi z serwera.Gets or sets the timeout for receiving the data portion of a response from the server.

ReceiveHeadersTimeout

Pobiera lub ustawia limit czasu odbioru nagłówków odpowiedzi z serwera.Gets or sets the timeout for receiving the headers of a response from the server.

SendTimeout

Pobiera lub ustawia limit czasu wysyłania żądania.Gets or sets the timeout for sending a request.

ServerCertificateValidationCallback

Pobiera lub ustawia metodę wywołania zwrotnego w celu zweryfikowania certyfikatu serwera.Gets or sets a callback method to validate the server certificate. To wywołanie zwrotne jest częścią uzgadniania protokołu SSL.This callback is part of the SSL handshake.

ServerCredentials

Pobiera lub ustawia poświadczenia, które będą używane przez klienta do uwierzytelniania na serwerze.Gets or sets the credentials to be used by the client to authenticate to the server.

SslProtocols

Pobiera lub ustawia kolekcję protokołów TLS/SSL, które są obsługiwane przez klienta.Gets or sets the collection of TLS/SSL protocols supported by the client.

WindowsProxyUsePolicy

Pobiera lub ustawia ustawienie serwera proxy.Gets or sets the proxy setting. 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 komputerze.This property can be set to disable the proxy, use a custom proxy, or use the proxy settings of WinHTTP or WinInet on the machine.

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)
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)

Wysyła żądanie HTTP jako operację asynchroniczną.Sends an HTTP request as an asynchronous operation.

ToString()

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

(Odziedziczone po Object)

Dotyczy