WinHttpHandler WinHttpHandler WinHttpHandler WinHttpHandler Class

Definition

WinHttpHandler ist ein spezieller Meldungshandler, der auf der WinHTTP-Schnittstelle von Windows basiert und für die Verwendung in Serverumgebungen vorgesehen ist.WinHttpHandler is a specialty message handler based on the WinHTTP interface of Windows and is intended for use in server environments. Diese Klasse ist auch für die Verwendung in Desktop-Apps verfügbar, indem Sie diese als NuGet-Paket installieren.This class is also available for use in Desktop apps by installing it as a NuGet package. Weitere Informationen zum Installieren dieser Klasse für die Verwendung in Desktop-Apps finden Sie unter 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
Vererbung

Hinweise

WinHttpHandler entspricht anderen vorhandenen Klassen wie z. B. HttpClientHandler.WinHttpHandler is similar to other existing classes such as HttpClientHandler. WinHttpHandler Stellt einen Handler unterhalb einer HttpClient -Instanz und wird verwendet, um HTTP-Anforderungen an einen Server gesendet oder Empfangen von Serverantworten.WinHttpHandler provides a handler underneath an HttpClient instance and is used to send HTTP requests out to a server and receive server responses.

WinHttpHandler soll in erster Linie in Server-Umgebungen verwendet werden, von ASP.NET Core und andere .NET-Anwendungen, die mit HTTP-Servern kommunizieren.WinHttpHandler is designed to be used primarily in server environments by ASP.NET Core and other .NET applications that communicate with HTTP servers. WinHttpHandler bietet Entwicklern auch mehr Kontrolle über die Anwendung HTTP-Kommunikation als die HttpClientHandler Klasse.WinHttpHandler also provides developers with more granular control over the application's HTTP communication than the HttpClientHandler class. Dadurch können Entwickler erweiterte HTTP-Szenarien zu implementieren, oder ändern die Systemstandardwerte (z. B. Proxyeinstellungen, Timeouts und -Server SSL-zertifikatüberprüfung).This allows developers to implement more advanced HTTP scenarios or modify system defaults (for example, proxy settings, timeouts and server SSL certificate validation).

WinHttpHandler sollte kein Ersatz für HttpClientHandler, es ist eine erweiterte Version gelten für Szenarien, in denen HttpClientHandler ist nicht ausreichend für Entwickler.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 wird als ein einfacher Wrapper für die WinHTTP-Schnittstelle von Windows implementiert und wird nur auf Windows-Systemen unterstützt.WinHttpHandler is implemented as a thin wrapper on the WinHTTP interface of Windows and is only supported on Windows systems.

Wenn Sie eine Kette von mehreren Handlern verwenden WinHttpHandler muss am Ende der Kette.When using a chain of multiple handlers, WinHttpHandler should be at the bottom of the chain.

Konstruktoren

WinHttpHandler() WinHttpHandler() WinHttpHandler() WinHttpHandler()

Initialisiert eine neue Instanz der WinHttpHandler-Klasse.Initializes a new instance of the WinHttpHandler class.

Eigenschaften

AutomaticDecompression AutomaticDecompression AutomaticDecompression AutomaticDecompression

Ruft den Typ der Dekomprimierungsmethode ab, die vom Handler für die automatische Dekomprimierung von Antworten mit HTTP-Inhalt verwendet wird, oder legt den Typ fest.Gets or sets the type of decompression method used by the handler for automatic decompression of the HTTP content response.

AutomaticRedirection AutomaticRedirection AutomaticRedirection AutomaticRedirection

Ruft einen Wert ab, der angibt, ob der Handler HTTP-Umleitungsantworten folgen soll, oder legt diesen fest.Gets or sets a value that indicates whether the handler should follow HTTP redirection responses.

CheckCertificateRevocationList CheckCertificateRevocationList CheckCertificateRevocationList CheckCertificateRevocationList

Ruft einen Wert ab, der angibt, ob die Sperrliste für Zertifikate während der SSL-Zertifikatüberprüfung überprüft werden soll, oder legt diesen fest.Gets or sets a value that indicates whether to check the revocation list of certificates during SSL certificate validation.

ClientCertificateOption ClientCertificateOption ClientCertificateOption ClientCertificateOption

Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob das Zertifikat automatisch aus dem Zertifikatspeicher ausgewählt wird oder ob der Aufrufer ein bestimmtes Clientzertifikat übergeben darf.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 ClientCertificates ClientCertificates ClientCertificates

Ruft eine Auflistung von SSL-Zertifikaten für die Clientauthentifizierung ab, die vom Handler verwendet wird, wenn die ClientCertificateOption-Eigenschaft auf „Manuell“ festgelegt ist, oder legt diese fest.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 CookieContainer CookieContainer CookieContainer

Ruft das Containerobjekt für verwaltete Cookies ab oder legt dieses fest.Gets or sets the managed cookie container object. Diese Eigenschaft wird nur verwendet, wenn die CookieUsePolicy-Eigenschaft auf „UseSpecifiedCookieContainer“ festgelegt ist.This property is only used when the CookieUsePolicy property is set to UseSpecifiedCookieContainer. Andernfalls löst die SendAsync(HttpRequestMessage, CancellationToken)-Methode eine Ausnahme aus.Otherwise, the SendAsync(HttpRequestMessage, CancellationToken) method will throw an exception.

CookieUsePolicy CookieUsePolicy CookieUsePolicy CookieUsePolicy

Ruft einen Wert ab, der angibt, wie Cookies verwaltet und verwendet werden sollen, oder legt diesen fest.Gets or sets a value that indicates how cookies should be managed and used. Entwickler können Cookies manuell mithilfe eines CookieContainer-Objekts verwalten oder ignorieren und dem Handler genehmigen, diese automatisch zu verwalten.Developers can choose to ignore cookies, allow the handler to automatically manage them or manually handle them using a CookieContainer object.

DefaultProxyCredentials DefaultProxyCredentials DefaultProxyCredentials DefaultProxyCredentials

Ruft die Anmeldeinformationen zum Authentifizieren des Benutzers bei einem Authentifizierungsproxy ab oder legt diese fest.Gets or sets the credentials used to authenticate the user to an authenticating proxy.

MaxAutomaticRedirections MaxAutomaticRedirections MaxAutomaticRedirections MaxAutomaticRedirections

Ruft die maximale Anzahl von zulässigen HTTP-Umleitungen ab oder legt diese fest.Gets or sets the maximum number of allowed HTTP redirects.

MaxConnectionsPerServer MaxConnectionsPerServer MaxConnectionsPerServer MaxConnectionsPerServer

Ruft die maximale Anzahl von TCP-Verbindungen ab, die für einen einzelnen Server zulässig sind, oder legt diese fest.Gets or sets the maximum number of TCP connections allowed to a single server.

MaxResponseDrainSize MaxResponseDrainSize MaxResponseDrainSize MaxResponseDrainSize

Ruft die maximale Datenmenge aus Antworten in Byte ab oder legt diese fest.Gets or sets the maximum amount of data that can be drained from responses in bytes.

MaxResponseHeadersLength MaxResponseHeadersLength MaxResponseHeadersLength MaxResponseHeadersLength

Ruft die maximale Größe des Headerteils in Byte aus der Serverantwort ab oder legt diese fest.Gets or sets the maximum size of the header portion from the server response in bytes.

PreAuthenticate PreAuthenticate PreAuthenticate PreAuthenticate

Ruft einen Wert ab, der angibt, ob vom Handler mit der Anforderung ein Autorisierungsheader gesendet wird, oder legt diesen fest.Gets or sets a value that indicates whether the handler sends an Authorization header with the request.

Properties Properties Properties Properties
Proxy Proxy Proxy Proxy

Ruft den benutzerdefinierten Proxy ab, wenn die WindowsProxyUsePolicy-Eigenschaft darauf festgelegt ist, einen benutzerdefinierten Proxy zu verwenden, oder legt diesen fest.Gets or sets the custom proxy when the WindowsProxyUsePolicy property is set to use a custom proxy.

ReceiveDataTimeout ReceiveDataTimeout ReceiveDataTimeout ReceiveDataTimeout

Ruft das Timeout für das Erhalten des Datenteils einer Antwort vom Server ab oder legt dieses fest.Gets or sets the timeout for receiving the data portion of a response from the server.

ReceiveHeadersTimeout ReceiveHeadersTimeout ReceiveHeadersTimeout ReceiveHeadersTimeout

Ruft das Timeout für das Erhalten des Headers einer Antwort vom Server ab oder legt dieses fest.Gets or sets the timeout for receiving the headers of a response from the server.

SendTimeout SendTimeout SendTimeout SendTimeout

Ruft das Timeout für das Senden einer Anforderung ab oder legt dieses fest.Gets or sets the timeout for sending a request.

ServerCertificateValidationCallback ServerCertificateValidationCallback ServerCertificateValidationCallback ServerCertificateValidationCallback

Ruft eine Rückrufmethode zur Überprüfung des Serverzertifikats ab oder legt diese fest.Gets or sets a callback method to validate the server certificate. Dieser Rückruf ist Teil des SSL-Handshakes.This callback is part of the SSL handshake.

ServerCredentials ServerCredentials ServerCredentials ServerCredentials

Ruft die Anmeldeinformationen ab, die vom Client zur Authentifizierung beim Server verwendet werden, oder legt diese fest.Gets or sets the credentials to be used by the client to authenticate to the server.

SslProtocols SslProtocols SslProtocols SslProtocols

Ruft die Auflistung von TLS-/SSL-Protokollen ab, die vom Client unterstützt werden, oder legt diese fest.Gets or sets the collection of TLS/SSL protocols supported by the client.

WindowsProxyUsePolicy WindowsProxyUsePolicy WindowsProxyUsePolicy WindowsProxyUsePolicy

Ruft die Proxyeinstellung ab oder legt diese fest.Gets or sets the proxy setting. Diese Eigenschaft kann darauf festgelegt werden, den Proxy zu deaktivieren, einen benutzerdefinierten Proxy zu verwenden oder die Proxyeinstellungen von WinHTTP oder WinInet auf dem Computer zu verwenden.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.

Methoden

Dispose() Dispose() Dispose() Dispose()

Gibt die vom HttpMessageHandler verwendeten, nicht verwalteten Ressourcen frei und verwirft die verwalteten Ressourcen.Releases the unmanaged resources and disposes of the managed resources used by the HttpMessageHandler.

(Inherited from HttpMessageHandler)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
SendAsync(HttpRequestMessage, CancellationToken) SendAsync(HttpRequestMessage, CancellationToken) SendAsync(HttpRequestMessage, CancellationToken) SendAsync(HttpRequestMessage, CancellationToken)

Sendet eine HTTP-Anforderung als asynchronen Vorgang.Sends an HTTP request as an asynchronous operation.

ToString() ToString() ToString() ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Inherited from Object)

Gilt für: